电气子图框构件结果获取

接口概述

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

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

请求地址

http

POST /result/electrical_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/electrical_cv/subFrameResult" \
  -H "apiKey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "1900123456789012346",
    "subFrameId": "electrical-subframe-001",
    "dataTypeList": ["lightingLamp", "powerOutlet", "distributionBox"]
  }'

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

返回结果

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

json

{
  "code": 200,
  "message": "success",
  "data": {
    "subFrameId": "electrical-subframe-001",
    "subFrameName": "一层照明平面图",
    "wcsLoc": {
      "left": 100.0,
      "top": 1800.0,
      "right": 2400.0,
      "bottom": 100.0
    },
    "subFrameType": "PLAN_DRAWING",
    "frameId": "frame-001",
    "object": {
      "lightingLamp": [
        {
          "wcsLoc": {
            "left": 680.0,
            "top": 960.0,
            "right": 720.0,
            "bottom": 920.0
          }
        }
      ],
      "floorSignLamp": [
        {
          "wcsLoc": {
            "left": 740.0,
            "top": 960.0,
            "right": 780.0,
            "bottom": 920.0
          },
          "manufacturingRequirements": ["A 型集中电源集中控制型"]
        }
      ],
      "powerOutlet": [
        {
          "wcsLoc": {
            "left": 510.0,
            "top": 630.0,
            "right": 535.0,
            "bottom": 605.0
          }
        }
      ],
      "distributionBox": []
    }
  },
  "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`
subFrameType	String	子图框类型：`FRAME_UNK`、`PLAN_DRAWING` 或 `SYSTEM_DRAWING`
frameId	String	所属图框唯一标识
object	Object	按构件类型分组的识别结果

object 字段

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

大多数点状电气构件包含以下位置字段：

字段	类型	说明
wcsLoc	Object	构件 WCS 包围框
wcsLoc.left	Number	包围框左边界 X 坐标
wcsLoc.top	Number	包围框上边界 Y 坐标
wcsLoc.right	Number	包围框右边界 X 坐标
wcsLoc.bottom	Number	包围框下边界 Y 坐标

不同构件类型可能包含额外属性。楼层标志灯包含以下特有字段：

字段	类型	说明
manufacturingRequirements	`Array<String>`	楼层标志灯的制造要求；未识别到制造要求时返回空数组

全部构件类型

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

构件名称	请求参数值
轴号	`axisNumber`
断路器	`circuitBreaker`
隔离断路器	`isolationCircuitBreaker`
剩余电流断路器	`residualCurrentCircuitBreaker`
隔离型剩余电流断路器	`isolationResidualCurrentCircuitBreaker`
隔离开关	`isolationSwitch`
接触器	`contactor`
控制与保护开关电器（CPS）	`cps`
自动转换开关电器（ATSE）	`atse`
热继电器	`thermalRelay`
熔断器	`fuse`
出线	`outlet`
母线	`generatrix`
进线	`incomingLine`
电涌保护器（SPD）	`spd`
后备保护器（SCB）	`scb`
配电箱	`distributionBox`
电能表	`electricEnergyMeter`
电流互感器	`currentTransformer`
过欠压保护器	`overUnderVoltageProtector`
应急照明集中电源	`emergencyLightingCentralizedPowerSupply`
消防电源监控模块	`firePowerMonitoringModule`
电气火灾监控模块	`electricalFireMonitoringModule`
限流式电气防火保护器	`currentLimitingElectricalFireProtector`
母线槽	`busDuct`
插接箱	`pluginBox`
穿刺线夹	`punctureClamp`
变压器	`transformer`
柴油发电机组	`dieselGeneratorSet`
双电源转换开关（TSE）	`tse`
照明变压器	`lightingTransformer`
电动机	`electricMotor`
方向标志灯	`directionSignLamp`
出口灯	`exitLamp`
楼层标志灯	`floorSignLamp`
照明灯	`lightingLamp`
开关	`switchDevice`
电源插座	`powerOutlet`
总等电位箱	`mainEquipotentialBox`
局部等电位箱	`localEquipotentialBox`
接地线	`groundWire`
接闪带	`lightningStrip`
防雷引下线	`lightningDownConductor`
电缆桥架	`cableTray`
强电线路	`powerRoute`
弱电线路	`weakCurrentRoute`
火灾线路	`fireRoute`
电视插座	`televisionOutlet`
电话插座	`telephoneOutlet`
信息插座	`informationOutlet`
家居配线箱	`homeWiringBox`
紧急求助报警装置	`emergencyHelpAlarm`
摄像机	`camera`
门磁	`doorContact`
可视对讲主机	`videoIntercomHost`
可视对讲分机	`videoIntercomExtension`
窗磁	`windowContact`
红外探测器	`infraredDetector`
一氧化碳浓度监测器	`coConcentrationMonitor`
读卡器	`cardReader`
点型感烟火灾探测器	`pointSmokeDetector`
点型感温火灾探测器	`pointHeatDetector`
短路隔离器	`shortCircuitIsolator`
可燃气体探测器	`combustibleGasDetector`
消火栓按钮	`fireHydrantButton`
手动火灾报警按钮	`manualFireAlarmButton`
消防电话分机	`fireTelephoneExtension`
声光警报器	`audibleVisualAlarm`
消防广播	`fireBroadcast`
广播模块	`broadcastModule`
防火门监控模块	`fireDoorMonitoringModule`
控制模块	`controlModule`
模块箱	`moduleBox`
消控室外线电话	`controlRoomExternalTelephone`
区域显示器	`areaDisplay`
液位显示装置	`liquidLevelDisplay`
液位计	`liquidLevelGauge`
压力开关	`pressureSwitch`
流量开关	`flowSwitch`
消防接线端子箱	`fireTerminalBox`
水流指示器	`waterFlowIndicator`
信号阀	`signalValve`
报警阀	`alarmValve`
风口	`airOutlet`
70 度防火阀	`fireDamper70`
150 度防火阀	`fireDamper150`
280 度防火阀	`fireDamper280`
区域火灾报警器	`regionalFireAlarm`
火灾报警控制器	`fireAlarmController`
消防联动控制器	`fireLinkageController`
多线手动控制盘	`multiLineManualControlPanel`
图形显示装置	`graphicDisplayDevice`
消控室不间断电源（UPS）	`controlRoomUps`
可燃气体探测主机	`combustibleGasDetectorHost`
消防电话主机	`fireTelephoneHost`
消防广播主机	`fireBroadcastHost`
消防电源监控主机	`firePowerMonitoringHost`
电气火灾监控主机	`electricalFireMonitoringHost`
防火门监控主机	`fireDoorMonitoringHost`
防火门监控分机	`fireDoorMonitoringExtension`
防火门电动闭门器	`electricDoorCloser`
应急照明控制器	`emergencyLightingController`
气体灭火控制器	`gasFireExtinguishingController`
气体喷洒指示灯	`gasDischargeIndicator`
干粉喷洒指示灯	`dryPowderDischargeIndicator`
紧急启停按钮	`emergencyStartStopButton`

响应码

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

调用流程

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

注意事项

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

电气子图框构件结果获取 ​

接口概述 ​

请求地址 ​

请求头 ​

请求体 ​

请求示例 ​

返回结果 ​

返回字段 ​

data 字段 ​

object 字段 ​

全部构件类型 ​

响应码 ​

调用流程 ​

注意事项 ​