Table of Contents

Gerenciamento de dados de sparse spatial map

Este capítulo apresenta como gerenciar dados de sparse spatial map do Spatial Map.

Dados

O processo de gerenciamento de dados de mapa é o seguinte:

  • Geração e upload: os mapas são gerados automaticamente pelo EasyAR Sense no lado do dispositivo e enviados para a cloud em um formato dedicado.
  • Gerenciamento na cloud: por meio de management APIs, desenvolvedores podem integrar funções de gerenciamento como adicionar, excluir, atualizar e consultar mapas.
  • Compartilhamento e distribuição: há suporte ao compartilhamento de mapas. Mapas enviados por qualquer dispositivo podem ser usados por outros dispositivos para localization, permitindo colaboração entre vários dispositivos.

Fluxo de dados

  • EasyAR Sense cria e envia mapas ao servidor. Durante o uso, os dados de mapa são baixados e usados. Antes do uso, a validade do cache é verificada primeiro.
  • O lado do usuário envia instruções de operação ao servidor de gerenciamento de dados por API.
flowchart TB

B[API ou EasyAR Web] --> A[Servidor de gerenciamento de dados]

A[Servidor de gerenciamento de dados] <-->  D[EasyAR Sense lado dispositivo] <--> C>Cache de dados lado dispositivo]

Data center

Considerando data centers de distribuição de rede, os usuários devem escolher antes da compra a região correspondente à rede do servidor. Atualmente há suporte a:

  • Região China
  • Região North America

Método 1: gerenciar spatial maps no EasyAR Developer Center

Adequado para cenários de negócios em pequena escala. As etapas são:

  1. Faça login no EasyAR Developer Center e acesse SpatialMap.
  2. Selecione região China ou região North America. Se ainda não houver uma SpatialMap library criada, crie primeiro uma nova SpatialMap library.
    • Como EasyAR SpatialMap está vinculado ao EasyAR Sense, a operação é realizada na página Sense License Key para criar a SpatialMap library.
    • Sense authorization -> SpatialMap

create-web

  1. Clique em Manage na lista de image library para entrar na lista SpatialMap. Clique em Manage em qualquer spatial map, como mostrado na figura, para realizar as seguintes operações de gerenciamento em um único spatial map:

    • Operação de exclusão
    • Operação de atualização (mark 1): desativar/ativar mapa
    • Operação de atualização (mark 2): modificar nome
    • Operação de atualização (mark 3): modificar etiqueta: Label
    • Operação de atualização (mark 4): modificar localização: GNSS/GPS
    • Operação de atualização (mark 5): modificar Meta: associar recursos url e propriedades personalizadas

mgnt-web

Método 2: usar REST API para gerenciamento automatizado

Para cenários que precisam processar muito gerenciamento de mapas, recomenda-se usar Web Service REST API para implementar workflows automatizados no aplicativo ou management backend.

Checklist de recursos de preparação

  • SpatialMap AppId
  • Credencial de autenticação: API Key / API Secret ou Token
  • Cloud URL: os endereços de request do serviço Spatial Map são separados por data center, China (padrão) e EUA:
    • Região China: https://armap-api.easyar.com
    • Região North America: https://armap-api-na1.easyar.com

Obter recursos do checklist

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

    m1-appid

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

    m1-apikey

    Se você ainda não tem API Key, crie uma API Key e certifique-se de marcar a permissão SpatialMap. Para saber mais sobre API Key e controle de permissões, consulte Introdução a API Key.

m1-apikey

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

m1-token

    Se precisar personalizar o período de validade do Token, consulte UAC API - Criar Token e use o APIKey e APISecret originais para criar um Token.

Guia de integração multi-end

Em workflows reais, o gerenciamento de spatial maps geralmente é integrado ao servidor de negócios do desenvolvedor, ao mobile end ou ao Unity:

  • Plataforma de serviço de negócios: fornece código de exemplo API em linguagens comuns de desenvolvimento de servidor (Curl/Java/NodeJS/PHP) para ajudar desenvolvedores a implementar gerenciamento de spatial maps.

  • Mobile end (Unity/Mobile): desenvolvedores podem usar Unity para desenvolver e criar spatial maps, e depois gerenciar spatial maps com base em Unity.

Tópicos relacionados:

Próximo tópico: