检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
快速开始 以工程Project为例,通过引入SDK脚本、传入AK/SK、调用API,验证工程中SDK是否引入正常,为后续功能开发做准备。 操作步骤 创建工程(Project),并将WebARSDK包解压后放入工程目录。 Project ├── index.html ├── src
视觉定位 接口列表 视觉定位需要使用的接口如表1所示。 表1 视觉定位接口列表 接口 描述 参数名 参数类型 参数说明 返回值 getToken 向服务器请求签名。 - - - Promise<any> setAKSK 验证租户身份信息。 requestParams { AK: string;
控制台层面:您可以使用华为云用户名与密码登录,实现用户的认证与鉴权,未授权的不能访问。 云服务层面:您可通过开放的API网关,实现AR地图运行服务的访问和集成,具体操作和描述请参考KooMap的《API参考》。KooMap提供如下两种认证方式进行认证鉴权。 Token认证:指通过Token认证通用
下载、解压WebARSDK包,并将下载WebARSDK包放入工程目录,通过外部引入脚本的方式引入WebARSDK文件。 验证租户身份信息。 通过hwar.setAKSK方法将AK/SK传入SDK,验证租户身份信息。 开启AR会话。 获取图像及传感器数据,初始化SLAM,准备相关环境。 实现AR导航和渲染3D内容。
K识别访问用户的身份,通过SK对请求数据进行签名验证。详情见配置域名及密钥。 打包构建。 在“HTFoundation > Samples”下找到“HTFoundationTester”,将其添加到打包场景中进行打包构建。详情见验证结果。 父主题: HTSDK使用手册
API是否存在对调用IP数量的限制 API对调用IP数量无限制,满足华为云APIG身份认证的请求均可访问KooMap服务。默认支持20QPS。 父主题: API使用
作员权限“KooMap FullAccess”。 创建用户并加入用户组。 在IAM控制台创建用户,并将其加入1中创建的用户组。 用户登录并验证权限。 新创建的用户登录控制台,如能进入KooMap首页,则表示“KooMap FullAccess”权限已生效。
ID,AK)和秘密访问密钥(Secret Access Key,SK)两部分,是您在华为云的长期身份凭证。华为云通过AK识别访问用户的身份,通过SK对请求数据进行签名验证,用于确保请求的机密性、完整性和请求者身份的正确性。 获取方法请参见访问密钥。 开通关联服务 开通AR地图运行服务、AR地图数据构建服务、AR地图数据采集服务(可选)。
API概览 云地图服务接口的分类与说明如表1所示。 表1 API概览 类型 说明 视觉定位 通过拍摄一系列具有已知位置的图像并分析它们的关键视觉特征(例如建筑物或桥梁的轮廓)来创建地图,以创建这些视觉特征的大规模且可快速搜索的索引。将设备图像中的特征与索引中的特征进行比较,可获得目标设备的位姿。
Token在计算机系统中代表令牌(临时)的意思,拥有Token就代表拥有某种权限。 Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限。Token可通过调用获取用户Token接口获取。 云服务存在两种部署方式:项目级服务和全局级服务。其中: 项目级服务需要获
以跳过本章节,不影响您使用云地图服务的其它功能。 在创建IAM用户时,需要勾选“访问方式 > 编程访问”,勾选后该IAM用户才有权限访问API。 默认情况下,新建的IAM用户没有任何权限,您需要将其加入用户组,并给用户组授予策略(以JSON格式描述权限集的语言),才能使用户组中的
侦听事件“LANDSCAPE_BY_ROLL”检查当前屏幕是否竖屏。 侦听事件“ORIENTATION_NORMAL”检查屏幕正向状态。 验证视觉定位效果时,您需竖屏正向手持设备扫描周边环境。 检查定位区域是否在地图服务范围内。 按“F12”打开DevTools,在“Networ
则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET、DELETE操作类型的接口就不需要消息体,消息体具体内容需要根据具体接口而定。 对于AR导航接口,您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示。
时捕捉的实景画面,将地图导航信息通过数字内容的形态叠加在实景画面中,生成虚拟的3D导航指引。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v1/algo/navi
请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对AR导航接口,如果调用后返回状态码为“200”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。 响应消息体(可选)
的大规模且可快速搜索的索引。将设备图像中的特征与索引中的特征进行比较,可获得目标设备的位姿。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI POST /v1/algo/vps
KooMap服务支持哪些调用方式 当前KooMap的AR地图运行服务支持通过华为云APIG的REST接口进行请求调用。此外,AR地图运行服务还支持通过服务特有的SDK进行调用,详情请参考《开发指南》。所有客户端请求均需要转换为租户身份进行处理,客户端由租户自行构建。 父主题: 服务开通
导航 导航需要使用到的接口如表1所示。 表1 导航接口列表 接口 描述 参数名 参数类型 参数说明 返回值 searchPoi POI智能搜索。 searchData { floor?: string; address?: string; title?: string; tag?:
事件管理 事件管理使用到的接口如表1所示。 表1 事件管理接口列表 接口 描述 参数名 参数类型 参数说明 返回值 dispatchEvent 事件派发。 strId string 侦听事件id。 void data { [key: string]: DataType } 携带的数据。
API 空间定位 空间导航