Table of Contents

Verwaltung von Sparse Spatial Map-Daten

Dieses Kapitel beschreibt die Verwaltung von Sparse Spatial Map-Daten.

Daten

Der Verwaltungsprozess für Kartendaten ist wie folgt:

  • Generierung und Hochladen: Karten werden automatisch von EasyAR Sense auf dem Gerät generiert und in einem proprietären Format in die Cloud hochgeladen.
  • Cloud-Verwaltung: Über Verwaltungs-APIs können Entwickler Funktionen wie Hinzufügen, Löschen, Ändern und Abfragen von Karten integrieren.
  • Freigabe und Verteilung: Unterstützt die Freigabe von Karten. Jede von einem Gerät hochgeladene Karte kann von anderen Geräten zur Lokalisierung verwendet werden, um eine Multi-Device-Zusammenarbeit zu ermöglichen.

Datenfluss

  • EasyAR Sense erstellt und lädt auf den Server hoch. Bei Verwendung werden Kartendaten heruntergeladen und genutzt. Vor der Verwendung wird die Cache-Gültigkeit überprüft.
  • Benutzer senden Betriebsanweisungen über APIs an den Datenverwaltungsserver
flowchart TB

B[API oder EasyAR Web] --> A[Datenverwaltungsserver]

A[Datenverwaltungsserver] <-->  D[Geräteseitig EasyAR Sense] <--> C>Geräteseitiger Daten-Cache]

Rechenzentren

Unter Berücksichtigung von Netzwerkverteilungs-Rechenzentren wählen Benutzer vor dem Kauf die Region des entsprechenden Server-Netzwerks. Derzeit unterstützt:

  • China-Region
  • Nordamerika-Region

Methode 1: Verwaltung von Spatial Maps im EasyAR Entwicklerzentrum

Geeignet für kleine Geschäftsumgebungen. Vorgehensweise:

  1. Melden Sie sich im EasyAR Entwicklerzentrum an und navigieren Sie zu SpatialMap.
  2. Wählen Sie China- oder Nordamerika-Region. Falls noch keine SpatialMap-Bibliothek erstellt wurde, erstellen Sie zuerst eine SpatialMap-Bibliothek.
    • Da EasyAR SpatialMap an EasyAR Sense gebunden ist, erfolgt die Erstellung auf der Sense License Key-Seite
    • Sense-Lizenz -> SpatialMap

create-web

  1. Klicken Sie in der Galerieliste auf Verwalten, um zur SpatialMap-Liste zu gelangen. Klicken Sie bei einer beliebigen Spatial Map auf Verwalten, wie dargestellt, und führen Sie folgende Verwaltungsoperationen für eine einzelne Spatial Map durch:
    • Löschoperation
    • Aktualisierungsoperation (Markierung 1): Deaktivieren/Aktivieren der Karte
    • Aktualisierungsoperation (Markierung 2): Namen ändern
    • Aktualisierungsoperation (Markierung 3): Label ändern
    • Aktualisierungsoperation (Markierung 4): Standort ändern: GNSS/GPS
    • Aktualisierungsoperation (Markierung 5): Meta ändern: Verknüpfte URL-Ressourcen, benutzerdefinierte Attribute

mgnt-web

Methode 2: Automatisierte Verwaltung mit REST-API

Für Szenarien mit umfangreicher Kartenverwaltung wird die Verwendung der Web Service REST-API empfohlen, um automatisierte Abläufe in Ihrer Anwendung oder Verwaltungsoberfläche zu implementieren.

Bereiten sie die ressourcenliste vor

  • SpatialMap AppId
  • Authentifizierungsnachweise: API-Schlüssel / API-Secret oder Token
  • Cloud-URL: Die Anfrageadressen für den Spatial Map-Dienst sind nach Rechenzentren getrennt. China (Standard) und USA sind:
    • China-Region: https://armap-api.easyar.com
    • Nordamerika-Region: https://armap-api-na1.easyar.com

Ressourcenliste abrufen

  • SpatialMap AppId abrufen:
    Entwicklerzentrum -> SpatialMap -> Bibliothek auswählen -> Verwalten -> Authentifizierung (Authentication)

    m1-appid

  • API Key / API Secret abrufen:
    Entwicklerzentrum -> Cloud Service APIKey -> Kopieren

    m1-apikey

    Falls Sie noch keinen API-Key haben, erstellen Sie einen API-Key und aktivieren Sie dabei unbedingt SpatialMap-Berechtigungen. Weitere Informationen zu API-Keys und Berechtigungskontrolle finden Sie im Thema API Key Einführung

m1-apikey

  • Token abrufen:
    Entwicklerzentrum -> Cloud Service APIKey -> Verwalten -> Gültigkeitsdauer auswählen -> Token generieren -> Kopieren

    m1-token

    Wenn Sie eine benutzerdefinierte Gültigkeitsdauer für das Token benötigen, können Sie die Methode UAC API – Token erstellen verwenden, um mit dem ursprünglichen APIKey und APISecret ein Token zu erstellen

Integration in mehrere Enden

In realen Workflows wird die Spatial Map-Verwaltung typischerweise in den Geschäftsservern des Entwicklers, auf Mobilgeräten oder in Unity integriert:

  • Geschäftsdienstplattform: Bietet Beispielcode für gängige Serversprachen (Curl/Java/NodeJS/PHP) zum Aufrufen von APIs und hilft Entwicklern bei der Implementierung der Spatial Map-Verwaltung.

  • Mobile Enden (Unity/Mobile): Entwickler können mit Unity Spatial Maps erstellen und dann basierend auf Unity verwalten.

Verwandte Themen:

Nächstes Thema: