1.
加载图层树:查询标注图层(文件夹)列表 (GET /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-groups)。
2.
创建图层:创建标注图层(文件夹) (POST /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-groups)。父图层锁定时返回 211007。
3.
改名 / 重排:更新标注图层(改名 / 重排) (PUT /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-groups/{group_id})。当 orders 非空时执行批量排序,name 字段被忽略;Share/Default/VisualCone 不允许改名(211002)。
4.
批量移动 / 重排:移动 / 重排图层与要素 (POST /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-groups/move)。要素移到根目录返回 211003;Default/Share 不可移到其他目录(211002);VisualCone 不可移动(211011)。
5.
锁定:锁定 / 解锁标注图层 (PUT /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-groups/{group_id}/lock-status)。
6.
分发:分发标注图层到设备端 (POST /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-groups/{group_id}/distribution)。
取消:取消分发标注图层 (POST /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-groups/{group_id}/undistribution)。
7.
单个:删除单个标注图层(文件夹) (DELETE /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-groups/{group_id}) — 级联删除子图层和要素;锁定状态拒绝(211403);Share/Default/VisualCone 不允许删除(211002)。
批量:批量删除标注图层 / 要素 (DELETE /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-groups) — 一次删多图层 / 要素,逻辑同上。
1.
创建:在指定图层下创建标注要素 (POST /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-groups/{group_id}/elements)。
2.
批量导入:批量导入图层及标注(KML 风格 JSON) (POST /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-groups/elements) — 请求体为 KML 风格的 JSON,不是 KML XML 文件。
3.
导出:导出图层组下要素(KML 风格 JSON) (GET /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-groups/elements) — 按 group_id 列表导出。
4.
更新:更新标注要素(改名 / 改坐标 / 改样式 / 改顺序) (PUT /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/elements/{id}) — 所有字段可选;content 按 JSON merge patch 合并,不是整段替换。
5.
显隐:批量修改图层下要素的显示状态 (PUT /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-groups/{group_id}/elements/status) — 把指定图层及其子图层下所有未锁定要素统一改为显示 / 隐藏。
6.
删除:单要素 DELETE /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/elements/{id};图层清空 DELETE /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-groups/{group_id}/elements。
1.
拿 STS:公共基础教程 → 项目级文件直传 STS 凭证。
3.
注册:注册自定义点位图标 (POST /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-icons)。
4.
查询:查询项目自定义点位图标库 (GET /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-icons) — 返回签名 URL。
5.
删除:删除自定义点位图标 (DELETE /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/element-icons/{icon_id})。
1.
列表:查询项目下的飞行区域列表 (GET /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/flight-areas) — 支持按名称、类型、状态过滤 + 分页。
2.
创建:创建飞行区域 (POST /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/flight-areas)。
3.
更新:更新飞行区域 (PUT /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/flight-areas/{id}) — 用 area_hash 做乐观锁冲突检测。
4.
删除:删除飞行区域 (DELETE /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/flight-areas/{id})。
5.
配置同步:触发飞行区配置同步到设备 (POST /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/flight-areas/upload)。
1.
配置清单 + 启动:配置项目离线地图清单(启动新一次更新) (POST /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/offline-maps)。
2.
轮询进度:获取项目离线地图详情 (GET /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/offline-maps) — 查询 2D / 3D 模型列表、转换进度百分比、状态。spec 中 GET 响应将状态枚举为 unknown / processing / success / failed;后端实际状态机更细(waiting / processing / finish / fail / cancel / timeout),调用方按 GET 返回值字段做客户端判定即可。
3.
同步到机库:触发离线地图包同步到机库 (POST /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/offline-maps/packages) — 需先用配置接口配置后再触发。
4.
取下载 URL:获取离线地图地表模型下载 URL (GET /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/offline-maps/url) — 按 Dock SN 返回对象存储签名下载 URL。若该 dock 尚未配置离线地图,data 包含 disable: true。
5.
取消:取消离线地图模型更新 (DELETE /openapi/v2.0/map/api/v1/workspaces/{workspace_id}/offline-maps) — 后端 CancelUpdateModel 仅在模型处于失败态时允许取消,其他状态会以 ErrCannotCancelUpdateModel 拒绝;调用前请先 GET 当前状态。