Table of Contents

Gestione dati di sparse spatial map

Questo capitolo presenta come gestire i dati sparse spatial map di Spatial Map.

Dati

Il processo di gestione dei dati mappa è il seguente:

  • Generazione e upload: le mappe vengono generate automaticamente da EasyAR Sense sul dispositivo e caricate nel cloud in un formato dedicato.
  • Gestione cloud: tramite management APIs, gli sviluppatori possono integrare funzioni di gestione come aggiunta, eliminazione, aggiornamento e query delle mappe.
  • Condivisione e distribuzione: la condivisione delle mappe è supportata. Le mappe caricate da qualsiasi dispositivo possono essere usate da altri dispositivi per localization, consentendo collaborazione multi-dispositivo.

Flusso dati

  • EasyAR Sense crea e carica le mappe sul server. Durante l'uso, i dati mappa vengono scaricati e usati. Prima dell'uso viene controllata la validità della cache.
  • Il lato utente invia istruzioni operative al server di gestione dati tramite API.
flowchart TB

B[API o EasyAR Web] --> A[Server di gestione dati]

A[Server di gestione dati] <-->  D[EasyAR Sense lato dispositivo] <--> C>Cache dati lato dispositivo]

Data center

Considerando i data center di distribuzione di rete, gli utenti dovrebbero scegliere prima dell'acquisto la regione corrispondente alla rete del server. Attualmente sono supportate:

  • Regione China
  • Regione North America

Metodo 1: gestire spatial maps in EasyAR Developer Center

Adatto a scenari business su piccola scala. I passaggi sono i seguenti:

  1. Accedere a EasyAR Developer Center ed entrare in SpatialMap.
  2. Selezionare regione China o regione North America. Se non è stata ancora creata una SpatialMap library, crearne prima una nuova.
    • Poiché EasyAR SpatialMap è associato a EasyAR Sense, l'operazione di creazione della SpatialMap library viene eseguita nella pagina Sense License Key.
    • Sense authorization -> SpatialMap

create-web

  1. Fare clic su Manage nell'elenco image library per entrare nell'elenco SpatialMap. Fare clic su Manage su una qualsiasi spatial map, come mostrato nella figura, per eseguire le seguenti operazioni di gestione su una singola spatial map:

    • Operazione di eliminazione
    • Operazione di aggiornamento (mark 1): disabilitare/abilitare mappa
    • Operazione di aggiornamento (mark 2): modificare nome
    • Operazione di aggiornamento (mark 3): modificare etichetta: Label
    • Operazione di aggiornamento (mark 4): modificare posizione: GNSS/GPS
    • Operazione di aggiornamento (mark 5): modificare Meta: associare risorse url e proprietà personalizzate

mgnt-web

Metodo 2: usare REST API per la gestione automatizzata

Per scenari che devono gestire molte mappe, si consiglia di usare Web Service REST API per implementare workflow automatizzati nell'applicazione o nel management backend.

Checklist risorse di preparazione

  • SpatialMap AppId
  • Credenziale di autenticazione: API Key / API Secret oppure Token
  • Cloud URL: gli indirizzi di richiesta del servizio Spatial Map sono divisi per data center, China (predefinito) e Stati Uniti:
    • Regione China: https://armap-api.easyar.com
    • Regione North America: https://armap-api-na1.easyar.com

Ottenere le risorse della checklist

  • Ottenere SpatialMap AppId:
    Developer Center -> SpatialMap -> Select image library -> Manage -> Key (Authentication)

    m1-appid

  • Ottenere API Key / API Secret:
    Developer Center -> Cloud Service APIKey -> Copy

    m1-apikey

    Se non si dispone ancora di API Key, creare una API Key e assicurarsi che il permesso SpatialMap sia selezionato. Per ulteriori informazioni su API Key e controllo dei permessi, consultare Introduzione a API Key.

m1-apikey

  • Ottenere Token:
    Developer Center -> Cloud Service APIKey -> Manage -> Select validity period -> Generate Token -> Copy

m1-token

    Se è necessario personalizzare il periodo di validità del Token, è possibile consultare UAC API - Creare Token e usare APIKey e APISecret originali per creare un Token.

Guida all'integrazione multi-end

Nei workflow reali, la gestione delle spatial maps è di solito integrata nel server business dello sviluppatore, nel mobile end o in Unity:

  • Piattaforma di servizi business: fornisce codice di esempio API in linguaggi comuni di sviluppo server (Curl/Java/NodeJS/PHP) per aiutare gli sviluppatori a implementare la gestione delle spatial maps.

  • Mobile end (Unity/Mobile): gli sviluppatori possono usare Unity per sviluppare e creare spatial maps, quindi gestire spatial maps basate su Unity.

Argomenti correlati:

Argomento successivo: