图框基本信息结果获取

接口概述

根据图纸基本信息识别任务 ID 获取图框基本信息结果。返回结果为图框列表，每个图框包含图框坐标、图签坐标、图签识别内容和旋转角度。

请先通过任务状态查询接口确认任务状态为 SUCCESS，再调用本接口获取结果。

请求地址

GET /result/pre/frameBaseInfo

请求头

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

路径参数

参数	类型	必填	当前接口取值	说明
type	String	是	pre	图纸基本信息识别任务类型
dataType	String	是	frameBaseInfo	图框基本信息结果类型

查询参数

参数	类型	必填	说明
id	String	是	图纸基本信息识别任务的 taskId

请求示例

curl -G "https://openapi.bangtu-ai.com/openApi/result/pre/frameBaseInfo" \
  -H "apiKey:  YOUR_API_KEY" \
  --data-urlencode "id=1900123456789012345"

返回结果

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

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "frameId": "frame-001",
      "layoutName": "Model",
      "frameWcsLoc": {
        "left": 0.0,
        "top": 594.0,
        "right": 841.0,
        "bottom": 0.0
      },
      "signFlashWcsLoc": {
        "left": 650.0,
        "top": 120.0,
        "right": 841.0,
        "bottom": 0.0
      },
      "cvSignWcsLoc": {
        "left": 652.5,
        "top": 118.5,
        "right": 839.5,
        "bottom": 2.0
      },
      "signInfo": {
        "图号": "JZ-01",
        "图名": "一层平面图",
        "比例": "1:100"
      },
      "rotation": 0
    }
  ],
  "timestamp": 1784533710000
}

返回字段

字段	类型	说明
code	Number	通用响应码，200 表示成功，500 表示失败
message	String	响应信息
data	Array | null	图框基本信息数组；请求失败或未获取到结果时可能为 null
timestamp	Number	服务端响应时间戳，单位为毫秒

响应码

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

data 数组元素

字段	类型	说明
frameId	String	图框唯一标识
layoutName	String	图框所属的 DWG 布局名称
frameWcsLoc	Object | null	图框在世界坐标系中的范围
signFlashWcsLoc	Object | null	快速识别得到的图签坐标范围
cvSignWcsLoc	Object | null	CV 精确识别得到的图签坐标范围
signInfo	Object | null	图签识别内容；字段名称和值由实际图签内容决定
rotation	Number	图框旋转角度

WCS 坐标对象

frameWcsLoc、signFlashWcsLoc 和 cvSignWcsLoc 使用相同的数据结构：

字段	类型	说明
left	Number	坐标范围左边界，即最小 X 值
top	Number	坐标范围上边界，即最大 Y 值
right	Number	坐标范围右边界，即最大 X 值
bottom	Number	坐标范围下边界，即最小 Y 值

signInfo 对象

signInfo 为图签内容识别结果，其 JSON 字段不固定，由实际图纸中的图签字段决定，例如图号、图名、比例等。当图签内容为空或未识别到有效信息时，该字段可能为 null。

调用流程

1. 调用图纸基本信息识别任务创建接口，获取 taskId。
2. 每隔 3 至 5 秒查询任务状态。
3. 任务状态变为 SUCCESS 后，将 taskId 作为查询参数 id 调用本接口。
4. 遍历响应的 data 数组，获取各个图框的基本信息。

注意事项

• 路径参数必须使用 type=pre 和 dataType=frameBaseInfo。
• 查询参数名称为 id，参数值为任务创建接口返回的 taskId。
• taskId 应按字符串传递，不要转换为数字，避免长整型精度丢失。
• 应在任务状态为 SUCCESS 后获取结果；任务未完成或结果不存在时，data 可能为 null。
• 一张 DWG 图纸可能识别出多个图框，因此 data 始终按数组结构处理。
• 快速图签坐标或精确图签坐标未识别成功时，对应字段可能为 null。