Machine-readable: manifest · index · 简体中文 Markdown

使用全景视频建图

当扫描数据、真实大小和坐标基准准备完成后，01Spatial 会将全景视频转化为可用于定位、内容编辑和 AR 发布的空间地图。整个过程在云端完成，关闭页面不会中断任务。

建图过程中发生什么

系统会根据视频中的连续视角生成一张统一的空间地图，并应用配置阶段提供的真实大小、原点和坐标方向。随后，01Spatial 会检查地图是否连续、是否覆盖目标区域，以及定位所需文件是否完整。

通过检查的结果会被整理为可直接用于 Space Studio、定位 API 和 AR 客户端的地图文件。若视频质量、扫描覆盖或真实大小与坐标基准不足以形成可靠结果，任务会失败并显示具体原因和下一步处理建议，而不会发布一张无法可靠定位的地图。

启动建图

如果使用 Map Configurator 手工配置，请完成页面中的所有必填检查，然后选择 Build。Portal 会将地图状态更新为排队中或建图中。

如果视频中放置了 01Spatial 空间基准板，并且解析报告确认观测质量满足要求，地图卡片会提供 Build with ChArUco。

空间基准板自动建图与 Map Configurator 手工 GCP 配置二选一，不要把两套坐标约束混合提交。GCP 是 Ground Control Point（地面控制点）的缩写，表示现场坐标已知、可在多个画面中准确确认的固定点。

理解地图状态

完成时间取决于视频长度、抽取帧数、空间规模和服务器队列。不要用页面是否持续打开来判断任务是否继续；状态由服务器保存。

就绪后必须验证定位

已就绪表示自动健康检查通过，不等于每个真实使用场景都已经验收。在发布 AR 内容前，使用 Space Studio 执行定位测试，并用目标设备或代表性照片验证：

• 起点、终点和路线中部都能成功定位。
• 门口、转角、跨房间等连接位置不会跳到错误区域。
• 用户正常持机高度和方向下能够定位，而不只是在建图相机高度有效。
• 预期的白天、夜间或人工照明条件下表现符合项目要求。
• 放置在地图中的测试内容出现在预期位置，并且方向与距离正确。

如果某个区域不稳定，先判断是覆盖不足、画面模糊、连接薄弱还是坐标约束错误，再针对根因修改；不要只重复提交同一份输入。

失败时如何处理

区域未连接

检查门口、转角和长走廊是否从两个方向重复经过。如果相邻区域的画面确实包含同一个固定角点，可以添加准确的 Tie Point；如果两侧画面没有任何共同可见区域，则必须重新扫描，Tie Point 无法补回没有拍到的内容。

画面质量或覆盖不足

常见原因是运动模糊、弱光、大片白墙/玻璃或移动人群。回看导出视频，改善光线、降低行走速度或调整路线后重新采集。

GCP 或 Scale Bar 误差过大

核对单位是否为米、WORLD UP 是否正确、XYZ 是否抄录错误，并逐帧检查标记是否落在同一个物理角点。不要通过添加更多不准确的 GCP 来试图抵消误差。

建图完成但现场定位不稳定

用 Space Studio 测试失败区域，并记录测试设备、持机方向、光照和原始测试图片。若只有特定区域失败，通常需要补充该区域的视角覆盖；若整张地图的位置或大小不正确，优先检查 GCP 坐标系。

重建与源视频变更

一次建图使用的是当前视频解析得到的固定画面集合。你可以修改 GCP、Tie Point 或 Scale Bar 后重新建图；如果要更换视频或重新解析扫描数据，请创建一张新地图，以免替换正在被应用使用的地图和定位文件。