EasyAR Spatialmap 简介

EasyAR Spatialmap 用于管理EasyAR稀疏地图内容，支持云端管理和分发EasyAR地图内容，配套Sense开通和管理，不允许独立开通，仅允许EasyAR格式地图上传下载。

Spatialmap帮助开发者者实现地图共享，设备A上传的地图允许其他设备定位，实现多个设备共享。

地图创建完成以后，您的应用启动摄像头，可以使用search接口依据name, tags, gps等信息查找地图，然后运行load和定位开始您的AR之旅。

Spatialmap Management API 帮助用户集成自己的应用实现地图查询、信息更新和删除等管理操作。

Spatialmap 快速入门

下载EasyAR Sense 4 Spatialmap 样例。

注意：支持Spatialmap小地图创建和定位需要EasyAR Sense 4或以上。

step 1), 您需要先申请一个EasyAR Sense License，在“开发中心" -> "Sense授权管理" 创建一个license key。

step 2), 获取<APIKey, APISecret>, 登录进入开发者中心 -> APIKey -> 创建拥有Spatialmap功能的密钥对。

step 3), 获取Spatialmap AppId. 开发者中心 -> Spatialmap，调用每个接口需要再parameter参数列表理指定 Your Spatialmap AppId.

step 4), 下载Sense 4.0以上样例，填写<APIKey, APISecret, AppId>，开始样例程序开始您的第一个AR应用。

Spatialmap Management API

小场景稀疏地图通过EasyAR Sense创建并自动上传，可以通过以下方式管理：

  • 1）通过WebUI里的“开发者中心”进行管理

  • 2）通过调用Web Service API管理

这是详细的`管理地图相关 API 的列表`_, 进一步了解API的使用方式。

这是使用APIKey认证Spatialmap API的方法。点击`EasyAR API 统一认证`_, 进一步了解API的认证机制。

Web Service API

Spatialmap服务的请求地址Cloud URL：

API包括两部分参数内容:

  • 签名认证用的几个Common Parameters

    • Timestamp: timestamp

    • APIKey: apiKey

    • Spatialmap AppId: appId

    • Request signature: signature

  • Command parameters

    Notes: Common signature parameters 各个API所特有的

您需要使用接入信息 <API Key, API Secret, Spatialmap AppId, Cloud URL>来调用Web Service API。

关于更多API如何认证的细节，请参考 签名的示例 。

FAQ

1，为什么没有Spatialmap上传与下载的接口？

Spatialmap区别与网盘存储，所以没有单独开放上传下载接口，而是需与EasyAR Sense配合使用。需要使用EasyAR Sense创建地图上传并下载。

2, Spatialmap 有接口调用次数限制嘛？

没有限制，除了getMap接口以外。getMap下载地图有调用次数限制，Basic版本的接口调用次数限制100次/天。每日累计从每天UTC 08:00:00定时重置。

3， 返回 401是什么原因?

APIKey和Spatialmap AppId 认证失败，可能您的APIKey的ACL不允许使用Spatialmap。