子图框基本信息结果获取

接口概述

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

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

接口地址

GET /result/struct_cv/subFrame

请求头

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

请求参数

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

请求示例

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

返回结果

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

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "subFrameId": "struct-subframe-axis-001",
      "subFrameName": "三层梁板配筋平面图",
      "wcsLoc": {
        "left": 100.0,
        "top": 1800.0,
        "right": 2400.0,
        "bottom": 100.0
      },
      "subFrameType": "AXIS",
      "frameId": "frame-001",
      "object": null
    },
    {
      "subFrameId": "struct-subframe-table-001",
      "subFrameName": "剪力墙墙身表",
      "wcsLoc": {
        "left": 2600.0,
        "top": 1500.0,
        "right": 4200.0,
        "bottom": 100.0
      },
      "subFrameType": "TABLE",
      "frameId": "frame-001",
      "object": null
    }
  ],
  "timestamp": 1784538400000
}

字段说明

字段	类型	说明
subFrameId	String	子图框唯一标识，用于获取该子图框内的结构构件结果
subFrameName	String	子图框名称，取自图纸中的子图框标题
wcsLoc	Object	子图框 WCS 范围，包含 left、top、right、bottom
subFrameType	String	子图框类型，取值见下方说明
frameId	String	所属图框唯一标识
object	Object | null	该基础信息接口未填充构件对象，通常为 null

子图框类型

类型	说明
FRAME_UNK	未知子图框类型
AXIS	轴网子图框
TABLE	表格子图框
PLA	楼梯平面子图框
SEC	楼梯剖面子图框
TABLE_TWO	楼梯表格子图框
DETAIL	详图子图框
SCTL	悬挑板详图子图框
BASIC_DETAIL	基础详图子图框

响应码

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

注意事项

• id 应使用结构构件识别任务创建接口返回的 taskId。
• 返回的 subFrameId 应按字符串保存，后续获取子图框构件结果时需要使用。
• 不同子图框类型包含的构件不同，AXIS 轴网子图框和 TABLE 表格子图框已开放构件结果，其余类型当前仅返回基本信息。
• 坐标均为 WCS 坐标。
• 结果不存在时 data 可能为空数组或 null。