BIMFACE二次開發
BIMFACE二次開發系列目錄 【已更新最新開發文章，點選檢視詳細】
大廈建築模型中，基本上包含多個樓層，每個樓層包含多個房間等資訊。在《C#開發BIMFACE系列21 服務端API之擷取模型資料6：擷取單模型的樓層資訊》中介紹了如何擷取一個模型中包含的樓層資訊、面積分區、房間等資訊。本篇主要介紹如何擷取單個模型中單個房間資訊。
請求位址：GET https://api.bimface.com/data/v2/files/{fileId}/rooms/{roomId}
說明：擷取單個模型種單個房間資訊
參數：
請求 path(示例)：https://api.bimface.com/data/v2/files/1211223382064960/rooms/857279
請求 header(示例)："Authorization: Bearer dc671840-bacc-4dc5-a134-97c1918d664b"
HTTP響應示例(200)：
{
"code" : "success",
"data" : {
"area" : 7.256476003661832E7,
"bboxMax" : {
"x" : -4938.068482562385,
"y" : -3201.59397858169,
"z" : 0.0
},
"bboxMin" : {
"x" : -4938.068482562385,
"y" : -3201.59397858169,
"z" : 0.0
},
"boundary" : "",
"id" : "313137",
"levelId" : "11",
"maxPt" : {
"x" : -4938.068482562385,
"y" : -3201.59397858169,
"z" : 0.0
},
"minPt" : {
"x" : -4938.068482562385,
"y" : -3201.59397858169,
"z" : 0.0
},
"name" : "dining room 4",
"perimeter" : 40087.80000000279,
"properties" : [ {
"group" : "dimension",
"items" : [ {
"code" : "perimeter",
"extension" : "object",
"key" : "perimeter",
"orderNumber" : 0,
"unit" : "mm",
"value" : 17200,
"valueType" : 2
} ]
} ]
},
"message" : ""
} 該傳回結果的結構比較複雜。在文章最後會給出對應封裝成的C#類。
C#實作方法：
1 /// <summary>
2 /// 擷取單個模型中單個樓層資訊
3 /// </summary>
4 /// <param name="accessToken">【必填】令牌</param>
5 /// <param name="fileId">【必填】代表該單模型的檔案ID</param>
6 /// <param name="roomId">【必填】房間ID</param>
7 /// <returns></returns>
8 public virtual SingleModelSingleRoom GetSingleModelSingleRoom(string accessToken, long fileId, string roomId)
9 {
10 // GET https://api.bimface.com/data/v2/files/{fileId}/rooms/{roomId}
11 string url = string.Format(BimfaceConstants.API_HOST + "/data/v2/files/{0}/rooms/{1}", fileId, roomId);
12
13 BimFaceHttpHeaders headers = new BimFaceHttpHeaders();
14 headers.AddOAuth2Header(accessToken);
15
16 try
17 {
18 SingleModelSingleRoom response;
19
20 HttpManager httpManager = new HttpManager(headers);
21 HttpResult httpResult = httpManager.Get(url);
22 if (httpResult.Status == HttpResult.STATUS_SUCCESS)
23 {
24 response = httpResult.Text.DeserializeJsonToObject<SingleModelSingleRoom>();
25 }
26 else
27 {
28 response = new SingleModelSingleRoom
29 {
30 Message = httpResult.RefText
31 };
32 }
33
34 return response;
35 }
36 catch (Exception ex)
37 {
38 throw new Exception("[擷取單個房間資訊]發生異常！", ex);
39 }
40 } 其中調用到的 httpManager.Get() 方法，請參考《C# HTTP系列》
測試
在BIMFACE的控制台中可以看到以下檔案清單。模型狀态均為轉換成功。
以“Revit案例項目改.0001.rvt”為例測試上述的方法。
在《C#開發BIMFACE系列21 服務端API之擷取模型資料6：擷取單模型的樓層資訊》中查詢傳回的結果中包含 RoomId
以 RoomID 為 857552 為例來查詢該房間的詳細資訊
完整的房間資訊如下：
success
[area=70319994.3674652,
bboxMax=[x=13061.9309943162, y=-3481.59383914623, z=2199.99991189159],
bboxMin=[x=7061.93123461209, y=-15201.5933697684, z=0],
boundary={"version":"2.0","loops":[[[{"z":0.0,"y":-15201.593978581839,"x":13061.931517437606},
{"z":0.0,"y":-3481.5939785817081,"x":13061.931517437624}
],
[{"z":0.0,"y":-3481.5939785817077,"x":13061.931517437624},
{"z":0.0,"y":-3481.5939785816972,"x":10001.931517437628}
],
[{"z":0.0,"y":-3481.5939785816972,"x":10001.931517437628},
{"z":0.0,"y":-3481.5939785816904,"x":7726.6267896735426}
],
[{"z":0.0,"y":-3481.5939785816904,"x":7726.6267896735426},
{"z":0.0,"y":-3481.59397858169,"x":7558.3362452017109}
],
[{"z":0.0,"y":-3481.59397858169,"x":7558.3362452017109},
{"z":0.0,"y":-3481.5939785816881,"x":7061.9315174376252}
],
[{"z":0.0,"y":-3481.5939785816881,"x":7061.9315174376252},
{"z":0.0,"y":-15201.593978581817,"x":7061.9315174376061}
],
[{"z":0.0,"y":-15201.593978581821,"x":7061.9315174376061},
{"z":0.0,"y":-15201.593978581839,"x":13061.931517437606}
]
]
]
},
id=857552,
levelId=,
maxPt=[x=13061.9309943162, y=-3481.59383914623, z=0],
minPt=[x=7061.93123461209, y=-15201.5933697684, z=0],
name=Living 106,
perimeter=35579.9985750456,
properties=[group=尺寸标注,
items=[code=, extension=, key=體積, orderNumber=,unit=m³,value=154.70,valueType=2]
[code=, extension=, key=周長, orderNumber=,unit=mm,value=35580,valueType=2]
[code=, extension=, key=房間标示高度, orderNumber=,unit=mm,value=4000,valueType=2]
[code=, extension=, key=計算高度, orderNumber=,unit=mm,value=0,valueType=2]
[code=, extension=, key=面積, orderNumber=,unit=m²,value=70,valueType=2]
]
[group=辨別資料,
items=[code=, extension=, key=Occupant, orderNumber=,unit=,value=,valueType=3]
[code=, extension=, key=占用, orderNumber=,unit=,value=,valueType=3]
[code=, extension=, key=名稱, orderNumber=,unit=,value=Living,valueType=3]
[code=, extension=, key=圖像, orderNumber=,unit=,value=,valueType=4]
[code=, extension=, key=基面面層, orderNumber=,unit=,value=,valueType=3]
[code=, extension=, key=牆面面層, orderNumber=,unit=,value=,valueType=3]
[code=, extension=, key=天花闆面層, orderNumber=,unit=,value=,valueType=3]
[code=, extension=, key=樓闆面層, orderNumber=,unit=,value=,valueType=3]
[code=, extension=, key=注釋, orderNumber=,unit=,value=,valueType=3]
[code=, extension=, key=編号, orderNumber=,unit=,value=106,valueType=3]
[code=, extension=, key=部門, orderNumber=,unit=,value=,valueType=3]
]
[group=階段化,
items=[code=, extension=, key=相位, orderNumber=,unit=,value=Working Drawings,valueType=4]
]
[group=限制條件,
items=[code=, extension=, key=上限, orderNumber=,unit=,value=Level 1,valueType=4]
[code=, extension=, key=底部偏移, orderNumber=,unit=mm,value=0,valueType=2]
[code=, extension=, key=标高, orderNumber=,unit=,value=Level 1,valueType=4]
[code=, extension=, key=高度偏移, orderNumber=,unit=mm,value=4000,valueType=2]
]
] 測試代碼如下：
// 擷取單個房間資訊
protected void btnGetSingleModelSingleRoom_Click(object sender, EventArgs e)
{
long fileId = txtFileID.Text.Trim().ToLong();
string roomId = txtRoomId.Text.Trim();
FileConvertApi api = new FileConvertApi();
SingleModelSingleRoom response = api.GetSingleModelSingleRoom(txtAccessToken.Text, fileId, roomId);
txtResult.Text = response.Code.ToString2()
+ Environment.NewLine
+ response.Message.ToString2()
+ Environment.NewLine
+ response.Data;
} 該接口傳回的響應資訊，封裝成對應的C# SingleModelSingleRoom 類：
/// <summary>
/// 擷取單個模型單個房間資訊傳回的結果類
/// </summary>
public class SingleModelSingleRoom : GeneralResponse<Room>
{
} Room 類如下：
1 /// <summary>
2 /// 模型的房間資訊
3 /// </summary>
4 [Serializable]
5 public class Room
6 {
7 /// <summary>
8 /// 樣例 : 7.256476003661832E7
9 /// </summary>
10 [JsonProperty("area")]
11 public double? Area { get; set; }
12
13 [JsonProperty("bboxMax")]
14 public Coordinate BboxMax { get; set; }
15
16 [JsonProperty("bboxMin")]
17 public Coordinate BboxMin { get; set; }
18
19 /// <summary>
20 /// 邊界
21 /// </summary>
22 [JsonProperty("boundary")]
23 public string Boundary { get; set; }
24
25 /// <summary>
26 /// 編号
27 /// </summary>
28 [JsonProperty("id")]
29 public string Id { get; set; }
30
31 /// <summary>
32 /// 水準線編号
33 /// </summary>
34 [JsonProperty("levelId")]
35 public string LevelId { get; set; }
36
37 [JsonProperty("maxPt")]
38 public Coordinate MaxPt { get; set; }
39
40 [JsonProperty("minPt")]
41 public Coordinate MinPt { get; set; }
42
43 /// <summary>
44 /// 對象名稱。例如："dining room 4"
45 /// </summary>
46 [JsonProperty("name")]
47 public string Name { get; set; }
48
49 /// <summary>
50 /// 樣例 : 40087.80000000279
51 /// </summary>
52 [JsonProperty("perimeter")]
53 public double? Perimeter { get; set; }
54
55 [JsonProperty("properties")]
56 public PropertyGroup[] Properties { get; set; }
57
58 /// <summary>傳回表示目前對象的字元串。</summary>
59 /// <returns>表示目前對象的字元串。</returns>
60 public override string ToString()
61 {
62 StringBuilder sb = new StringBuilder();
63 if (Properties != null && Properties.Length > 0)
64 {
65 foreach (var property in Properties)
66 {
67 sb.AppendLine(property.ToString());
68 }
69 }
70
71 return string.Format("[area={0}, bboxMax={1}, bboxMin={2}, boundary={3}, id={4}, levelId={5}, maxPt={6}, minPt={7}, name={8}, perimeter={9}, properties={10}]",
72 Area, BboxMax, BboxMin, Boundary, Id, LevelId, MaxPt, MinPt, Name, Perimeter, sb);
73 }
74 } 其中 Coordinate 、PropertyGroup 類請參考《C#開發BIMFACE系列17 服務端API之擷取模型資料2：擷取構件材質清單》。
成在管理，敗在經驗；嬴在選擇，輸在不學！ 貴在堅持！
歡迎關注作者頭條号 張傳甯IT講堂，擷取更多IT文章、視訊等優質内容。
個人作品
1、BIMFace.Community.SDK.NET開源位址：https://gitee.com/NAlps/BIMFace.SDK
系列部落格：https://www.cnblogs.com/SavionZhang/p/11424431.html
系列視訊：https://www.cnblogs.com/SavionZhang/p/14258393.html
2、ZCN.NET.Common開源位址：https://gitee.com/NAlps/zcn.net.common
技術棧
1、Visual Studio、.C#/.NET、.NET Core、MVC、Web API、RESTful API、gRPC、SignalR、Python
2、jQuery、Vue.js、Bootstrap
3、資料庫：SQLServer、MySQL、PostgreSQL、Oracle、SQLite、Redis、MongoDB、ElasticSearch、TiDB、達夢DM、人大金倉、 神通、南大通用 GBase、華為 GaussDB 、騰訊 TDSQL 、阿裡 PolarDB、螞蟻金服 OceanBase、東軟 OpenBASE、浪潮雲溪資料庫 ZNBase
4、ORM：Dapper、Entity Framework、FreeSql、SqlSugar、分庫分表、讀寫分離
5、架構：領域驅動設計 DDD、ABP
6、環境：跨平台、Windows、Linux（CentOS、麒麟、統信UOS、深度Linux）、maxOS、IIS、Nginx、Apach
7、移動App：Android、IOS、HarmonyOS、微信、小程式、快應用、Xamarin、uni-app、MUI、Flutter、Framework7、Cordova、Ionic、React Native、Taro、NutUI、Smobiler
雲原生、微服務、Docker、CI/CD、DevOps、K8S；
Dapr、RabbitMQ、Kafka、分布式、大資料、高并發、負載均衡、中間件、RPC、ELK；
.NET + Docker + jenkins + Github + Harbor + K8S；
出處：www.cnblogs.com/SavionZhang
作者：張傳甯 微軟MCP、系統架構設計師、系統內建項目管理工程師、科技部創新工程師。
專注于微軟.NET技術(.NET Core、Web、MVC、WinForm、WPF)、通用權限管理系統、工作流引擎、自動化項目(代碼)生成器、SOA 、DDD、 雲原生(Docker、微服務、DevOps、CI/CD）；PDF、CAD、BIM 審圖等研究與應用。
多次參與電子政務、圖書教育、生産制造等企業級大型項目研發與管理工作。
熟悉中小企業軟體開發過程：需求分析、架構設計、編碼測試、實施部署、項目管理。通過技術與管理幫助中小企業快速化實作網際網路技術全流程解決方案。
本文版權歸作者和部落格園共有，歡迎轉載，但未經作者同意必須保留此段聲明，且在文章頁面明顯位置給出原文連接配接，否則保留追究法律責任的權利。
如有問題，可以通過郵件[email protected]聯系。共同交流、互相學習。
如果您覺得文章對您有幫助，請點選文章右下角【推薦】。您的鼓勵是作者持續創作的最大動力！