检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
Key)加密调用请求,适用于AR地图运行服务。 Token认证 Token的有效期为24小时,需要使用一个Token鉴权时,可以先缓存起来,避免频繁调用。 Token在计算机系统中代表令牌(临时)的意思,拥有Token就代表拥有某种权限。 Token认证就是在调用API的时候将Token加到请求消息头,从而通过
API 空间定位 空间导航
API概览 云地图服务接口的分类与说明如表1所示。 表1 API概览 类型 说明 视觉定位 通过拍摄一系列具有已知位置的图像并分析它们的关键视觉特征(例如建筑物或桥梁的轮廓)来创建地图,以创建这些视觉特征的大规模且可快速搜索的索引。将设备图像中的特征与索引中的特征进行比较,可获得目标设备的位姿。
API使用 API是否支持集成到第三方产品中 API是否存在对调用IP数量的限制
如何调用API 构造请求 认证鉴权 返回结果
时捕捉的实景画面,将地图导航信息通过数字内容的形态叠加在实景画面中,生成虚拟的3D导航指引。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v1/algo/navi
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的详细介绍及
的大规模且可快速搜索的索引。将设备图像中的特征与索引中的特征进行比较,可获得目标设备的位姿。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v1/algo/vps
认证用的AK、SK硬编码到代码中或明文存储都有很大的安全风险,建议在代码中配置加密后的AK/SK,解密后传入hwar.setAKSK方法中。 let result:boolean = hwar.setAKSK({ AK: "解密后的变量", SK: "解密后的变量" }); //
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
请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对AR导航接口,如果调用后返回状态码为“200”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。 响应消息体(可选)
API是否支持集成到第三方产品中 如果用户需要将KooMap服务集成到第三方系统用于二次开发,请使用API方式访问KooMap服务,具体操作和描述请参见如何调用API。 父主题: API使用
以跳过本章节,不影响您使用云地图服务的其它功能。 在创建IAM用户时,需要勾选“访问方式 > 编程访问”,勾选后该IAM用户才有权限访问API。 默认情况下,新建的IAM用户没有任何权限,您需要将其加入用户组,并给用户组授予策略(以JSON格式描述权限集的语言),才能使用户组中的
附录 状态码 错误码