Table of Contents

Управление данными разреженных пространственных карт

В этой главе описывается управление данными разреженных пространственных карт Spatial Map.

Данные

Процесс управления данными карт выглядит следующим образом:

  • Генерация и загрузка: Карты автоматически генерируются EasyAR Sense на устройстве и загружаются в облако в специальном формате.
  • Облачное управление: Через API управления разработчики могут интегрировать функции управления картами, такие как добавление, удаление, изменение и поиск.
  • Совместное использование и распространение: Поддерживается обмен картами. Любая карта, загруженная одним устройством, может использоваться другими устройствами для локализации, обеспечивая совместную работу нескольких устройств.

Поток данных

  • EasyAR Sense создает и загружает карту на сервер. При использовании карта загружается и применяется. Перед использованием проверяется актуальность кэша.
  • Пользователь отправляет команды управления через API на сервер управления данными.
flowchart TB

B[API или EasyAR Web] --> A[Сервер управления данными]

A[Сервер управления данными] <-->  D[Устройство EasyAR Sense] <--> C>Кэш данных на устройстве]

Центры обработки данных

Учитывая центры распространения данных в сети, при покупке выберите регион, соответствующий серверной сети. В настоящее время поддерживаются:

  • Китай
  • Северная Америка

Метод 1: Управление пространственными картами в центре разработки EasyAR

Подходит для небольших проектов. Шаги:

  1. Войдите в центр разработки EasyAR, перейдите в раздел SpatialMap.
  2. Выберите регион (Китай или Северная Америка). Если библиотека SpatialMap еще не создана, создайте новую библиотеку SpatialMap.
    • Поскольку EasyAR SpatialMap привязан к EasyAR Sense, создание библиотеки SpatialMap происходит на странице Sense License Key
    • Sense Auth -> SpatialMap

create-web

  1. В списке галерей нажмите Управление, чтобы перейти к списку SpatialMap. Нажмите Управление для любой пространственной карты. Как показано на рисунке, для отдельной карты доступны следующие операции управления:

    • Удаление
    • Обновление (метка 1): деактивировать/активировать карту
    • Обновление (метка 2): изменить имя
    • Обновление (метка 3): изменить метку (Label)
    • Обновление (метка 4): изменить местоположение (GNSS/GPS)
    • Обновление (метка 5): изменить Meta: связать URL-ресурс, пользовательские атрибуты

mgnt-web

Метод 2: Автоматизированное управление с использованием REST API

Для сценариев, требующих управления большим количеством карт, рекомендуется использовать Web Service REST API для автоматизации процессов в вашем приложении или административной панели.

Подготовка списка ресурсов

  • SpatialMap AppId
  • Учетные данные аутентификации: API Key / API Secret или Token
  • Cloud URL: Адреса запросов службы Spatial Map различаются по ЦОД:
    • Китай: https://armap-api.easyar.com
    • Северная Америка: https://armap-api-na1.easyar.com

Получение ресурсов

  • Получение SpatialMap AppId:
    Центр разработки -> SpatialMap -> Выберите галерею -> Управление -> Аутентификация (Authentication)

    m1-appid

  • Получение API Key / API Secret:
    Центр разработки -> APIKey облачных сервисов -> Копировать

    m1-apikey

    Если у вас еще нет API Key, создайте его, обязательно отметив разрешения SpatialMap. Подробнее об API Key и управлении доступом см. в разделе Введение в API Key

m1-apikey

  • Получение Token:
    Центр разработки -> APIKey облачных сервисов -> Управление -> Выберите срок действия -> Сгенерировать Token -> Копировать

m1-token

    Если вам требуется установить пользовательский срок действия Token, вы можете использовать исходные APIKey и APISecret для создания Token через UAC API —— Создать Token

Руководство по интеграции

В реальных рабочих процессах управление пространственными картами часто интегрируется в бизнес-сервер разработчика, мобильное приложение или Unity:

  • Бизнес-платформа: Предоставляет примеры кода вызова API на популярных языках серверной разработки (Curl/Java/NodeJS/PHP), помогая разработчикам реализовать управление пространственными картами.

  • Мобильная платформа (Unity/Mobile): Разработчики могут использовать Unity для создания пространственных карт, а затем управлять ими на основе Unity.

Связанные темы:

Следующая тема: