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 管理空间地图。

相关主题：

下一主题：