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