# 管理地图

**Spatial Maps** 是地图的管理入口。你可以在这里创建地图、上传扫描数据、查看建图进度，并在地图就绪后打开 Space Studio、移动或转让地图。

## 新建地图

1. 打开 Portal，进入 **Spatial Maps**。
2. 在左侧选择目标 Project；如果还没有合适的 Project，请先新建一个。
3. 选择 **+ New Map**。新地图会以 **New Map** 出现在当前 Project 中，并自动进入重命名状态。
4. 输入清晰、可长期识别的名称，例如建筑、楼层和区域：`总部 · 2F · 展厅`。
5. 选择与源数据一致的输入类型，再按对应扫描文档上传数据。

同一 Project 中已有尚未提交的地图时，**+ New Map** 会暂时不可用。请先提交或删除这张未完成的地图，避免多个空地图造成混淆。

[![Spatial Maps 页面，左侧为 Project 列表，右侧 Maps 标题旁提供 New Map 按钮](/media/docs/spatial-maps-project-new-map.real-ui.jpg)](/media/docs/spatial-maps-project-new-map.real-ui.jpg)

## 读懂地图卡片

地图卡片的顶部始终显示地图 ID、名称和当前状态。地图 ID 是系统内稳定的数字标识；名称可以修改，但地图 ID 不会改变。

### 新建状态

状态为 **Created（已创建）** 时，卡片用于选择输入类型和上传来源：

- **输入类型**决定 Portal 如何校验和解析数据。普通视频、360° 视频、移动端三维扫描和各类 LiDAR 数据不能混用入口。
- **Local** 从当前电脑上传文件；上传期间需要保持页面打开。
- **Cloud（推荐用于大文件）** 让服务器从当前界面支持的网盘下载文件，浏览器无需承担整段大文件传输。
- **Upload / Download from Cloud / Build** 是提交当前数据的主操作；按钮名称会随输入类型和上传来源变化。
- 右上角的关闭按钮删除这张尚未提交的地图及其暂存数据。

[![Created 状态的地图卡片，包含输入类型、Local 与 Cloud 上传来源以及主操作按钮](/media/docs/spatial-maps-map-card-created.real-ui.jpg)](/media/docs/spatial-maps-map-card-created.real-ui.jpg)

### 解析与配置状态

视频上传后会先进入 **Parsing（解析中）**，Portal 正在抽取适合建图的画面并检查空间基准板。解析完成后进入 **Parsed（已解析）**：

- 画面数量表示本次扫描中进入后续流程的视频帧数。
- 空间基准板检查结果说明能否直接使用板上约束建图。
- **Configure** 打开 Map Configurator，用 GCP（Ground Control Point，地面控制点）、Tie Point（连接点）和 Scale Bar（距离标尺）完成坐标、真实大小与画面连接配置。
- 检测到质量合格的空间基准板时，可以选择 **使用 ChArUco 建图**；否则应先完成手动配置。

### 排队与建图状态

- **Pending（排队中）**：任务已提交。卡片会显示前方任务数量；此时可以取消任务，但不能修改源数据。
- **Building（构建中）**：进度条显示服务器报告的整体进度。取消会终止本次建图并使地图回到可编辑状态，已完成的进度不会保留。
- **Failed（失败）**：地图未形成可用结果。普通用户可以按卡片提示重新解析或重建；如果错误重复出现，请保留地图 ID 和失败时间后联系支持。

[![Building 状态的地图卡片，显示当前进度和取消操作](/media/docs/spatial-maps-map-card-building.real-ui.jpg)](/media/docs/spatial-maps-map-card-building.real-ui.jpg)

### Ready 状态

**Ready（已就绪）** 表示地图和定位资产已经生成。卡片中的字段含义如下：

[![Ready 状态的地图卡片，显示地图参数、Map Key 和可用操作](/media/docs/spatial-maps-map-card-ready.real-ui.jpg)](/media/docs/spatial-maps-map-card-ready.real-ui.jpg)

