Table of Contents

Gestão de dados de mapa espacial esparso

Este capítulo apresenta como gerenciar dados de mapa espacial esparso Spatial Map.

Dados

O fluxo de gestão de dados do mapa é o seguinte:

  • Geração e upload: O mapa é gerado automaticamente pelo EasyAR Sense no dispositivo e enviado para a nuvem em formato proprietário.
  • Gestão na nuvem: Através de APIs de gestão, os desenvolvedores podem integrar funcionalidades como adição, exclusão, modificação e consulta de mapas.
  • Compartilhamento e distribuição: Suporta compartilhamento de mapas, onde qualquer mapa enviado por um dispositivo pode ser usado por outros para posicionamento, permitindo colaboração multi-dispositivo.

Fluxo de dados

  • O EasyAR Sense cria e envia para o servidor. Durante o uso, os dados do mapa são baixados e utilizados. Verifique a validade do cache antes de usar.
  • O lado do usuário envia comandos de operação para o servidor de gestão de dados através da API
flowchart TB

B[API ou EasyAR Web] --> A[Servidor de gestão de dados]

A[Servidor de gestão de dados] <-->  D[EasyAR Sense no dispositivo] <--> C>Cache de dados no dispositivo]

Centro de dados

Considere o centro de dados de distribuição de rede. Selecione a região correspondente à rede do servidor antes da compra. Atualmente suportado:

  • China
  • América do Norte

Método 1: Gerenciar mapas espaciais no EasyAR Developer Center

Adequado para cenários de negócios em pequena escala. Etapas de operação:

  1. Faça login no EasyAR Developer Center, acesse SpatialMap.
  2. Selecione China ou América do Norte. Se ainda não criou uma biblioteca SpatialMap, crie uma nova.
    • Como o EasyAR SpatialMap está vinculado ao EasyAR Sense, a operação é realizada na página Sense License Key
    • Sense Authorization -> SpatialMap

create-web

  1. Na lista de bibliotecas, clique em Gerenciar para acessar a lista de SpatialMaps. Clique em Gerenciar em qualquer mapa espacial, como mostrado, e realize as seguintes operações de gestão:

    • Exclusão
    • Atualização (marca 1): Desativar/ativar mapa
    • Atualização (marca 2): Modificar nome
    • Atualização (marca 3): Modificar etiqueta: Label
    • Atualização (marca 4): Modificar localização: GNSS/GPS
    • Atualização (marca 5): Modificar Meta: Associar recurso url, propriedades personalizadas

mgnt-web

Método 2: Usar REST API para gestão automatizada

Para cenários que exigem gerenciamento de grande volume de mapas, recomenda-se usar a Web Service REST API para implementar fluxos automatizados em seu aplicativo ou backend de gestão.

Preparar lista de recursos

  • SpatialMap AppId
  • Credenciais de autenticação: API Key / API Secret ou Token
  • Cloud URL: Os endpoints de serviço Spatial Map variam por região:
    • China: https://armap-api.easyar.com
    • América do Norte: https://armap-api-na1.easyar.com

Obter recursos da lista

  • Obter SpatialMap AppId:
    Developer Center -> SpatialMap -> Selecionar biblioteca -> Gerenciar -> Autenticação (Authentication)

    m1-appid

  • Obter API Key / API Secret:
    Developer Center -> APIKey de serviços na nuvem -> Copiar

    m1-apikey

    Se ainda não tiver uma API Key, crie uma. Permissões para SpatialMap devem ser selecionadas. Para mais detalhes sobre API Key e controle de permissões, consulte o tópico Introdução à API Key

m1-apikey

  • Obter Token:
    Developer Center -> APIKey de serviços na nuvem -> Gerenciar -> Selecionar validade -> Gerar Token -> Copiar

m1-token

    Se precisar personalizar a validade do Token, consulte o método UAC API —— Criar Token, usando o APIKey e APISecret originais

Orientação para integração multi-terminal

Em fluxos de trabalho reais, a gestão de mapas espaciais é normalmente integrada no servidor de negócios do desenvolvedor, ou em dispositivos móveis ou Unity:

  • Plataforma de serviço de negócios: Fornece exemplos de código em linguagens comuns (Curl/Java/NodeJS/PHP) para chamadas de API, ajudando desenvolvedores a implementar gestão de mapas espaciais.

  • Dispositivos móveis (Unity/Mobile): Desenvolvedores podem usar Unity para criar e gerenciar mapas espaciais.

Tópicos relacionados:

Próximo tópico: