Table of Contents

Управление данными sparse spatial map

В этой главе описано, как управлять данными sparse spatial map Spatial Map.

Данные

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

  • Генерация и загрузка: карты автоматически создаются EasyAR Sense на стороне устройства и загружаются в cloud в специальном формате.
  • Управление в cloud: через management APIs разработчики могут интегрировать функции управления картами, такие как добавление, удаление, обновление и запрос.
  • Совместное использование и распространение: поддерживается совместное использование карт. Карта, загруженная любым устройством, может использоваться другими устройствами для localization, обеспечивая совместную работу нескольких устройств.

Поток данных

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

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

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

Data center

С учетом data center для сетевого распространения пользователям следует выбрать регион, соответствующий сети сервера, перед покупкой. Сейчас поддерживаются:

  • Регион China
  • Регион North America

Способ 1: управление spatial maps в EasyAR Developer Center

Подходит для небольших бизнес-сценариев. Шаги следующие:

  1. Войдите в EasyAR Developer Center и перейдите в SpatialMap.
  2. Выберите регион China или North America. Если SpatialMap library еще не создана, сначала создайте новую SpatialMap library.
    • Поскольку EasyAR SpatialMap привязан к EasyAR Sense, создание SpatialMap library выполняется на странице Sense License Key.
    • Sense authorization -> SpatialMap

create-web

  1. Нажмите Manage в списке image library, чтобы перейти к списку SpatialMap. Нажмите Manage для любой spatial map, как показано на рисунке, чтобы выполнить следующие операции управления отдельной spatial map:

    • Операция удаления
    • Операция обновления (mark 1): отключить/включить карту
    • Операция обновления (mark 2): изменить имя
    • Операция обновления (mark 3): изменить label: Label
    • Операция обновления (mark 4): изменить location: GNSS/GPS
    • Операция обновления (mark 5): изменить Meta: связать url-ресурсы и пользовательские свойства

mgnt-web

Способ 2: использование REST API для автоматизированного управления

Для сценариев, где нужно обрабатывать большое количество операций управления картами, рекомендуется использовать Web Service REST API, чтобы реализовать автоматизированные workflows в приложении или management backend.

Контрольный список ресурсов для подготовки

  • SpatialMap AppId
  • Учетные данные аутентификации: API Key / API Secret или Token
  • Cloud URL: адреса запросов сервиса Spatial Map разделены по data center, China (по умолчанию) и US:
    • Регион China: https://armap-api.easyar.com
    • Регион North America: https://armap-api-na1.easyar.com

Получение ресурсов списка

  • Получить SpatialMap AppId:
    Developer Center -> SpatialMap -> Select image library -> Manage -> Key (Authentication)

    m1-appid

  • Получить API Key / API Secret:
    Developer Center -> Cloud Service APIKey -> Copy

    m1-apikey

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

m1-apikey

  • Получить Token:
    Developer Center -> Cloud Service APIKey -> Manage -> Select validity period -> Generate Token -> Copy

m1-token

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

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

В реальных workflows управление spatial map обычно интегрируется в бизнес-сервер разработчика, mobile end или Unity:

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

  • Mobile end (Unity/Mobile): разработчики могут использовать Unity для разработки и создания spatial maps, а затем управлять spatial maps на базе Unity.

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

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