Gestione dati sparse spatial map
Questo capitolo spiega come gestire i dati sparse spatial map.
Dati
Il flusso di gestione dei dati della mappa è il seguente:
- Generazione e upload: Le mappe vengono generate automaticamente da EasyAR Sense sul dispositivo e caricate sul cloud in un formato proprietario.
- Gestione cloud: Tramite le API di gestione, gli sviluppatori possono integrare funzionalità come aggiunta, eliminazione, modifica e ricerca delle mappe.
- Condivisione e distribuzione: Supporta la condivisione delle mappe. Le mappe caricate da qualsiasi dispositivo possono essere utilizzate da altri dispositivi per il posizionamento, abilitando la collaborazione multi-dispositivo.
Flusso dati
- EasyAR Sense crea e carica sul server. Durante l'uso, i dati della mappa vengono scaricati e utilizzati. Verificare la validità della cache prima dell'uso.
- Lato utente, le istruzioni operative vengono inviate 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[Dispositivo EasyAR Sense] <--> C>Cache dati sul dispositivo]
Data center
Considerare i data center di distribuzione di rete. Si prega di selezionare la regione corrispondente alla rete del server prima dell'acquisto. Attualmente supportate:
- Cina
- Nord America
Metodo 1: gestire le sparse spatial map nel centro di sviluppo EasyAR
Adatto per casi d'uso aziendali su piccola scala. Procedura operativa:
- Accedi al centro di sviluppo EasyAR, vai su SpatialMap.
- Seleziona Cina o Nord America. Se non è stato ancora creato un archivio SpatialMap, creane uno nuovo.
- Poiché EasyAR SpatialMap è vincolato a EasyAR Sense, l'operazione viene eseguita nella pagina Sense License Key per creare l'archivio SpatialMap
- Autorizzazione Sense -> SpatialMap

Nell'elenco degli archivi, fai clic su Gestisci per accedere all'elenco SpatialMap. Su qualsiasi sparse spatial map, fai clic su Gestisci, come mostrato, ed esegui le seguenti operazioni di gestione su una singola sparse spatial map
- Operazione di eliminazione
- Operazione di aggiornamento (marcatore 1): disattivare/attivare la mappa
- Operazione di aggiornamento (marcatore 2): modificare il nome
- Operazione di aggiornamento (marcatore 3): modificare l'etichetta: Label
- Operazione di aggiornamento (marcatore 4): modificare la posizione: GNSS/GPS
- Operazione di aggiornamento (marcatore 5): modificare Meta: associare risorse url, attributi personalizzati

Metodo 2: utilizzo delle REST API per la gestione automatizzata
Per scenari che richiedono la gestione di un gran numero di mappe, si consiglia di utilizzare le Web Service REST API per implementare flussi automatizzati nella propria applicazione o backend di gestione.
Preparare l'elenco delle risorse
- SpatialMap AppId
- Credenziali di autenticazione: API Key / API Secret o Token
- Cloud URL: Gli indirizzi di richiesta del servizio Spatial Map sono divisi per data center, Cina (predefinito) e Nord America:
- Cina:
https://armap-api.easyar.com - Nord America:
https://armap-api-na1.easyar.com
- Cina:
Ottenere le risorse dell'elenco
Ottenere SpatialMap AppId:
Centro di sviluppo -> SpatialMap -> Seleziona archivio -> Gestisci -> Chiavi (Authentication)
Ottenere API Key / API Secret:
Centro di sviluppo -> APIKey servizi cloud -> Copia
Se non hai ancora un API Key, creane uno, assicurandoti di selezionare i permessi SpatialMap. Per ulteriori informazioni su API Key e controllo degli accessi, consulta l'argomento Introduzione ad API Key

- Ottenere Token:
Centro di sviluppo -> APIKey servizi cloud -> Gestisci -> Seleziona durata -> Genera Token -> Copia

Se hai bisogno di personalizzare la durata del Token, puoi fare riferimento al metodo UAC API - Creare Token, utilizzando APIKey e APISecret originali per creare il Token
Linee guida per l'integrazione multi-piattaforma
In un flusso di lavoro effettivo, la gestione delle sparse spatial map è spesso integrata nel server aziendale dello sviluppatore, o in Unity o su dispositivi mobile:
Piattaforma di servizi aziendali: Fornisce esempi di codice per linguaggi di sviluppo server comuni (Curl/Java/NodeJS/PHP) per implementare la gestione delle sparse spatial map.
Piattaforme mobile (Unity/Mobile): Gli sviluppatori possono creare sparse spatial map utilizzando Unity e gestirle basandosi su Unity.