检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API列表 调用前须知 视觉定位 空间位置追踪与渲染 导航 事件管理 SDK内部派发事件 父主题： WebARSDK使用手册
API列表 调用前准备工作 视觉定位 事件 日志 其他 父主题： XRLightSDK使用手册
API使用 API是否支持集成到第三方产品中 API是否存在对调用IP数量的限制
如何调用API 构造请求 认证鉴权 返回结果
API概览 云地图服务接口的分类与说明如表1所示。 表1 API概览 类型 说明 视觉定位 通过拍摄一系列具有已知位置的图像并分析它们的关键视觉特征（例如建筑物或桥梁的轮廓）来创建地图，以创建这些视觉特征的大规模且可快速搜索的索引。将设备图像中的特征与索引中的特征进行比较，可获得目标设备的位姿。
API 空间定位 空间导航
resource-path 资源路径，即API访问路径。从具体API的URI模块获取，例如“AR导航”API的resource-path为“/v1/algo/navi”。 query-string 可选参数，用于查询指定参数数据。设置查询参数时，查询参数前面需要带一个“?”，形式为“参数名=参数取值”，例如“
API是否存在对调用IP数量的限制 API对调用IP数量无限制，满足华为云APIG身份认证的请求均可访问KooMap服务。默认支持20QPS。 父主题： API使用
Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。 Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 云服务存在两种部署方式：项目级服务和全局级服务。其中： 项目级服务需要获
API是否支持集成到第三方产品中 如果用户需要将KooMap服务集成到第三方系统用于二次开发，请使用API方式访问KooMap服务，具体操作和描述请参见如何调用API。 父主题： API使用
空间定位 视觉定位 父主题： API
请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对AR导航接口，如果调用后返回状态码为“200”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 响应消息体（可选）
状态码 常用状态码请参见表1。 表1 请求状态返回码 状态码 描述 说明 200 OK 服务器已成功处理了请求。 400 Bad Request 非法请求。 建议直接修改该请求，不要重试该请求。 403 Forbidden 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，
以跳过本章节，不影响您使用云地图服务的其它功能。 在创建IAM用户时，需要勾选“访问方式 > 编程访问”，勾选后该IAM用户才有权限访问API。 默认情况下，新建的IAM用户没有任何权限，您需要将其加入用户组，并给用户组授予策略（以JSON格式描述权限集的语言），才能使用户组中的
的大规模且可快速搜索的索引。将设备图像中的特征与索引中的特征进行比较，可获得目标设备的位姿。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v1/algo/vps
时捕捉的实景画面，将地图导航信息通过数字内容的形态叠加在实景画面中，生成虚拟的3D导航指引。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v1/algo/navi
错误码 AR地图运行服务错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 NAVI.0002 Navi failed, please check parameters. 导航失败。 检查参数是否正确或联系技术支持。
您可以使用本文档提供的API对云地图服务进行相关操作，如空间定位、空间导航。支持的全部操作请参见API概览。 在调用KooMap API之前，请确保已经充分了解KooMap相关概念，详细信息请参见云地图服务的《产品介绍》。 终端节点 终端节点（Endpoint）即调用API的请求地址，不
空间导航 AR导航 父主题： API
附录 状态码 错误码
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
