暖通子图框构件结果获取

接口概述

根据暖通构件识别任务 ID 和子图框 ID，获取指定子图框内的暖通构件识别结果。可通过 dataTypeList 筛选需要返回的构件类型；不传或传空数组时，服务端默认返回全部构件类型。

请先等待暖通构件识别任务状态变为 SUCCESS，再通过子图框基本信息结果获取接口取得 subFrameId。

请求地址

http

POST /result/heating_cv/subFrameResult

请求头

参数	必填	说明
apiKey	是	API 访问凭证，值为 `YOUR_API_KEY`
Content-Type	是	`application/json`

请求体

参数	类型	必填	说明
taskId	String	是	暖通构件识别任务创建接口返回的任务唯一标识
subFrameId	String	是	子图框基本信息结果获取接口返回的子图框唯一标识
dataTypeList	`Array<String>`	否	需要返回的构件类型列表；不传或传空数组时默认使用 `all`

请求示例

以下示例只查询排风机、送风管和防火阀三类构件：

bash

curl -X POST "https://openapi.bangtu-ai.com/openApi/result/heating_cv/subFrameResult" \
  -H "apiKey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "1900123456789012346",
    "subFrameId": "heating-subframe-001",
    "dataTypeList": ["exhaustFan", "supplyDuct", "fireDamper"]
  }'

需要返回全部构件时，省略 dataTypeList 或传入空数组即可。

返回结果

data 为指定子图框的基本信息和构件识别结果。object 中的属性名为构件类型，属性值为该类型的构件数组。

json

{
  "code": 200,
  "message": "success",
  "data": {
    "subFrameId": "heating-subframe-001",
    "subFrameName": "一层暖通平面图",
    "wcsLoc": {
      "left": 100.0,
      "top": 1800.0,
      "right": 2400.0,
      "bottom": 100.0
    },
    "frameId": "frame-001",
    "object": {
      "exhaustFan": [
        {
          "wcsLoc": {
            "left": 680.0,
            "top": 960.0,
            "right": 760.0,
            "bottom": 880.0
          },
          "equipNumber": "PF-1-1",
          "equipStructure": ["离心式"],
          "airFlow": ["12000m3/h"],
          "fullPressure": ["650Pa"]
        }
      ],
      "supplyDuct": [
        {
          "size": {
            "length": 0.0,
            "width": 800.0,
            "diameter": 0.0
          },
          "wcsLoc": {
            "points": [
              { "x": 320.0, "y": 720.0 },
              { "x": 980.0, "y": 720.0 },
              { "x": 980.0, "y": 680.0 },
              { "x": 320.0, "y": 680.0 }
            ]
          }
        }
      ],
      "fireDamper": []
    }
  },
  "timestamp": 1784538400000
}

返回字段

字段	类型	说明
code	Number	通用响应码，`200` 表示成功，`500` 表示失败
message	String	响应信息
data	Object \| null	子图框及其构件识别结果；结果不存在时可能为 `null`
timestamp	Number	服务端响应时间戳，单位为毫秒

data 字段

字段	类型	说明
subFrameId	String	子图框唯一标识
subFrameName	String	子图框名称
wcsLoc	Object	子图框 WCS 范围，包含 `left`、`top`、`right`、`bottom`
frameId	String	所属图框唯一标识
object	Object	按构件类型分组的识别结果

object 字段

object 只保留 dataTypeList 指定的构件类型；省略 dataTypeList 或传入空数组时返回全部类型。未识别到对应构件时，类型对应的值通常为空数组。

设备类构件通常包含以下字段：

字段	类型	说明
wcsLoc	Object	构件 WCS 包围框
equipNumber	String	设备编号
equipStructure	`Array<String>`	设备结构或形式
airFlow	`Array<String>`	风量标注
fullPressure	`Array<String>`	全压标注
size	Object	部分设备具有的尺寸信息
coolingVolume	String	部分空调设备具有的制冷量
heatingVolume	String	部分空调设备具有的制热量

