Gestión de datos de sparse spatial map
Este capítulo presenta cómo gestionar datos de sparse spatial map de Spatial Map.
Datos
El proceso de gestión de datos de mapa es el siguiente:
- Generación y carga: EasyAR Sense genera automáticamente los mapas en el lado del dispositivo y los sube a la cloud en un formato dedicado.
- Gestión en cloud: mediante management APIs, los desarrolladores pueden integrar funciones de gestión como añadir, eliminar, actualizar y consultar mapas.
- Uso compartido y distribución: se admite el uso compartido de mapas. Los mapas subidos por cualquier dispositivo pueden ser usados por otros dispositivos para localization, permitiendo colaboración multidispositivo.
Flujo de datos
- EasyAR Sense crea y sube mapas al servidor. Durante el uso, los datos de mapa se descargan y se usan. Antes del uso, se comprueba primero la validez de cache.
- El lado del usuario envía instrucciones de operación al servidor de gestión de datos mediante API.
flowchart TB
B[API o EasyAR Web] --> A[Servidor de gestión de datos]
A[Servidor de gestión de datos] <--> D[EasyAR Sense lado dispositivo] <--> C>Cache de datos lado dispositivo]
Data center
Considerando los data centers de distribución de red, los usuarios deben seleccionar antes de la compra la región correspondiente a la red del servidor. Actualmente se admite:
- Región China
- Región Norteamérica
Método 1: gestionar spatial maps en EasyAR Developer Center
Adecuado para escenarios de negocio a pequeña escala. Los pasos son:
- Inicie sesión en EasyAR Developer Center y entre en SpatialMap.
- Seleccione región China o región Norteamérica. Si aún no se ha creado una SpatialMap library, cree primero una nueva SpatialMap library.
- Como EasyAR SpatialMap está vinculado a EasyAR Sense, la operación para crear la SpatialMap library se realiza en la página Sense License Key.
- Sense authorization -> SpatialMap

Haga clic en Manage en la lista de image library para entrar en la lista SpatialMap. Haga clic en Manage en cualquier spatial map, como se muestra en la figura, para realizar las siguientes operaciones de gestión en un spatial map individual:
- Operación de eliminación
- Operación de actualización (mark 1): desactivar/activar mapa
- Operación de actualización (mark 2): modificar nombre
- Operación de actualización (mark 3): modificar etiqueta: Label
- Operación de actualización (mark 4): modificar ubicación: GNSS/GPS
- Operación de actualización (mark 5): modificar Meta: asociar recursos url y propiedades personalizadas

Método 2: usar REST API para gestión automatizada
Para escenarios que necesitan procesar mucha gestión de mapas, se recomienda usar Web Service REST API para implementar workflows automatizados en su aplicación o backend de gestión.
Lista de recursos de preparación
- SpatialMap AppId
- Credencial de autenticación: API Key / API Secret o Token
- Cloud URL: las direcciones de solicitud del servicio Spatial Map se dividen por data center, China (predeterminado) y EE. UU.:
- Región China:
https://armap-api.easyar.com - Región Norteamérica:
https://armap-api-na1.easyar.com
- Región China:
Obtener recursos de la lista
Obtener SpatialMap AppId:
Developer Center -> SpatialMap -> Select image library -> Manage -> Key (Authentication)
Obtener API Key / API Secret:
Developer Center -> Cloud Service APIKey -> Copy
Si todavía no tiene API Key, cree una API Key y asegúrese de marcar el permiso SpatialMap. Para obtener más información sobre API Key y control de permisos, consulte Introducción a API Key.

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

Si necesita personalizar el periodo de validez del Token, puede consultar UAC API - Crear Token y usar el APIKey y APISecret originales para crear un Token.
Guía de integración multiextremo
En workflows reales, la gestión de spatial maps suele integrarse en el servidor de negocio del desarrollador, mobile end o Unity:
Plataforma de servicios de negocio: proporciona código de ejemplo de API en lenguajes comunes de desarrollo de servidor (Curl/Java/NodeJS/PHP) para ayudar a los desarrolladores a implementar la gestión de spatial maps.
Mobile end (Unity/Mobile): los desarrolladores pueden usar Unity para desarrollar y crear spatial maps, y luego gestionar spatial maps basados en Unity.