检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 云地图服务接口的分类与说明如表1所示。 表1 API概览 类型 说明 视觉定位 通过拍摄一系列具有已知位置的图像并分析它们的关键视觉特征(例如建筑物或桥梁的轮廓)来创建地图,以创建这些视觉特征的大规模且可快速搜索的索引。将设备图像中的特征与索引中的特征进行比较,可获得目标设备的位姿。
API列表 调用前须知 视觉定位 空间位置追踪与渲染 导航 事件管理 SDK内部派发事件 父主题: WebARSDK使用手册
API列表 调用前准备工作 视觉定位 事件 日志 其他 父主题: XRLightSDK使用手册
API使用 API是否支持集成到第三方产品中 API是否存在对调用IP数量的限制
API 空间定位 空间导航
如何调用API 构造请求 认证鉴权 返回结果
API是否存在对调用IP数量的限制 API对调用IP数量无限制,满足华为云APIG身份认证的请求均可访问KooMap服务。默认支持20QPS。 父主题: API使用
API是否支持集成到第三方产品中 如果用户需要将KooMap服务集成到第三方系统用于二次开发,请使用API方式访问KooMap服务,具体操作和描述请参见如何调用API。 父主题: API使用
请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对AR导航接口,如果调用后返回状态码为“200”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。 响应消息体(可选)
则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。 对于AR导航接口,您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示。
鉴权时,可以先缓存起来,避免频繁调用。 Token在计算机系统中代表令牌(临时)的意思,拥有Token就代表拥有某种权限。 Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限。Token可通过调用获取用户Token接口获取。 云
实景画面,将地图导航信息通过数字内容的形态叠加在实景画面中,生成虚拟的3D导航指引。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v1/algo/navi
空间导航 AR导航 父主题: API
状态码 常用状态码请参见表1。 表1 请求状态返回码 状态码 描述 说明 200 OK 服务器已成功处理了请求。 400 Bad Request 非法请求。 建议直接修改该请求,不要重试该请求。 403 Forbidden 请求被拒绝访问。 返回该状态码,表明请求能够到达服务端,
)是提供空间处理、计算、可视、虚实交互等一站式开箱即用的云服务,赋能客户虚实融合互动的应用创新。 您可以使用本文档提供的API对云地图服务进行相关操作,如空间定位、空间导航。支持的全部操作请参见API概览。 在调用KooMap API之前,请确保已经充分了解KooMap相关概念,详细信息请参见云地图服务的《产品介绍》。
权限 您可以使用统一身份认证服务(Identity and Access Management,简称IAM)对您所拥有的云地图服务进行精细的权限管理。如果账号已经能满足您的要求,不需要创建独立的IAM用户,您可以跳过本章节,不影响您使用云地图服务的其它功能。 在创建IAM用户时,需要勾选“访问方式
附录 状态码 错误码
错误码 AR地图运行服务错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 NAVI.0002 Navi failed, please check parameters. 导航失败。 检查参数是否正确或联系技术支持。
空间定位 视觉定位 父主题: API
且可快速搜索的索引。将设备图像中的特征与索引中的特征进行比较,可获得目标设备的位姿。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v1/algo/vps