1. 地图
【私有化】司空 2 OpenAPI V2.0
  • 调用指南
    • 认证鉴权教程
    • 错误码
    • 请求结构
    • 返回结果
    • 公共参数
  • 公共基础
    • 公共基础教程
    • 系统健康与接入
      • DRC 服务健康检查
    • 接入与授权
      • STS 凭证
        • 获取业务模块定制 STS 凭证
        • 获取项目级文件直传 STS 凭证
        • 获取飞行记录上传 STS 凭证
    • 安全
      • 解密飞行记录中的设备序列号(SN)
  • 组织与项目
    • 组织与项目教程
    • 项目管理
      • 项目配置
        • 获取项目自动录制配置
        • 配置项目自动录制规则
      • 项目基础信息
        • 创建项目
        • 更新项目信息
        • 获取项目详情
        • 删除项目
      • 快速加入
        • 查询快速加入项目信息
        • 通过快速加入码加入项目
    • 组织管理
      • 查询组织项目列表
      • 更新当前用户订阅设置
      • 获取组织详情
      • 更新组织信息
    • 成员与权限管理
      • 角色与权限
        • 获取项目权限树定义
        • 查询组织内项目角色列表
        • 批量创建项目级自定义角色
        • 查询角色权限映射 (角色 ID → 权限列表)
        • 删除组织自定义角色
        • 更新自定义角色
      • 组织成员
        • 批量移除组织成员
        • 查询组织成员列表
        • 批量添加组织成员
        • 批量更新组织成员信息
        • 查询当前用户在该组织内的身份与配置
        • 更新当前用户的组织呼号
        • 当前用户退出组织
      • 项目成员
        • 获取项目团队成员(在线)
        • 获取项目用户列表
        • 更新当前用户的项目呼号
  • 设备管理
    • 设备管理教程
    • 设备配置
      • HMS 事件
        • 获取组织设备 HMS 事件列表
        • 更新组织设备 HMS 已读时间
        • 更新项目设备 HMS 已读时间
        • 批量获取项目设备 HMS 事件
      • 设备影子
        • 更新组织设备影子配置
        • 更新项目设备影子配置
        • 查询组织设备物模型属性当前值
      • 通用配置指令
        • 对组织设备下发自定义指令(通用 cmds 通道)
        • 查询组织设备指令执行进度
        • 批量查询组织设备指令执行进度
        • 对项目内设备下发指令
      • 网络管理
        • 查询设备当前 NTP 服务器配置
        • 启动设备网络速度检测任务
        • 查询设备网络测速任务结果
        • 查询机库网络配置
        • 检测机库网络连接
        • 查询 4G 模组 APN 配置
      • RTK 配置
        • 查询设备的 RTK 网络账号信息
        • 自定义网络 RTK 标定
      • 对频管理
        • 查询设备对频信息
        • 设备对频指令下发
        • 查询中继扫描结果
        • 查询中继非配对连接结果
        • 查询配对请求结果
      • SIM 卡管理
        • 查询设备 SIM 卡套餐与流量信息
      • 项目设备配置
        • 修改项目设备配置参数
        • 获取项目设备配置
    • 设备列表管理
      • 项目设备列表
        • 修改组织设备的当前工作项目
        • 获取项目设备列表
        • 获取项目内单个设备详情
        • 修改项目内设备项目呼号
        • 获取项目历史拓扑设备列表
        • 获取项目设备物模型
      • 组织设备列表
        • 查询组织设备简表
        • 批量修改组织设备呼号
        • 修改单个组织设备呼号
        • 批量移除组织设备
        • 查询组织设备运维列表
        • 查询组织内某类设备的机型主键列表
        • 查询组织设备在线工作配额
  • 实时控制
    • 实时控制教程
    • 飞行控制指令
      • 实时指令
        • 查询项目内设备命令执行进度
        • 下发飞行控制指令
      • 空中任务
        • 创建空中下发航线任务
        • 控制航线任务(暂停 / 继续 / 取消)
      • 指点飞行
        • 获取飞行任务的设备推荐结果
        • 飞向目标点(一键起飞)
        • 发起飞向多目标点任务
        • 更新进行中的飞向目标点任务
        • 结束飞向目标点任务
      • 智能环绕
        • 进入 POI 环绕模式
        • 退出 POI 环绕模式
        • 更新 POI 环绕速度
        • 查询 POI 任务状态
      • 接力任务
        • 创建接力任务(双机轮转)
        • 计算接力任务的最佳接力位置
        • 编辑接力任务配置
        • 触发接力机主动起飞
        • 更新接力任务运行状态(暂停 / 恢复 / 取消)
        • 主动切换接力任务的执行机
    • 控制权管理
      • 设备控制权
        • 设备控制权操作(组织设备运维)
        • 查询设备控制权状态(组织设备运维)
        • 获取(占用)云控角色
        • 查询项目设备控制权状态
        • 查询设备最近正在操作的项目内用户列表
        • 设备控制权操作
      • 云控权限
        • 申请云控授权(向遥控器发起)
        • 批量查询飞行器云控权状态
        • 获取(占用)云控权限
        • 释放云控权限
    • 负载控制
      • 相机控制
        • 下发负载控制指令
      • PSDK 设备
        • 下发 PSDK 指令
      • 喊话器
        • 打开飞行器双向语音通道
        • 打开 DRC 实时控制通道
        • 查询喊话器资源列表
        • 创建喊话器资源
        • 删除喊话器资源
        • 编辑喊话器资源
        • 获取喊话器音频上传 STS 凭证
    • 起降协调
      • 查询起降协调区(TCA)实时状态
  • 飞行任务
    • 飞行任务教程
    • 任务查询
      • 获取当前活动航线任务(DRC 实时控制)
      • 获取当前活动航线任务(任务管理)
      • 按 UUID 批量查询飞行任务详情
      • 查询飞行任务时间冲突列表
      • 获取飞行任务详细信息(V2,含执行明细)
      • 查询机场最近 / 当前任务
      • 获取任务飞行轨迹(V2)
    • 飞行记录
      • 导出与下载
        • 飞行记录文件下载
        • 查询飞行任务导出历史
        • 导出飞行任务记录(生成 zip 异步任务)
        • 取消 / 删除导出任务
      • 操作日志
        • 查询飞行任务操作日志(V2)
    • 任务管理
      • 创建飞行任务
      • 创建飞行任务(高级版,返回子任务)
      • 检查飞行任务是否满足下发条件
      • 标记任务为已读状态
      • 检查飞行任务阻飞项
      • 支持断点续飞的立即任务
      • 删除飞行任务
      • 编辑飞行任务
      • 获取飞行任务详情
      • 下发任务媒体优先上传指令
      • 创建续飞任务(保留原断点)
      • 更新飞行任务挂起状态(挂起 / 解除挂起 / 取消)
      • 查询飞行任务列表
    • AI 飞行告警
      • 按设备 SN 查询有 AI 告警的飞行架次列表
      • 查询历史 AI 告警记录
  • 航线
    • 航线教程
    • 下载与上传
      • 打包资源到 KMZ(精准复拍流程)
      • 查询航线异步导入状态
      • 保存航线时 KMZ 上传完成回调
      • 航线 KMZ 文件导入回调
      • 批量下载航线 / 文件夹(打包 zip)
    • 航线列表管理
      • 获取航线 KMZ 下载 URL 并 302 重定向
      • 复制航线
      • 收藏航线 / 媒体资源
      • 取消收藏航线 / 媒体资源
      • 多航线拼接为一条
      • 航线库文件列表查询(V1)
      • 删除指定航线(默认软删进回收站)
      • 更新航线元信息(改名 / 锁定 / 恢复回收站)
      • 获取单条航线详情
    • 航线文件 CRUD
      • 创建航线文件夹
      • 批量删除航线 / 文件夹
      • 批量移动航线 / 文件夹到目标文件夹
      • 批量更新航线 / 文件夹锁定状态
  • 地图
    • 地图教程
    • 地图标注
      • 标注图层管理
        • 移动 / 重排图层与要素
        • 删除单个标注图层(文件夹)
        • 更新标注图层(改名 / 重排)
        • 分发标注图层到设备端
        • 锁定 / 解锁标注图层
        • 取消分发标注图层
        • 批量删除标注图层 / 要素
        • 创建标注图层(文件夹)
        • 查询标注图层(文件夹)列表
      • 标注要素管理
        • 批量修改图层下要素的显示状态
        • 清空指定图层下的所有标注要素
        • 在指定图层下创建标注要素
        • 批量导入图层及标注(KML 风格 JSON)
        • 导出图层组下要素(KML 风格 JSON)
        • 删除单个标注要素
        • 更新标注要素(改名 / 改坐标 / 改样式 / 改顺序)
      • 自定义图标
        • 查询项目自定义点位图标库
        • 注册自定义点位图标
        • 删除自定义点位图标
    • 信号热力图
      • 查询组织级信号热力图
      • 查询项目级信号热力图
    • 空域安全
      • 自定义飞行区
        • 查询项目下的飞行区域列表
        • 创建飞行区域
        • 触发飞行区配置同步到设备
        • 删除飞行区域
        • 更新飞行区域
    • 离线地图
      • 获取离线地图地表模型下载 URL
      • 触发离线地图包同步到机库
      • 获取项目离线地图详情
      • 配置项目离线地图清单(启动新一次更新)
      • 取消离线地图模型更新
  • 直播
    • 直播教程
    • 直播分享与转发
      • 旁路推流
        • 创建 / 开启 / 关闭 / 更新码流转发器
        • 查询当前组织的旁路转码器列表
        • 停止并删除指定旁路转码器(C2C 直播旁路)
      • 直播分享
        • 获取设备直播分享详情
        • 查询项目下所有直播分享链接
    • 直播推流
      • 项目维度
        • 启动直播流(项目维度)
        • 更新观众 Token(项目维度
        • 切换镜头(项目维度)
        • 切换直播相机(项目维度)
        • 上报观众加入直播房间状态(项目维度)
        • 停止直播流(项目维度)
        • 设置直播质量(项目维度,飞行器源端推流档位)
        • 查询设备直播与录制状态(项目维度)
      • 组织维度
        • 停止直播流(组织维度)
        • 设置直播质量(组织维度,飞行器源端推流档位)
        • 上报观众加入直播房间状态(组织维度)
        • 启动直播流(组织维度)
        • 切换镜头(组织维度,同时控制飞行器源端硬件)
        • 更新观众 Token(组织维度)
        • 切换直播相机(组织维度)
    • 录制任务管理
      • 开始云端录制(项目维度)
      • 停止云端录制(项目维度)
      • 查询设备录制任务列表(项目维度)
      • 启动项目内直播流
      • 查询设备录制任务列表(组织维度)
      • 开始云端录制(组织维度)
      • 停止云端录制(组织维度)
      • 停止项目内直播录制
  • 媒体
    • 媒体教程
    • 飞行任务关联
      • 按 flight_id 查飞行任务媒体
      • 批量按 flight_ids 查飞行媒体
    • 文件统计与查询
      • 获取媒体文件计数(按文件夹粒度)
      • 获取媒体文件总数(项目全量)
      • 获取媒体资源文件(图 + 文件夹)
    • 媒体文件 CRUD
      • 批量设置媒体地图显示状态
      • 批量删除媒体文件 -进回收站
      • 创建媒体文件夹
      • 获取媒体文件列表
      • 媒体文件裁剪
      • 批量移动媒体文件
      • 删除单个媒体文件
      • 获取媒体文件详情
      • 更新媒体文件信息
      • 批量硬删媒体文件-不进回收站
    • 下载与上传
      • 快速上传媒体文件
      • 导入媒体文件
      • 检查新文件指纹存在状态
      • 涂鸦回调
      • 媒体上传完成回调
      • 检查 zip 打包任务状态
      • 打包媒体文件为 zip
      • 获取媒体文件下载 URL
    • 标签管理
      • 为媒体文件添加标签
      • 删除媒体文件标签
      • 获取项目下的媒体文件标签列表
  • 模型
    • 模型教程
    • 模型重建
      • 模型重建坐标系
      • 获取飞行任务文件夹列表 V2
      • 获取实时建图任务列表
      • 发起实时建图任务(Realtime2D)
      • 获取项目模型库默认设置
      • 发起后处理重建任务(Post 2D / 3D)
      • 获取后重建默认兴趣区域
      • 获取后重建质量报告下载链接
      • 后重建任务重试
      • 停止后重建任务
      • 模型上传完成回调(客户端调用,非 OSS 验签)
      • 查询可用于模型重建的航线列表
    • 模型库
      • 模型文件管理
        • 批量删除模型文件
        • 获取项目模型文件列表
        • 创建模型文件夹
        • 批量切换模型上图状态
        • 锁定 / 解锁模型文件
        • 批量移动模型文件
        • 组织内模型共享
        • 获取模型文件总数
        • 删除单个模型文件
        • 获取模型文件详情
        • 更新模型基本信息
        • 获取模型文件下载 URL
        • 发起模型格式 / 坐标系转换任务
        • 获取项目可用的坐标系(WKT)列表
      • 地图展示
        • 批量设置实时建图模型的地形加载状态
        • 调整实时建图模型展示顺序(拖拽排序)
        • 更新建图任务元属性(改名 / 显隐 / 分发 / 取消分发 / 切换地形)
        • 获取地图页模型图层列表
        • 批量切换地图模型图层属性
        • 调整地图模型图层叠加顺序
  • 开放建模
    • 开放建模教程
    • 错误码
    • 更新日志
    • 算法参数介绍
    • 获取正在重建中的模型详情
    • 获取资源详情
    • 删除资源
    • 获取上传凭证
    • 开始重建任务
    • 上传回调
    • 停止重建任务
    • 获取模型详情
    • 删除模型
  • 回收站
    • 回收站教程
    • 单条硬删媒体文件
    • 从回收站恢复文件
    • 永久删除回收站文件
    • 获取媒体回收站文件列表
    • 修改媒体回收站配置
    • 获取媒体回收站配置
    • 获取模型库回收站磁盘统计
    • 获取媒体回收站磁盘统计
  • 高级能力
    • 高级能力教程
    • 变化检测
      • 媒体变化检测
        • 发起媒体找不同任务
        • 查询媒体找不同任务列表
        • 删除找不同任务
        • 修改找不同任务名称等属性
        • 获取找不同任务详情
        • 评价找不同任务
        • 批量修改找不同结果状态
        • 删除变化区域
        • 添加变化区域(人工标注)
        • 更新变化区域属性
        • 获取媒体上传 STS 凭证
        • 媒体找不同任务预检
        • 查看找不同检测报告
        • 获取照片组 AI 找不同结果列表
        • 获取结果组中的变化区域详情
      • 模型变化检测
        • 发起模型对比任务(找不同)
        • 查询模型对比任务列表
        • 修改模型对比任务名称等属性
        • 获取模型对比任务结果详情
        • 删除模型对比任务
        • 批量更新模型对比差异
        • 删除模型对比差异
        • 添加模型对比差异(人工标注)
        • 更新模型对比单个差异详情
        • 获取模型对比检测报告
        • 查询适合做模型对比的候选模型
        • 评价模型对比任务
  • 数据模型
    • 默认目录
      • StsCredentials
      • ProjectShareLinkDetail
      • DrcStartStreamResp
      • PutWorkspacesWaylinesBatchDeleteResp
      • PutWorkspacesWaylinesLockStatusResp
      • GetWorkspacesOfflineMapsUrlResp
      • GetWorkspacesOfflineMapsResp
      • GetWorkspacesAirSenseWarningsResp
      • PostCommonWeatherReportResp
      • GetWorkspacesWebWaylinesResp
      • PostFlightTasksAdvancedReq
      • C0034_ListOrgUsers_Resp
      • C0038_GetProjectUserPermissionTree_Resp
      • C0030_ListProjectIndividuals_Resp
      • C0031_ListProjectUsers_Resp
      • C0095_Op_Resp
      • C0096_HMS_get_Resp
      • C0077_Op_get_Resp
      • C0058_Op_Resp
      • C0575_GetHistory_Resp
      • C0564_GetTopologies_Resp
      • C0580_GetInFlight_Resp
      • C0160_GetFlightTaskAdvanced_Resp
      • C0617_GetFlightTasks_Resp
      • StsResult
      • C0619_CreateBatchDownload_Resp
      • FlightOperationVO
      • FlightTask
      • C0253_get_convertersVolcList_Resp
      • User
      • C0587_CreateStreamsSwitch_Resp
      • C0589_GetTopologiesCmds_Resp
      • C0604_GetRecordDevice_Resp
      • C0607_GetRecordDevice_Resp
      • GetWorkspacesFilesCompareFilesResp
      • DeviceModelInfo
      • DeviceState_drone_other
      • DeviceState_ea210dock
      • Position
      • DeviceState_ea210drone
      • ProjectTeamGetDevicesRspItem
      • DeviceState_ea220dock
      • ProjectTeamGetDevicesRspItemBaseTopo
      • DeviceState_ea220drone
      • DeviceState_ea230dock
      • DeviceModelEnum
      • DeviceState_ea230drone
      • DeviceState_rc510
      • DeviceState_rc701
      • DeviceState_rc_other
      • DeviceState_wa345
      • DeviceState_wm265
      • StartStreamResp
      • Device
      • Project
      • ProjectTeamGetDevicesRsp
      • StatisticsInfo
      • ChunkedFile
      • Ancestor
      • MediaFileItem
      • GetOrganizationsDevicesResp
      • GetOrganizationsManageDevicesResp
      • PostWorkspacesFlightTasksDeviceRecommendationResp
      • GetWorkspacesFlightTasksInFlightResp
      • PutWorkspacesReconstructionsResp
      • PutWorkspacesFlightAreasResp
      • GetProjectFlightAreasUrlResp
      • PutProjectFlightAreasResp
      • GetProjectFlightAreasResp
      • PostModelReconstructPreCheckResp
      • GetWorkspacesReconWaylinesResp
      • GetModelListFlightFoldersResp
      • GetModelListFlightFoldersV2Resp
      • GetWorkspacesDriveStatisticsResp
      • GetWorkspacesFilesResp
      • GetWorkspacesFilesUrlResp
      • PostWorkspacesFilesPreviewCallbackResp
      • GetDiffMediaListResp
      • PostWorkspacesStsResp
      • GetDiffModelListResp
      • GetWorkspacesDriveStatisticsTrashResp
      • GetWorkspacesMapsModelsResp
      • GetWorkspacesStsResp
      • GetWorkspacesResourcesResp
      • PostWorkspacesResourcesResp
      • PutWorkspacesResourcesResp
      • Operation
      • Exception
      • FlightReplay
      • ListTaskWayline
      • FolderUploadInfo
      • Resp
      • TaskType
      • FlightTaskType
      • TaskStatus
      • MediaPosition
      • ApiEnvelope
      • UserContactInformation
      • LiveTokenResult
      • OrganizationIndustryType
      • OrganizationUnitsConfig
      • OrganizationGeoCagingConfig
      • OrganizationDeviceBindCode
      • ProjectWorkCenterPoint
      • CloudWeatherBlockingConfig
      • weatherBlocking
      • AirportWeatherStationBlockingConfig
      • ProjectShareConfig
      • ProjectFastJoin
      • DeviceControlOperationReq
      • DeviceControlOperationRsp
      • DeviceHmsInfo
      • DeviceShadowsDesired
      • ProjectTeamUpdateDeviceShadowReq
      • DeviceTopo
      • TopoGatewayDevice
      • TopoNodeDevice
      • TopoHostDevice
      • ActionType
      • TargetType
      • AiLinkHeartBeatRequest
      • AiLinkStartStreamRequest
      • ChangeCameraStreamParam
      • CommonStreamStruct
      • RecordTask
      • RecordTaskList
      • SetQualityParam
      • StartRecordParam
      • StartStreamParam
      • StopStreamParam
      • StreamRecordResp
      • StreamStateParam
      • UpdateWebTokenItem
      • UpdateWebTokenParam
      • ParentFileInfos
      • TagItem
      • TagListOutput
      • WaylineInfo
      • ZipCheckOutput
      • Organization
      • DeviceControlStatus
      • DeviceControlCollection
      • DevicePrePreemptiveQueue
      • UserExperienceImprovement
      • ServiceError
      • ProjectWeatherBlocking
      • ChangeLensStreamParam
      • PagyInfo
      • DriveStatisticsOutput
      • StreamGroup
      • MediaFileListOutput
      • GetOrganizationsManageDevicesDeviceModelKeyResp
      • PostCommonCloudControlFunctionResp
      • GetOrganizationsDevicesRtkAccountInfoResp
      • GetOrganizationsByUuidManageDevicesCmdsResp
      • PostWorkspacesFlightTasksDroneTakeOffResp
      • PostWorkspacesFlightTasksFlyToPointsResp
      • GetWorkspacesFlightTasksDefaultNameResp
      • PostProjectsFlightTasksInFlightWayLineTaskResp
      • GetWorkspacesFlightTasksPoiTaskResp
      • PostWorkspacesFlightTasksPoiEnterResp
      • PostWorkspacesFlightTasksRelayMissionsPositionsResp
      • PostWorkspacesFlightTasksRelayMissionsActiveTakeoffResp
      • PostProjectsRtChannelsResp
      • PostProjectsVoiceChannelsResp
      • DeleteProjectsShareLiveResp
      • PostWorkspacesElementGroupsElementsResp
      • DeleteWorkspacesElementsResp
      • PutWorkspacesElementsResp
      • DeleteWorkspacesByWorkspaceIdElementGroupsResp
      • DeleteWorkspacesElementGroupsElementsResp
      • PostWorkspacesElementGroupsResp
      • DeleteWorkspacesByWorkspaceIdElementGroupsByGroupIdResp
      • PutWorkspacesElementGroupsResp
      • PostWorkspacesElementGroupsUndistributionResp
      • PutWorkspacesElementGroupsElementsStatusResp
      • PutWorkspacesElementGroupsLockStatusResp
      • PostWorkspacesElementGroupsDistributionResp
      • PutWorkspacesWorkspaceIdMediasShowOnMapResp
      • GetWorkspacesReconstructionsResp
      • GetWorkspacesFlightAreasResp
      • PostWorkspacesFlightAreasResp
      • DeleteWorkspacesFlightAreasResp
      • DeleteProjectFlightAreasResp
      • PostProjectFlightAreasResp
      • PostWorkspacesUploadCallbackResp
      • GetWorkspacesDefaultSettingsResp
      • PostModelStartRebuildResp
      • GetWorkspacesReconstructionsInterestAreaResp
      • GetWorkspacesReconstructionsReportResp
      • PostWorkspacesFilesResp
      • DeleteWorkspacesByWorkspaceIdFilesResp
      • DeleteWorkspacesByWorkspaceIdFilesByIdResp
      • GetWorkspacesWktsResp
      • PostWorkspacesFilesMoveResp
      • GetWorkspacesFilesTilesListResp
      • PostDiffMediaStartResp
      • GetDiffMediaTaskIdGetDetailResp
      • DeleteDiffMediaTaskIdResp
      • GetDiffMediaTaskIdGetReportResp
      • GetWorkspacesByWorkspaceIdComparatorsByTaskUuidResultGroupsResp
      • GetWorkspacesByWorkspaceIdComparatorsByTaskUuidResultGroupsByResultUuidResp
      • PostWorkspacesComparatorsResultGroupsDiffDetailResp
      • DeleteWorkspacesComparatorsResultGroupsDiffDetailResp
      • PostDiffModelStartResp
      • GetDiffModelTaskIdGetResultResp
      • PostWorkspacesComparatorsDiffDetailResp
      • DeleteWorkspacesComparatorsDiffDetailResp
      • GetDiffModelTaskIdGetReportResp
      • GetWorkspacesComparatorsMatchImageResp
      • GetWorkspacesGetKeyListResp
      • GetWorkspacesTilesJsonResp
      • PutModelBatchToggleDisplayResp
      • GetWorkspacesFileCountResp
      • DeleteDiffModelTaskIdResp
      • DeleteWorkspacesResourcesResp
      • PostOrganizationsAiInsideAlgorithmFileUploadResp
      • GetOrganizationsDevicesSimInfoResp
      • GetProjectsShareReportResp
      • DeleteProjectsShareReportResp
      • GetProjectsShareAnalyzerResp
      • GetProjectsShareModelResp
      • GetWorkspacesElementIconsResp
      • PostWorkspacesElementIconsResp
      • DeleteWorkspacesElementIconsResp
      • PostProjectSignalMapsResp
      • PostOrganizationsAiLinkAlgorithmsResp
      • DeleteOrganizationsAiLinkAlgorithmsResp
      • PutOrganizationsAiLinkAlgorithmsResp
      • GetOrganizationsAiLinkAlgorithmsResp
      • PostOrganizationsAiLinkAlgorithmsInstancesResp
      • DeleteOrganizationsAiLinkAlgorithmsInstancesResp
      • PutOrganizationsAiLinkAlgorithmsInstancesResp
      • GetOrganizationsAiLinkAlgorithmsInstancesResp
      • GetProjectsAiLinkAlgorithmsInstancesResp
      • ApiPagedEnvelope
      • GetOrganizationsDevicesEsimInfoResp
      • InitPermissionTreeNode
      • DroneControlsSnapshot
      • DeviceHmsInfoItem
      • PostWorkspacesWaylinesMoveResp
      • PutWorkspacesWaylineMoveResp
      • DeleteWorkspacesWaylinesByIdResp
      • PutWorkspacesWaylinesByIdResp
      • PostWorkspacesWaylinesByIdCopyResp
      • PostWorkspacesFavoritesResp
      • DeleteWorkspacesFavoritesResp
      • PostWorkspacesWaylinesConcatResp
      • PostWorkspacesOfflineMapsPackagesResp
      • PostWorkspacesOfflineMapsResp
      • DeleteWorkspacesOfflineMapsResp
      • PostCommonWeatherReportV2Resp
      • PostOrgManageDevicesCareEncryptSnResp
      • DeleteWorkspacesFlightTasksFlyToPointsResp
      • PostDrcCloudControlAuthResp
      • GetDrcCloudControlsResp
      • PostDrcCloudControlsResp
      • DeleteDrcCloudControlsResp
      • C0026_GetAutoRecordConfig_Resp
      • C0070_Op_get_Resp
      • C0073_Op_Resp
      • C0442_SIM_get_Resp
      • C0081_Op_get_Resp
      • C0086_Op_Resp
      • C0085_Op_Resp
      • C0467_GEOCaging_Resp
      • C0048_Op_get_Resp
      • C0050_Op_Resp
      • C0494_GetOnlineDeviceQuota_Resp
      • C0579_GetDefaultName_Resp
      • C0112_ProjectListcommandstatus_Resp
      • C0125_PoiGettask_Resp
      • C0145_GetRecordsSummary_Resp
      • C0147_ListExportTasks_Resp
      • C0148_ExportRecords_Resp
      • C0143_GetOperationLog_Resp
      • C0162_GetWaylineInfo_Resp
      • C0006_listFlightAlerts_Resp
      • C0559_GetAiAlertRecord_Resp
      • C0362_GetWaylineImportState_Resp
      • C0266_deleteWorkspacesWorkspaceIdElementGroupsGroupId_Resp
      • C0272_postWorkspacesWorkspaceIdElementGroupsGroupIdDistribution_Resp
      • C0333_get_tile_list_recon_files_Resp
      • C0401_get_model_get_key_list_Resp
      • C0402_get_model_get_tileset_any_Resp
      • C0396_getTrashConfig_Resp
      • C0241_get_projectsProjectUuidShareShareId_Resp
      • C0249_put_projectsProjectUuidShareShareId_Resp
      • C0247_put_projectUuidShareShareIdToggle_Resp
      • C0586_GetDeviceLinks_Resp
      • C0590_CreateTopologiesCmds_Resp
      • C0593_CreateRecordStop_Resp
      • C0594_GetControlStatus_Resp
      • C0600_GetOperationUsers_Resp
      • C0230_get_projectUuidDevicesDeviceSnRecords_Resp
      • C0222_post_stopRecord_Resp
      • C0226_post_startStream_Resp
      • C0612_CreateRecordStop_Resp
    • 默认目录
  1. 地图

地图教程

功能介绍#

地图模块覆盖司空 2 私有化版下与「地图、空域、信号、离线数据」相关的全部能力,按职责分为:
地图标注
标注图层管理:图层(文件夹)的创建 / 查询 / 改名 / 重排 / 移动 / 锁定 / 删除(含批量),以及"分发到设备端 / 取消分发"。
标注要素管理:图层下要素的 CRUD、批量导入 / 导出(KML 风格 JSON)、批量改显示状态。
标注要素 CRUD:单个要素的更新 / 删除。
自定义图标:项目自定义点位图标库的注册 / 查询 / 删除。
空域安全 / 自定义飞行区:项目下飞行区(电子围栏 / 禁飞区 / 禁降区)的 CRUD + 配置同步到设备。
离线地图:项目离线地图的查询、配置(启动新一次更新)、取消、按 Dock SN 取下载 URL、触发同步到机库。
信号热力图:组织 / 项目维度的设备信号热力图查询(H3 索引网格聚合,按 SDR / 4G 链路返回)。
图层类型:服务端预置了 Default / Share / VisualCone 等保留图层,不可删除 / 重命名 / 移动 / 取消分发,会返回业务错误码 211002;普通图层正常 CRUD。
锁定保护:锁定状态下的图层及其子图层的删除、子要素操作都会被拒绝(211403);查询和锁 / 解锁切换不受限。
分发 / 取消分发:图层标注必须经过 distribution 才会被设备端拉取并展示,不分发的图层只在云端可见。
自定义图标的 OSS 文件不会被自动清理:删除图标只删数据库注册记录,OSS 文件由部署方按生命周期策略清理。
飞行区同步:POST /flight-areas/upload 是 application/json,upload 指"配置上传到设备"而非"客户端传文件",不要误用 multipart 提交。
离线地图状态机:unknown → processing → success / failed;启动新一次更新会取消上一次未完成的转换。

接口使用流程#

标注图层 — 文件夹层管理#

调用步骤:
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 凭证。
2.
直传图标文件到 OSS。
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 当前状态。

信号热力图#

调用步骤:
项目维度:查询项目级信号热力图 (POST /openapi/v2.0/manage/api/v1/projects/{uuid}/signal-maps) — 按设备 SN 列表查项目下飞机历史飞行经过区域的信号强度热力图。请求体字段:
device_sns(数组):要查询的设备 SN 列表。
data_types(数组,必填):链路类型列表,如 ["sdr"] / ["4g"] / ["sdr","4g"]。
resolution(可选):H3 索引网格分辨率。
组织维度:查询组织级信号热力图 (POST /openapi/v2.0/manage/api/v1/organizations/{uuid}/signal-maps) — 按设备 SN 列表查询当前组织下用户有权限的所有项目的设备信号热力图,请求体形态与项目级接口相同。
修改于 2026-06-11 09:04:17
上一页
批量更新航线 / 文件夹锁定状态
下一页
移动 / 重排图层与要素
Built with