检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
认证鉴权 调用接口有如下两种认证方式，您可以根据实际情况选择其中一种进行认证鉴权。 Token认证：指通过Token认证调用请求，适用于AR地图运行服务。 AK/SK认证：指通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求，适用于AR地图运行服务。
API 空间定位 空间导航
API概览 云地图服务接口的分类与说明如表1所示。 表1 API概览 类型 说明 视觉定位 通过拍摄一系列具有已知位置的图像并分析它们的关键视觉特征（例如建筑物或桥梁的轮廓）来创建地图，以创建这些视觉特征的大规模且可快速搜索的索引。将设备图像中的特征与索引中的特征进行比较，可获得目标设备的位姿。
API使用 API是否支持集成到第三方产品中 API是否存在对调用IP数量的限制
如何调用API 构造请求 认证鉴权 返回结果
API列表 WebARSDK封装类名为“hwar”，所有API均直接通过类“hwar”来调用，无需实例化。 本章节所指的GPS坐标系为WGS84坐标系。 utmCode指UTM（UNIVERSAL TRANSVERSE MERCARTOR GRID SYSTEM，通用横墨卡托格网系统）投影带号。
开启AR会话开发流程 开发过程 获取Token。 成功获取Token后才能进行定位请求。 // 向服务器请求签名 hwar.getToken().then((res) => { // 获取成功 }).catch((err) => { // 获取失败 }); 设置并检查AR会话开启前的相关配置。
用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头（Headers）中包含的“X-Subject-Token”的值即为Token值。 是 使用Token认证时该字段必选。 注：以下仅为Token示例片段 MIIPAgYJKoZIhvcNAQcCo
用户的认证与鉴权，未授权的不能访问。 云服务层面：您可通过开放的API网关，实现AR地图运行服务的访问和集成，具体操作和描述请参考KooMap的《API参考》。KooMap提供如下两种认证方式进行认证鉴权。 Token认证：指通过Token认证通用请求。关于Token的详细介绍及
时捕捉的实景画面，将地图导航信息通过数字内容的形态叠加在实景画面中，生成虚拟的3D导航指引。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v1/algo/navi
的大规模且可快速搜索的索引。将设备图像中的特征与索引中的特征进行比较，可获得目标设备的位姿。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI POST /v1/algo/vps
API是否存在对调用IP数量的限制 API对调用IP数量无限制，满足华为云APIG身份认证的请求均可访问KooMap服务。默认支持20QPS。 父主题： API使用
GATEWAY.0002 Auth failed, please check your auth token. 鉴权header未携带。 在请求头中携带鉴权信息，参考“如何调用API”。 403 GATEWAY.0003 Service unavailable. 服务未开通/冻结。
空间定位 视觉定位 父主题： API
空间导航 AR导航 父主题： API
API是否支持集成到第三方产品中 如果用户需要将KooMap服务集成到第三方系统用于二次开发，请使用API方式访问KooMap服务，具体操作和描述请参见如何调用API。 父主题： API使用
请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对AR导航接口，如果调用后返回状态码为“200”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 响应消息体（可选）
权限 您可以使用统一身份认证服务（Identity and Access Management，简称IAM）对您所拥有的云地图服务进行精细的权限管理。如果账号已经能满足您的要求，不需要创建独立的IAM用户，您可以跳过本章节，不影响您使用云地图服务的其它功能。 在创建IAM用户时，需要勾选“访问方式
视觉定位 接口列表 视觉定位需要使用的接口如表1所示。 表1 视觉定位接口列表 接口 描述 参数名 参数类型 参数说明 返回值 getToken 向服务器请求签名。 - - - Promise<any> setAKSK 验证租户身份信息。 requestParams { AK: string;
附录 状态码 错误码
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
