查询构件属性（详情）

最近更新时间：2024-03-12 02:07:47

我的收藏

本页目录：

1. 接口描述

接口请求域名： weilingwith.tencentcloudapi.com 。

查询构件属性（详情）

默认接口请求频率限制：20次/秒。

推荐使用 API Explorer

点击调试

API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	类型	描述
Action	是	String	公共参数，本接口取值：DescribePropertyList。
Version	是	String	公共参数，本接口取值：2023-04-27。
Region	是	String	公共参数，详见产品支持的地域列表。
BuildingId	是	String	建筑id 示例值："377e4f9d-d20e-4209-b1e8-0ddb32e888c8"
ElementId	是	String	构件id 示例值："b66aece1-62e9-49d3-872e-6e66156a853b"
WorkspaceId	是	String	项目空间id 示例值："1124"
ApplicationToken	是	String	应用token 示例值："Sl5ZDmVuHzhN52o8n1KWagl7sLdrLfN7"

3. 输出参数

参数名称	类型	描述
Result	ElementPropertyRes	构件属性信息出参示例值： { "BuildingId": "377e4f9d-d20e-4209-b1e8-0ddb32e888c8", "Coordinates": { "Altitude": 0, "Latitude": 39.12852507853361, "Longitude": 117.25139600000003 }, "ElementId": "b66aece1-62e9-49d3-872e-6e66156a853b", "ElementName": "Level : F4", "EntityTypeCode": "TBIM_BUILDINGSTOREY", "EntityTypeName": "楼层", "PropertySet": [ { "Content": "{Elevation=9500, Story Above=None}", "Description": "", "Name": "Constraints" }, { "Content": "{Computation Height=0}", "Description": "", "Name": "Dimensions" }, { "Content": "{Is ground plane=0}", "Description": "", "Name": "Display" }, { "Content": "{storeyType=TOP_FLOOR, floorHeight=3000, bottomHeight=9500}", "Description": "", "Name": "EDITOR_BUILDING_STOREY_EXTEND" }, { "Content": "{Scope Box=None}", "Description": "", "Name": "Extents" }, { "Content": "{IfcGUID=1LvAmy3$j18hHP$GEcP3rk, Export to IFC=0}", "Description": "", "Name": "IFC Parameters" }, { "Content": "{Structural=No, Design Option=None, Building Story=Yes}", "Description": "", "Name": "Identity Data" }, { "Content": "{Name=Level : F4, Type=C_上标高+层标, Childs=[Roofs], Family=Level, Type Id=87266, Category=OST_Levels, ClassName=OdBmCDANode, ODAUniqueID=214592, LocalizedName=, Family and Type=Level : C_上标高+层标}", "Description": "", "Name": "Invalid group" }, { "Content": "{Material=None}", "Description": "", "Name": "Materials and Finishes" } ], "Translate": { "X": 0, "Y": 0, "Z": 0 } }
RequestId	String	唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 查询构件属性示例-prod

查询构件属性示例-prod

输入示例

POST / HTTP/1.1
Host: weilingwith.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribePropertyList
<公共请求参数>

{
    "BuildingId": "377e4f9d-d20e-4209-b1e8-0ddb32e888c8",
    "ElementId": "b66aece1-62e9-49d3-872e-6e66156a853b",
    "WorkspaceId": "1124",
    "ApplicationToken": "Sl5ZDmVuHzhN52o8n1KWagl7sLdrLfN7"
}

输出示例

{
    "Response": {
        "RequestId": "da778098-4425-4519-bd0b-589e9e83ef6f",
        "Result": {
            "BuildingId": "377e4f9d-d20e-4209-b1e8-0ddb32e888c8",
            "Coordinates": {
                "Altitude": 0,
                "Latitude": 39.12852507853361,
                "Longitude": 117.25139600000003
            },
            "ElementId": "b66aece1-62e9-49d3-872e-6e66156a853b",
            "ElementName": "Level : F4",
            "EntityTypeCode": "TBIM_BUILDINGSTOREY",
            "EntityTypeName": "楼层",
            "PropertySet": [
                {
                    "Content": "{Elevation=9500, Story Above=None}",
                    "Description": "",
                    "Name": "Constraints"
                },
                {
                    "Content": "{Computation Height=0}",
                    "Description": "",
                    "Name": "Dimensions"
                },
                {
                    "Content": "{Is ground plane=0}",
                    "Description": "",
                    "Name": "Display"
                },
                {
                    "Content": "{storeyType=TOP_FLOOR, floorHeight=3000, bottomHeight=9500}",
                    "Description": "",
                    "Name": "EDITOR_BUILDING_STOREY_EXTEND"
                },
                {
                    "Content": "{Scope Box=None}",
                    "Description": "",
                    "Name": "Extents"
                },
                {
                    "Content": "{IfcGUID=1LvAmy3$j18hHP$GEcP3rk, Export to IFC=0}",
                    "Description": "",
                    "Name": "IFC Parameters"
                },
                {
                    "Content": "{Structural=No, Design Option=None, Building Story=Yes}",
                    "Description": "",
                    "Name": "Identity Data"
                },
                {
                    "Content": "{Name=Level : F4, Type=C_上标高+层标, Childs=[Roofs], Family=Level, Type Id=87266, Category=OST_Levels, ClassName=OdBmCDANode, ODAUniqueID=214592, LocalizedName=, Family and Type=Level : C_上标高+层标}",
                    "Description": "",
                    "Name": "Invalid group"
                },
                {
                    "Content": "{Material=None}",
                    "Description": "",
                    "Name": "Materials and Finishes"
                }
            ],
            "Translate": {
                "X": 0,
                "Y": 0,
                "Z": 0
            }
        }
    }
}

