# 结果查看

# 结果查询接口

可依据下列后端接口查询净空分析内的空间净空结果。

POST https://api.bimface.com/data/v1/feature-management/spaces/clearance-height-check/space-results

在返回结果中会给定如下参数:

  1. clearanceHeightId:净空分析ID;
  2. name:净空分析名称;
  3. description:净空分析描述;
  4. levelId:楼层ID,用于对空间进行组织;
  5. spaceId:空间ID;
  6. spaceName:空间名称;
  7. targetHeight:指定的目标净空;
  8. clearanceHeight:空间的实际净空;
  9. isQualified:判断是否满足净空要求的布尔值。

现给出结果示例如下:

{
    "code": "bimfaceservice-0000",
    "message": null,
    "data": {
        "clearanceHeightId": 2523406506925440,
        "description": "这个示例记录了广联达大厦-1F的净空分析",
        "name": "这是一个示例",
        "results": [
            {
                "levelId": "0",
                "space": [
                    {
                        "clearanceHeight": 3520.0,
                        "isQualified": true,
                        "levelId": "0",
                        "spaceId": "10000026590219_870802",
                        "spaceName": "房间 14",
                        "spaceType": "room",
                        "spaceVersion": null,
                        "spaceVersionId": null,
                        "targetHeight": 2500.0,
                        "unit": "mm"
                    }
                ]
            }
    }
}
# 构件净空结果查询

可依据下列后端接口查询指定空间内的构件净空结果。

POST https://api.bimface.com/data/v1/feature-management/spaces/clearance-height-check/components-results

在返回结果中会给定如下参数:

  1. spaceId:空间ID;
  2. objectId:构件ID;
  3. targetHeight:指定空间的目标净空;
  4. clearanceHeight:构件的实际净空;
  5. isQualified:判断是否满足净空要求的布尔值。

现给出结果示例如下:

{
    "code": "bimfaceservice-0000",
    "message": null,
    "data": {
        "object": [
            {
                "clearanceHeight": 2070.0, //构件净高
                "isQualified": false, //是否满足要求
                "objectId": "576729" //构件id
            }
        ],
        "spaceId": "576740",
        "targetHeight": 2500.0,
        "unit": "mm"
    }
}

可依据下列后端接口查询不满足净空要求的构件。

POST https://api.bimface.com/data/v1/feature-management/spaces/clearance-height-check/results/below-target-clearance-components

示例结果如下:

{
    "code": "bimfaceservice-0000",
    "message": null,
    "data": [
        {
            "object": [
                {
                    "clearanceHeight": 2241.6,
                    "isQualified": false,
                    "objectId": "10000026590219.635845"
                }
            ],
            "spaceId": "10000026590219_870792",
            "targetHeight": 2500.0,
            "unit": "mm"
        }
    ]
}

# 净空结果展示

为便于用户使用,BIMFACE还提供了前端面板,展示净空分析结果:

净空分析展示示意图

通过结果,可以进行净空分析结果的管理。您可以通过调用ClearanceHeightCheckPanel类来实现如下效果,具体步骤如下:

# 配置项设置

首先需要进行配置项设置,并:

  1. 指定viewer对象(必填)。
  2. 指定净空分析结果,结果通过后端接口获取空间净空结果得到。(选填,可在后续填写)
// 设置配置项
let panelConfig = new Glodon.Bimface.Plugins.ClearanceHeightCheck.ClearanceHeightCheckPanelConfig();
// viewer对象--必填
panelConfig.viewer = viewer3D;
// 净空分析结果指定--选填(通过POST https://api.bimface.com/data/v1/feature-management/spaces/clearance-height-check/space-results获取)
panelConfig.clearanceHeightCheckResult = result;	

# 面板生成

在配置项设置完成后,可进行面板生成。

// 加载面板
let panel = new Glodon.Bimface.Plugins.ClearanceHeightCheck.ClearanceHeightCheckPanel(panelConfig);
// 设置数据
// 若在配置config时已指定了clearanceHeightCheckResult,则不需要指定
panel.setData(result);

在完成面板配置后,您就可以通过BIMFACE提供的面板来查看净空分析情况了。当然,您也可以在获取到数据后,进行自定义的展示。