Table of Contents

Gestion des données de carte spatiale éparse

Ce chapitre présente comment gérer les données de carte spatiale éparse Spatial Map.

Données

Le processus de gestion des données cartographiques est le suivant :

  • Génération et téléchargement : La carte est générée automatiquement côté appareil par EasyAR Sense et téléchargée vers le cloud dans un format dédié.
  • Gestion cloud : Grâce aux API de gestion, les développeurs peuvent intégrer des fonctionnalités de gestion telles que l'ajout, la suppression, la modification et la consultation des cartes.
  • Partage et distribution : Le partage de cartes est pris en charge. Toute carte téléchargée par un appareil peut être utilisée par d'autres appareils pour le positionnement, permettant une collaboration multi-appareils.

Flux de données

  • EasyAR Sense crée et télécharge vers le serveur. Les données cartographiques sont téléchargées et utilisées lors de l'utilisation. Vérifiez la validité du cache avant utilisation.
  • Côté utilisateur, les instructions d'opération sont envoyées au serveur de gestion de données via l'API
flowchart TB

B[API ou EasyAR Web] --> A[Serveur de gestion de données]

A[Serveur de gestion de données] <-->  D[Appareil EasyAR Sense] <--> C>Cache de données côté appareil]

Centres de données

Tenez compte du centre de données de distribution réseau. Veuillez choisir la région correspondant au réseau du serveur avant l'achat. Actuellement pris en charge :

  • Région Chine
  • Région Amérique du Nord

Méthode 1: Gérer la carte spatiale dans le centre de développement EasyAR

Convient pour les opérations à petite échelle. Étapes :

  1. Connectez-vous au centre de développement EasyAR, accédez à SpatialMap.
  2. Sélectionnez la région Chine ou Amérique du Nord. Si aucun bibliothèque SpatialMap n'a été créée, créez-en d'abord une nouvelle.
    • Puisque EasyAR SpatialMap est lié à EasyAR Sense, l'opération de création de la bibliothèque SpatialMap se fait dans la page Sense License Key
    • Autorisation Sense -> SpatialMap

create-web

  1. Dans la liste des galeries, cliquez sur Gérer pour accéder à la liste SpatialMap. Cliquez sur Gérer pour n'importe quelle carte spatiale, comme illustré, et effectuez les opérations de gestion suivantes sur une carte spatiale individuelle

    • Opération de suppression
    • Opération de mise à jour (marque 1) : Désactiver/Activer la carte
    • Opération de mise à jour (marque 2) : Modifier le nom
    • Opération de mise à jour (marque 3) : Modifier l'étiquette : Label
    • Opération de mise à jour (marque 4) : Modifier l'emplacement : GNSS/GPS
    • Opération de mise à jour (marque 5) : Modifier Meta : Associer des ressources url, propriétés personnalisées

mgnt-web

Méthode 2: Utiliser l'API REST pour une gestion automatisée

Pour les scénarios nécessitant la gestion d'un grand nombre de cartes, il est recommandé d'utiliser l'API Web Service REST afin d'automatiser les processus dans votre application ou interface d'administration.

Préparer la liste des ressources

  • SpatialMap AppId
  • Identifiants d'authentification: Clé API / Secret API ou Token
  • URL Cloud : Les adresses de requête du service Spatial Map varient selon le centre de données, Chine (par défaut) et États-Unis :
    • Région Chine : https://armap-api.easyar.com
    • Région Amérique du Nord : https://armap-api-na1.easyar.com

Obtenir les ressources de la liste

  • Obtenir SpatialMap AppId :
    Centre de développement -> SpatialMap -> Sélectionner une galerie -> Gérer -> Clé d'authentification (Authentication)

    m1-appid

  • Obtenir Clé API / Secret API :
    Centre de développement -> Clé API des services cloud -> Copier

    m1-apikey

    Si vous n'avez pas encore de clé API, créez-en une. Vous devez cocher la permission SpatialMap. Pour en savoir plus sur la clé API et le contrôle des permissions, consultez le sujet Introduction à la clé API

m1-apikey

  • Obtenir Token :
    Centre de développement -> Clé API des services cloud -> Gérer -> Sélectionner la durée de validité -> Générer Token -> Copier

m1-token

    Si vous devez personnaliser la durée de validité du Token, vous pouvez vous référer à la méthode API UAC —— Créer un Token, en utilisant la clé API et le secret API d'origine pour créer le Token

Guide d'intégration multi-plateformes

Dans les flux de travail réels, la gestion des cartes spatiales est généralement intégrée dans le serveur métier du développeur, ou dans un terminal mobile ou Unity :

  • Plateforme de service métier : Fournit des exemples de code d'appel d'API dans les langages de développement serveur courants (Curl/Java/NodeJS/PHP), aidant les développeurs à mettre en œuvre la gestion des cartes spatiales.

  • Terminal mobile (Unity/Mobile) : Les développeurs peuvent utiliser Unity pour créer des cartes spatiales, puis les gérer via Unity.

Sujets connexes :

Prochain sujet :