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 管理空間地圖。

相關主題：

下一主題：