Gestión de datos de mapa espacial disperso
Este capítulo presenta cómo gestionar los datos de Spatial Map de mapa espacial disperso.
Datos
El flujo de gestión de datos del mapa es el siguiente:
- Generación y carga: el mapa es generado automáticamente por EasyAR Sense en el dispositivo y cargado a la nube en formato propietario.
- Gestión en la nube: a través de las API de gestión, los desarrolladores pueden integrar funciones como agregar, eliminar, modificar y consultar mapas.
- Distribución compartida: admite el uso compartido de mapas; cualquier mapa cargado por un dispositivo puede ser utilizado por otros dispositivos para posicionamiento, logrando colaboración multi-dispositivo.
Flujo de datos
- EasyAR Sense crea y carga el mapa al servidor. Durante el uso, se descarga y utiliza el mapa. Antes de usarlo, se verifica la validez de la caché.
- El usuario envía comandos de operación al servidor de gestión de datos a través de la 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 en dispositivo] <--> C>Caché de datos en dispositivo]
Centro de datos
Considere el centro de datos de distribución de red; el usuario debe seleccionar la región correspondiente a la red del servidor antes de la compra. Actualmente se admiten:
- Región de China
- Región de Norteamérica
Método 1: Gestionar el mapa espacial en el centro de desarrollo de EasyAR
Adecuado para casos de negocio a pequeña escala. Los pasos de operación son:
- Inicie sesión en el centro de desarrollo de EasyAR, acceda a SpatialMap.
- Seleccione la región de China o Norteamérica. Si aún no ha creado una biblioteca SpatialMap, cree una nueva biblioteca SpatialMap.
- Dado que EasyAR SpatialMap está vinculado a EasyAR Sense, la operación se realiza en la página de Sense License Key para crear la biblioteca SpatialMap
- Autorización de Sense -> SpatialMap

En la lista de galerías, haga clic en Gestionar para acceder a la lista de SpatialMap. Haga clic en Gestionar en cualquier mapa espacial, como se muestra en la figura, y realice las siguientes operaciones de gestión en un mapa espacial individual
- Operación de eliminación
- Operación de actualización (marca 1): desactivar/activar mapa
- Operación de actualización (marca 2): modificar nombre
- Operación de actualización (marca 3): modificar etiqueta: Label
- Operación de actualización (marca 4): modificar ubicación: GNSS/GPS
- Operación de actualización (marca 5): modificar Meta: asociar recurso url, propiedades personalizadas

Método 2: Usar la API REST para gestión automatizada
Para escenarios que requieren gestionar grandes cantidades de mapas, se recomienda utilizar la API REST de Web Service, para implementar flujos automatizados en su aplicación o backend de gestión.
Preparar la lista de recursos
- SpatialMap AppId
- Credenciales de autenticación: API Key / API Secret o Token
- Cloud URL: Las URL de solicitud del servicio Spatial Map se dividen por centro de datos, China (predeterminado) y EE. UU. son:
- Región de China:
https://armap-api.easyar.com - Región de Norteamérica:
https://armap-api-na1.easyar.com
- Región de China:
Obtener recursos de la lista
Obtener SpatialMap AppId:
Centro de desarrollo -> SpatialMap -> Seleccionar galería -> Gestionar -> Claves (Authentication)
Obtener API Key / API Secret:
Centro de desarrollo -> APIKey de servicio en la nube -> Copiar
Si aún no tiene API Key, cree una API Key, debe marcar el permiso de SpatialMap. Para más información sobre API Key y control de permisos, consulte el tema Introducción a API Key

- Obtener Token:
Centro de desarrollo -> APIKey de servicio en la nube -> Gestionar -> Seleccionar validez -> Generar Token -> Copiar

Si necesita personalizar la validez del Token, puede consultar el método API UAC —— Crear Token, usando el APIKey original y APISecret para crear el Token
Guía de integración multi-terminal
En flujos de trabajo reales, la gestión de mapas espaciales generalmente se integra en el servidor de negocio del desarrollador, o en el móvil o Unity:
Plataforma de servicio de negocio: Proporciona ejemplos de código de llamada API en lenguajes de desarrollo de servidor comunes (Curl/Java/NodeJS/PHP), ayudando a los desarrolladores a implementar la gestión de mapas espaciales.
Dispositivo móvil (Unity/Mobile): Los desarrolladores pueden usar Unity para crear mapas espaciales y luego gestionarlos basados en Unity.