示例2 查询构件属性（详情）

查询构件属性（详情）成功响应示例

输入示例

POST / HTTP/1.1
Host: weilingwith.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribePropertyList
<公共请求参数>

{
    "BuildingId": "2e374df6-7ba7-45d2-a44d-2a92bb2a6668",
    "ElementId": "2e374df6-7ba7-45d2-a44d-2a92bb2a6668",
    "WorkspaceId": "1016",
    "ApplicationToken": "fquCgDi2QfNDMlNyQ5YPoMR2Zw4tQs2B"
}

输出示例

{
    "Response": {
        "RequestId": "37ff2cfc-5c07-4c14-9f4f-82e52b155754",
        "Result": {
            "BuildingId": "2e374df6-7ba7-45d2-a44d-2a92bb2a6668",
            "Coordinates": {
                "Altitude": 0,
                "Latitude": 22.533192029618775,
                "Longitude": 113.93048000000002
            },
            "ElementId": "2e374df6-7ba7-45d2-a44d-2a92bb2a6668",
            "ElementName": "测试建筑",
            "EntityTypeCode": "TBIM_BUILDING",
            "EntityTypeName": "建筑",
            "PropertySet": [
                {
                    "Content": "{overground_floor=0, underground_floor=0, overground_floor_height=0, underground_floor_height=0}",
                    "Description": "editor building extend",
                    "Name": "EDITOR_BUILDING_EXTEND"
                },
                {
                    "Content": "{name=bh1.ifc, size=7384171, type=IFC, pinyin=bh1.ifc, fileKey=/bim/6ced4b4a-e34c-49fb-b8fc-15b63d6fd682.ifc, uploadTS=1685446303474, relTaskId=4058f87f-2bc1-4f28-9c05-25426987dafb}",
                    "Description": "building file",
                    "Name": "TBIM_BUILDING_FILE"
                },
                {
                    "Content": "{NumberOfStoreys=5}",
                    "Description": "",
                    "Name": "Pset_BuildingCommon"
                },
                {
                    "Content": "",
                    "Description": "element extend attributes",
                    "Name": "TBIM_PROPERTY_EXTEND_ATTR"
                },
                {
                    "Content": "{MODEL_HULL=00e79829-d8d1-468b-a497-1a6172be051c.glb, MODEL_ORIGIN=b92563fe-c61f-45df-a9e5-c01ecddb4c77.glb, MODEL_STOREY={30eZ3ov6r4ygu6QtqZ6IN$=5149f7ea-d3ab-470e-9d50-06f190bf2e5a.glb, 30eZ3ov6r4ygu6QtqZ6INI=23268a8e-c01d-4f92-b6ef-a3f5b3740765.glb, 30eZ3ov6r4ygu6QtqZ6INW=955e5c87-dbd5-4197-9eb5-f3216265f36f.glb, 30eZ3ov6r4ygu6QtqZ6INf=8b8fdeda-22d0-44b0-bd09-2dd0592d4713.glb, 30eZ3ov6r4ygu6QtqZ6INs=e72910c7-9d8b-464f-912d-f21fe2b87f2b.glb}}",
                    "Description": "",
                    "Name": "TBIM_BUILDING_GLB_MODEL"
                }
            ],
            "Translate": {
                "X": 0,
                "Y": 0,
                "Z": 0
            }
        }
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

Tencent Cloud SDK 3.0 for Python: GitHub Gitee
Tencent Cloud SDK 3.0 for Java: GitHub Gitee
Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
Tencent Cloud SDK 3.0 for Go: GitHub Gitee
Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
Tencent Cloud SDK 3.0 for C++: GitHub Gitee
Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InternalError.BIMAppInternalError	BIM服务内部错误
InvalidParameterValue.InvalidElementIdOrProjectId	项目id或构件id取值错误
ResourceNotFound.ElementNotFound	未查询到构件信息

上一篇: 查询构件树下一篇: 查询场景列表