检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
构造请求 本节介绍REST API请求的组成,并以调用KooMap的AR导航接口说明如何调用API。 请求URI 请求URI由如下部分组成: {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求消
KooMap服务支持哪些调用方式 当前KooMap的AR地图运行服务支持通过华为云APIG的REST接口进行请求调用。此外,AR地图运行服务还支持通过服务特有的SDK进行调用,详情请参考《开发指南》。所有客户端请求均需要转换为租户身份进行处理,客户端由租户自行构建。 父主题: 服务开通
API是否存在对调用IP数量的限制 API对调用IP数量无限制,满足华为云APIG身份认证的请求均可访问KooMap服务。默认支持20QPS。 父主题: API使用
返回结果 状态码 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对AR导航接口,如果调用后返回状态码为“200”,则表示请求成功。 响应消息头 对应请求消息头,响应同样
Access Key):私有访问密钥。与访问密钥ID结合使用,对请求进行加密签名,可标识发送方,并防止请求被修改。 使用AK/SK认证时,您可以基于签名算法使用AK/SK对请求进行签名,也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参考API签名指南。 签名SD
表1 请求状态返回码 状态码 描述 说明 200 OK 服务器已成功处理了请求。 400 Bad Request 非法请求。 建议直接修改该请求,不要重试该请求。 403 Forbidden 请求被拒绝访问。 返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,但是拒
导航参数不正确,位置不在您的服务区。 到有服务的地方请求或联系技术支持。 400 VPS.0002 VPS failed. 空间定位算法服务定位错误。 检查参数是否正确或请联系技术支持。 400 VPS.0003 Invalid parameters. 空间定位算法服务请求参数不正确。 检查参数是否正确。
ctionErrTooLarge” 原因一:可能是发起定位时使用的图片纹理特征不够明显。 解决方案:在移动端,对着纹理丰富的区域单击“手动请求Vps”重新发起定位。 原因二:可能是平面识别未初始化完成。 解决方案: 查看camera的position和rotation数值。 如果
单击“真机调试”,弹出“真机调试”窗口。 您可根据实际需求进行操作。 在“Console”页签查看日志信息。 在“Network”页签查看网络请求发送情况。 在“Sources”页签进行断点调试。 图1 真机调试界面 父主题: XRLightSDK使用手册
开发指导 开发流程 图1 开启AR会话开发流程 开发过程 获取Token。 成功获取Token后才能进行定位请求。 // 向服务器请求签名 hwar.getToken().then((res) => { // 获取成功 }).catch((err) => { //
Token认证:指通过Token认证通用请求。关于Token的详细介绍及获取方式,请参见获取IAM用户Token(使用密码)。 AK/SK认证:指通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。推荐使用AK/SK认证,其安全性比To
isNormal表示当前设备的俯仰角是否正常。 VIDEO_STREAM_GET_ERROR 视频流获取失败。 可能原因是: 浏览器不支持WebRTC。 请求打开摄像头权限失败。 - - 需要侦听回调。回调函数无event参数。 VIDEO_STREAM_GET_NONE_PIXEL 视频流为空
供SDK代码示例调试功能。 URI POST /v1/algo/navi 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Trace-Id 否 String 参数解释: 追踪请求ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 App-Id
ID,AK)和秘密访问密钥(Secret Access Key,SK)两部分,是您在华为云的长期身份凭证。华为云通过AK识别访问用户的身份,通过SK对请求数据进行签名验证,用于确保请求的机密性、完整性和请求者身份的正确性。 获取方法请参见访问密钥。 开通关联服务 开通AR地图运行服务。 环境要求 已安装微信开发者工具。
ID,AK)和秘密访问密钥(Secret Access Key,SK)两部分,是您在华为云的长期身份凭证。华为云通过AK识别访问用户的身份,通过SK对请求数据进行签名验证,用于确保请求的机密性、完整性和请求者身份的正确性。 获取方法请参见访问密钥。 开通关联服务 开通AR地图运行服务。 AR地图运行服务可在KooMap管理控制台开通。
其他 接口列表 表1 其他接口列表 接口 描述 参数名 参数类型 参数说明 返回值 requestNavi 请求导航路径。 utmCode string 当前utm区域。 void from number[3] 导航出发点utm坐标。 to number[3] 导航目的地utm坐标。
is-ar-camera></xr-camera> </xr-node> </xr-scene> 触发定位请求 手动触发定位请求,获取当前位置。在手动触发请求时,如果自动请求正在处理中,则此次手动请求将视为无效。 XRClient.requestVps();//返回定位结果。 更新相机位姿 在
t是当前的位置的UTM坐标 vpsOffset: Vector3 void requestVps 触发手动定位请求。定位结果会通过回调函数返回。 - - - void 接口调用示例 // 向服务器请求签名 hwar.getToken().then((res) => { // 进行后续操作(无需获取具体签名值)
提供SDK代码示例调试功能。 URI POST /v1/algo/vps 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Trace-Id 否 String 参数解释: 追踪请求ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 App-Id
true:开启会话,开始发送请求。 false:关闭会话,停止发送请求。 void apkUuidIsUpdate boolean 是否更新会话。可选。 默认为false。 true:重置会话,重新进行VPS请求。 false:不重置会话。 multiFrame boolean 是否连续请求定位。可选。