风管和立管类构件通常包含以下字段：

字段	类型	说明
wcsLoc	Object	管道 WCS 轮廓，`points` 为轮廓点数组
size	Object	尺寸信息，包含 `length`、`width`、`diameter`

不同构件类型可能只返回其中一部分字段；轴号等构件使用其对应的专用结构。

全部构件类型

在 dataTypeList 中填写“请求参数值”即可查询对应的构件。构件名称与参数值的完整对应关系如下：

构件名称	请求参数值
轴号	`axisNumber`
排烟排风机	`smokeExhaustExhaustFan`
排烟风机	`smokeExhaustFan`
补风送风机	`makeupSupplyFan`
加压风机	`pressurizationFan`
补风机	`makeupFan`
排风机	`exhaustFan`
排气扇	`exhaustFanSpecial`
送风机	`supplyFan`
排烟阀	`smokeExhaustValve`
排烟防火阀	`smokeExhaustFireDamper`
防火阀	`fireDamper`
止回阀	`checkValve`
排烟排风口	`smokeExhaustExhaustOutlet`
排烟口	`smokeExhaustOutlet`
补风口	`makeupOutlet`
补风送风口	`makeupSupplyOutlet`
加压送风口	`pressurizationOutlet`
排风口	`exhaustOutlet`
送风口	`supplyOutlet`
未分类风口	`unknownOutlet`
挡烟垂壁	`smokeBarrier`
一氧化碳浓度监测装置	`carbonMonoxideDetector`
排烟阀口手动开启装置	`smokeValveManualRelease`
常闭排烟口	`normallyClosedSmokeOutlet`
常闭加压口	`normallyClosedPressurizationOutlet`
消声器	`silencer`
静压箱	`staticPressureBox`
变径	`reducer`
弯头	`elbow`
三通	`tee`
四通	`cross`
分歧管	`branchPipe`
多联机内机	`vrfIndoorUnit`
多联机外机	`vrfOutdoorUnit`
压力表	`pressureGauge`
温度计	`thermometer`
地暖集分水器	`floorHeatingManifold`
地暖盘管	`floorHeatingCoil`
冷媒管	`refrigerantPipe`
冷凝水管	`condensatePipe`
空调风管	`airConditioningDuct`
排烟排风风管	`smokeExhaustExhaustDuct`
排烟风管	`smokeExhaustDuct`
补风送风风管	`makeupSupplyDuct`
补风风管	`makeupDuct`
加压风管	`pressurizationDuct`
排风风管	`exhaustDuct`
送风风管	`supplyDuct`
未分类风管	`unknownDuct`
排烟立管	`smokeExhaustRiser`
排烟排风立管	`smokeExhaustExhaustRiser`
补风立管	`makeupRiser`
补风送风立管	`makeupSupplyRiser`
加压立管	`pressurizationRiser`
排风立管	`exhaustRiser`
送风立管	`supplyRiser`
未分类立管	`unknownRiser`

响应码

code	说明
200	请求成功
500	请求失败，包括任务或子图框不存在、任务执行失败、请求参数错误等情况

调用流程

创建暖通构件识别任务并保存 taskId。
查询任务状态，等待状态变为 SUCCESS。
调用子图框基本信息结果获取接口，取得目标子图框的 subFrameId。
调用本接口，按需传入 dataTypeList 获取构件结果。

注意事项

taskId 和 subFrameId 均不能为空。
subFrameId 必须属于指定的暖通构件识别任务。
dataTypeList 中的值必须使用上表中的请求参数值，并严格区分大小写。
需要全部构件时，省略 dataTypeList 或传入空数组即可。
taskId 和 subFrameId 应按字符串保存，避免长整型标识发生精度丢失。

暖通子图框构件结果获取 ​

接口概述 ​

请求地址 ​

请求头 ​

请求体 ​

请求示例 ​

返回结果 ​

返回字段 ​

data 字段 ​

object 字段 ​

全部构件类型 ​

响应码 ​

调用流程 ​

注意事项 ​