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 綁定，所以操作是在 Sense License Key 頁面裡建立 SpatialMap 庫
    • Sense 授權 -> 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，建立 API Key，必須勾選 SpatialMap 權限。進一步了解 API Key 以及權限控制，參考主題API Key 簡介

m1-apikey

  • 取得 Token：
    開發中心 -> 雲服務 APIKey -> 管理 -> 選擇有效期 -> 生成 Token -> 複製

m1-token

    若您需要自訂 Token 的有效期，可以參考 UAC API —— 建立 Token 方式，使用原始 APIKey 和 APISecret 來建立 Token

多端整合指引

在實際工作流中，空間地圖管理通常整合在開發者的業務伺服器裡，或者行動端或者 Unity 裡：

  • 業務服務平台：提供有常用伺服器開發語言（Curl/Java/NodeJS/PHP）呼叫 API 示例程式碼，幫助開發者實現空間地圖的管理。

  • 行動端（Unity/Mobile）：開發者可以用 Unity 開發建立空間地圖，然後基於 Unity 管理空間地圖。

相關主題：

下一主題：