检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
什么是区域和可用区 KooMap用区域和可用区来描述数据中心的位置，用户可以在特定的区域、可用区创建资源。 区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Reg
AR地图服务通过AR地图生产和AR地图运行来实现基于视觉定位（VPS）的AR内容展示和AR导航。应用到具体项目时，应妥善选取场景。若场景选取不合适，可能导致视觉定位效果不佳，影响最终的AR内容展示和AR导航。 场景选取总体原则： VPS定位能力与人的视觉定位能力类似，需要捕捉环境中的特征点作为定位依据。如果面对某特定
调试方法 调试工具 手机或平板 微信开发者工具 调试步骤 登录微信开发者工具。 单击“真机调试”，弹出“真机调试”窗口。 您可根据实际需求进行操作。 在“Console”页签查看日志信息。 在“Network”页签查看网络请求发送情况。 在“Sources”页签进行断点调试。 图1
"useCompilerPlugins": [ "typescript" ] 单击“真机调试”，小程序会自动发起定位，根据定位结果后，会弹出Toast提示是否定位成功。如定位失败，可参见常见问题排查章节确定原因。 渲染数字内容。 选择utils文件夹，单击右键，选择“新建文件”，命名为“ModelMag
导航参数不正确，位置不在您的服务区。 到有服务的地方请求或联系技术支持。 400 VPS.0002 VPS failed. 空间定位算法服务定位错误。 检查参数是否正确或请联系技术支持。 400 VPS.0003 Invalid parameters. 空间定位算法服务请求参数不正确。
检查移动设备后置摄像头是否能正常拍摄画面。 无法进行视觉定位原因排查 如果您无法进行视觉定位，建议您排查以下问题： 检查是否竖屏正向手持设备。 侦听事件“LANDSCAPE_BY_ROLL”检查当前屏幕是否竖屏。 侦听事件“ORIENTATION_NORMAL”检查屏幕正向状态。 验证视觉定位效果时，您需竖屏正向手持设备扫描周边环境。
在数据列表选择注册成功的数据，单击操作列下的“注册调整”，在“注册调整”弹窗内核对地图注册结果。 如对注册结果不满意，可手动调整注册结果的坐标位置及角度。 图1 注册调整 单击“确定”进行地图生成阶段。 地图生产完成后，“地图生成”列显示为“生成成功”。 父主题： AR地图生产服务和AR地图运行服务使用指南
息 }); 进行视觉定位。 通过设置AR会话状态（hwar.setARStatus）或者触发手动定位（hwar.requestVps）发送定位请求，定位成功结果通过回调函数返回。 // 触发手动定位请求 hwar.requestVps(); // 设置定位成功回调函数 hwar
开启AR会话。 获取图像及传感器数据，初始化SLAM，准备相关环境。 实现AR导航和渲染3D内容。 依靠视觉定位，获取当前设备位置，以及请求导航路径，实现空间位置追踪导航；开发者基于SDK输出的图像数据、相机矩阵、路径信息，实现3D数字内容渲染。 父主题： WebARSDK使用手册
AR地图生产和AR地图运行服务面向文博旅、商圈等行业提供视觉定位和AR导航能力。 表1 应用场景 应用场景 场景描述 KooMap提供服务 文博旅 景区、展厅等场景的AR导航导览、AR地标打卡等。 为场景路线引导提供厘米级高精度视觉定位和AR导航能力。 商圈 商品、展品等内容的数字化信息
setIsSaveLog(true) 设置日志存储为“true”，打印日志的同时会写入日志文件到手机（仅Android支持，iOS暂不支持）。 设置日志存储为“false”，不写入日志文件到手机。 设置日志打印级别 XRClient.setLogOutputLevel(1) 日志级别包括：0（不输出）、1
KooMap服务可应用于哪些场景 KooMap AR地图生产和运行服务面向文旅文博、商圈、展厅等行业提供业界先进的视觉定位以及AR导航能力。 父主题： 服务咨询
云地图服务接口的分类与说明如表1所示。 表1 API概览 类型 说明 视觉定位 通过拍摄一系列具有已知位置的图像并分析它们的关键视觉特征（例如建筑物或桥梁的轮廓）来创建地图，以创建这些视觉特征的大规模且可快速搜索的索引。将设备图像中的特征与索引中的特征进行比较，可获得目标设备的位姿。 AR导航 基于摄像头实时捕捉的
常见问题 定位失败，定位结果显示“Incorrect IAM” 定位失败，定位结果显示“OutOfService” 定位失败，定位结果显示“invalid url” 定位后报错，日志显示“Cannot read properties of undefined（reading ‘position‘）”
）是提供空间处理、计算、可视、虚实交互等一站式开箱即用的云服务，赋能客户虚实融合互动的应用创新。 您可以使用本文档提供的API对云地图服务进行相关操作，如空间定位、空间导航。支持的全部操作请参见API概览。 在调用KooMap API之前，请确保已经充分了解KooMap相关概念，详细信息请参见云地图服务的《产品介绍》。
、HTGvps（定位功能）。 配置完成后，启动当前场景，自动获取状态信息，开启视觉定位和加载数字资源： 视觉定位：自动定位和手动定位。 自动定位： 系统默认开启自动定位功能。在定位丢失状态下，每隔1秒刷新一次定位，直到成功。定位成功状态下，每隔15秒刷新一次定位。您可根据实际需求设置刷新时间。
导航服务请求体，包含了用于导航的起始位置、终点位置和地区UTM编码。 约束限制： 不涉及。 表3 payload 参数 是否必选 参数类型 描述 from 是 from object 参数解释： 起始位置，包含坐标信息。 约束限制： 不涉及。 to 是 to object 参数解释： 终点位置，包含坐标信息。
API列表 调用前准备工作 视觉定位 事件 日志 其他 父主题： XRLightSDK使用手册
API 空间定位 空间导航
isual Studio。 准备iOS环境，安装Xcode。 准备Android环境，安装Android Studio。 如果您需要在华为手机上使用SDK，请咨询华为云专业服务团队。 父主题： HTSDK使用手册
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
