# 使用普通相机视频建图

完成扫描数据配置后，01Spatial 会把普通相机视频转化为可用于定位、内容编辑和 AR 发布的空间地图。建图在云端运行，关闭页面不会中断任务。

## 建图过程中发生什么

系统会从视频中选择清晰、连续且覆盖充分的画面，生成统一的空间地图，并应用配置阶段确定的真实大小、原点和方向。之后，01Spatial 会检查空间是否连续、目标区域是否被覆盖，以及定位所需文件是否完整。

通过检查的结果会成为 Space Studio、定位 API 和 AR 客户端可直接使用的地图。输入或约束不足时，任务会明确失败并给出原因，不会发布一张看似完成却无法可靠定位的地图。

## 启动建图

如果使用 Map Configurator，请完成页面中的必填检查，然后选择 **Build**。

如果视频中拍到了合格的 [01Spatial 空间基准板](/tutorials/mapping/panorama-camera-video/spatial-reference-board)，并且解析报告确认观测质量通过，地图卡片会提供 **Build with ChArUco**。空间基准板自动建图与 Map Configurator 手工 GCP 配置二选一，不要混合提交两套坐标定义。

> **GCP** 是 **Ground Control Point（地面控制点）** 的缩写，表示现场坐标已知、可在多个画面中准确确认的固定点。

## 理解地图状态

| 状态 | 含义 | 你需要做什么 |
| --- | --- | --- |
| 排队中 | 等待可用建图资源 | 保持地图与源文件不变，稍后查看进度 |
| 建图中 | 正在生成地图和定位资产 | 不要重复启动；可以离开页面后再返回 |
| 已就绪 | 地图和定位资产已通过自动检查 | 在 Space Studio 中进行现场定位测试 |
| 失败 | 输入、覆盖、配置或输出未通过检查 | 阅读失败原因，修正后重新建图 |

## 就绪后验证定位

**已就绪**表示自动检查通过，不代表真实使用场景已经验收。发布前[使用 Space Studio 执行定位测试](/tutorials/localization/space-studio-test)，确认：

- 路线起点、中部和终点都能成功定位；
- 门口、转角和跨房间位置不会跳到错误区域；
- 用户正常持机高度和方向下能够定位；
- 预期照明条件下表现稳定；
- 测试内容的位置、方向与距离正确。

## 失败时如何处理

### 区域未连接

检查门口、转角和走廊是否从多个方向连续拍摄。如果相邻区域的画面中确实能看到同一个固定角点，可以添加 Tie Point；如果完全没有重叠画面，则必须重新扫描。

### 画面质量或覆盖不足

回看原视频，检查运动模糊、弱光、长时间对着白墙或玻璃、快速转动以及移动人群。针对根因改善光线、速度或路线后重新扫描。

### GCP 或 Scale Bar 误差过大

核对单位、WORLD UP、XYZ 数值和每个观测的物理位置。不要添加更多不准确的点来抵消错误。

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

在 Space Studio 中记录失败区域、持机方向和光照。局部失败通常需要补充该区域的视角覆盖；全局位置或大小不正确时优先检查 GCP 坐标。

## 重建与源视频变更

可以修正 GCP、Tie Point 或 Scale Bar 后重新建图。若要更换视频或重新解析，请创建一张新地图，避免新的输入意外替换正在使用的地图。