| 字段 | 含义 |
| --- | --- |
| **Type** | 本次建图使用的建图方式。 |
| **Input** | 创建地图时选择的源数据类型。 |
| **Images** | 实际进入地图的图像数量；它不是视频总帧数或扫描仪原始照片总数。 |
| **Pipeline** | 构建该地图的软件管线版本，排查问题时应一并提供。 |
| **Creator** | 最初创建地图的用户 ID；转让地图不会改写这一历史信息。 |
| **Created** | 地图首次创建的时间。 |
| **Map Key** | 客户端定位到这张地图时使用的地图凭证。使用 **Copy** 复制，避免手工抄写。 |

顶部的 **Online / Offline** 表示地图当前是否可由在线服务使用；免费托管剩余天数会显示在同一位置。**Analytics** 用于记录和回放定位会话；开启后还可以选择定位图片的保留时长并查看记录数与占用空间。

Ready 卡片的主要操作：

- **Open**：在新标签页打开 Space Studio。
- **Configure**：重新查看或调整支持配置的扫描约束。更改后应按界面提示重新建图。
- **Move**：把地图移动到当前账号的另一个 Project。
- **Transfer**：邀请另一个 01Spatial 用户接收地图所有权和后续托管责任。
- **Delete**：永久删除地图。删除不可撤销，执行前请确认不再需要源数据、地图和 Content。

索引构建或几何处理进行时，部分按钮会暂时锁定；等待任务完成后再操作。

## Move：在自己的 Project 之间整理地图

**Move** 只改变地图位于哪个 Project，不改变地图 ID、所有者、Map Key、Content 或计费归属。

1. 在地图卡片上选择 **Move**。
2. 选择当前账号拥有的另一个 Project。
3. 确认后，地图立即从原 Project 移到目标 Project。

[![Move Map 对话框，要求选择当前账号中的目标 Project](/media/docs/spatial-maps-move-dialog.real-ui.jpg)](/media/docs/spatial-maps-move-dialog.real-ui.jpg)

Ready 地图被移动后，系统会在后台更新原 Project 和目标 Project 的多地图定位数据。地图本身仍可使用，但 Project 级定位应等待界面显示更新完成。

如果一张刚接收的地图从 **Received Maps** 移走，并且该分组已经为空，系统会自动移除空的 **Received Maps** 分组。

## Transfer：把地图转让给另一个用户

Transfer 不是立即移动，也不是共享只读链接，而是一次需要接收方确认的所有权转让。

### 发送者会看到什么

1. 在状态允许转让的地图卡片上选择 **Transfer**。
2. 输入接收方的 **User ID**，确认创建邀请。
3. 邀请在 72 小时内有效。接收方处理前，地图仍位于发送者账号中，所有权、在线状态和费用都不变。
4. 对同一地图重新发出邀请时，之前尚未处理的邀请会失效。

[![Transfer Map 对话框，要求输入接收者 User ID，并说明 72 小时邀请和计费归属](/media/docs/spatial-maps-transfer-dialog.real-ui.jpg)](/media/docs/spatial-maps-transfer-dialog.real-ui.jpg)

地图正在建图、删除、归档或存在尚未结算的建图任务时不能转让。接收方拒绝或邀请过期后，地图和费用仍完全属于发送者。

### 接收者会看到什么

1. 接收者在 Portal 的账单页面看到 **待接收地图邀请**，其中包含地图名称、发送者、邀请到期时间以及预计的热存储和归档托管费用。
2. 选择 **Reject** 不会改变任何地图归属。
3. 选择 **Accept** 后，系统会同时切换所有者、未来托管费用和 Project 归属；不会出现只转移其中一部分的中间状态。
4. 地图会进入接收者账号下的 **Received Maps**；接收者随后可以使用 **Move** 把它整理到自己的其他 Project。

接受后产生的未来托管费用由接收者承担，接受前已经产生的历史费用仍由发送者承担。Free 账号如果已经达到可持有地图上限，或账号当前不可计费，将无法接受邀请。

## 下一步

- 要查看点云、Mesh 和建图相机，请继续阅读[探索地图](/tutorials/maps/explore)。
- 要在地图坐标中放置 3D 内容，请继续阅读[添加内容](/tutorials/maps/add-content)。