子图框基本信息结果获取

接口概述

根据给排水构件识别任务 ID 获取图框内的子图框基本信息列表，包括子图框 ID、名称、WCS 范围、类型和所属图框 ID。

请在给排水构件识别任务状态为 SUCCESS 后调用本接口。后续获取指定子图框内的给排水构件结果时，需要使用本接口返回的 subFrameId。

接口地址

GET /result/wsd_cv/subFrame

请求头

参数	必填	说明
apiKey	是	API 访问凭证，值为 YOUR_API_KEY

请求参数

参数	类型	必填	说明
id	String	是	给排水构件识别任务的 taskId

请求示例

curl -G "https://openapi.bangtu-ai.com/openApi/result/wsd_cv/subFrame" \
  -H "apiKey: YOUR_API_KEY" \
  --data-urlencode "id=WSD_TASK_ID"

返回结果

data 为子图框基本信息数组，对应 List<BaseSubFrame>。

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "subFrameId": "wsd-subframe-plan-001",
      "subFrameName": "一层给排水平面图",
      "wcsLoc": {
        "left": 100.0,
        "top": 1800.0,
        "right": 2400.0,
        "bottom": 100.0
      },
      "subFrameType": "PLAN_DRAWING",
      "frameId": "frame-001",
      "object": null
    },
    {
      "subFrameId": "wsd-subframe-system-001",
      "subFrameName": "给排水系统图",
      "wcsLoc": {
        "left": 2600.0,
        "top": 1500.0,
        "right": 4200.0,
        "bottom": 100.0
      },
      "subFrameType": "SYSTEM_DRAWING",
      "frameId": "frame-001",
      "object": null
    }
  ],
  "timestamp": 1784538400000
}

字段说明

字段	类型	说明
subFrameId	String	子图框唯一标识，用于获取该子图框内的给排水构件结果
subFrameName	String	子图框名称
wcsLoc	Object	子图框 WCS 范围，包含 left、top、right、bottom
subFrameType	String	子图框类型：FRAME_UNK、PLAN_DRAWING、SYSTEM_DRAWING 或 SPECIFICATION_DRAWING
frameId	String	所属图框唯一标识
object	Object | null	该基础信息接口未填充构件对象，通常为 null

子图框类型

类型	说明
FRAME_UNK	未知类型子图框
PLAN_DRAWING	平面图
SYSTEM_DRAWING	系统图
SPECIFICATION_DRAWING	设计说明图框

响应码

code	说明
200	请求成功
500	请求失败

注意事项

• id 应使用给排水构件识别任务创建接口返回的 taskId。
• 返回的 subFrameId 应按字符串保存，后续获取子图框构件结果时需要使用。
• 坐标均为 WCS 坐标。
• 结果不存在时 data 可能为空数组或 null。