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