跳到主要内容

采集并保存地图

建图通过持久化任务完成。结束采集后还需要等待地图保存和校验，才能用于后续导航。

1. 准备环境​

确认导航环境停止，按照交付配置准备扫描和运动依赖。查询现有地图，选择一个符合 地图名称规则 的新名称。

2. 启动建图​

调用 POST /v1/api/mapping/container/start：

{"scene_name":"office_1f"}

保存返回的 task_id。接口最多会进行约 5 秒的快速失败检查；后续过程仍由后台任务执行。详见 建图 API。

3. 观察采集状态​

调用 POST /v1/api/mapping/status，不发送请求体。检查 status、perceptions_available 和 map_available。mapping/health 成功仅表示内部 API 健康，不代表已经有效采集。

按照现场建图操作流程完成环境采集。

4. 结束并等待保存​

调用 POST /v1/api/mapping/container/stop，不发送请求体。返回成功表示结束请求已受理。

继续查询 GET /v1/api/tasks/{task_id}：

  • Status=2：任务成功完成。
  • Status=3：任务失败，检查 ErrorMsg 和 ResultJSON。
  • 尚未终结或恢复状态不明：继续确认，避免重复启动。

应使用建图结束接口完成保存流程，直接停止普通容器不能替代该流程。

5. 验证产物​

查询地图列表及地图文件。启用内容版本管理时，同时核对保存结果中的版本标识。文件保存或安装成功不代表导航容器已经加载该地图。

下一步：准备导航，或查阅 地图导入、文件与内容同步。