系列目录     [已更新最新开发文章,点击查看详细] 本文详细介绍如何获取BIMFACE平台中所有上传过的文件信息列表. 请求地址:GET https://file.bimface.com/files 说明:根据多种查询条件获取文件详细信息列表,支持分页 参数: 请求 path(示例):https://file.bimface.com/files 请求 header(示例):"Authorization: Bearer dc671840-bacc-4dc5-a134-97c1918d664b&…

在<C#开发BIMFACE系列4 服务端API之源上传文件>.<C#开发BIMFACE系列5 服务端API之文件直传>两篇文章中详细介绍了如何将本地文件上传到BIMFACE服务器及BIMFACE后台的分布式存储系统中.文件上传成功后,BIMFACE的服务会返回与该文件相关的信息,如下图: 开发者在成功上传了文件并获得相关文件信息后,可以将信息保存到数据库中供后续的业务开发使用. 除此之外,BIMFACE平台还提供了单独的服务用于获取文件信息.获取文件信息列表.获取文件上传的状态信息…

系列目录     [已更新最新开发文章,点击查看详细] 在BIMFACE控制台上传文件,上传过程及结束后它会自动告诉你文件的上传状态,目前有三种状态:uploading,success,failure.即上传中.上传成功.上传失败. 如果是通过调用服务接口来上传文件,上传结束后也可以再调用BIMFACE提供的“获取文件上传状态信息”接口来查询状态. 下面详细介绍如何获取文件上传状态信息. 请求地址:GET https://file.bimface.com/files/{fileId}/uploa…

系列目录     [已更新最新开发文章,点击查看详细] BIMFACE最核心能力之一是工程文件格式转换.无需安装插件,支持数十种工程文件格式在云端转换,完整保留原始文件信息.开发者将告别原始文件解析烦恼,数据抽取全部自动完成.BIMFACE目前能够解析38种常见工程图纸和模型,具体包括:rvt.rfa.rte.skp.nwd.nwc.ifc.dwg.dxf.3dm.stl.dgn.stp.3ds.obj.dae.ply.fbx.dwf.gmp.gtj.gbq.gcl.ggj.gqi.gdq.gj…

系列目录     [已更新最新开发文章,点击查看详细] 通过BIMFACE控制台或者调用服务接口上传文件成功后,默认场景下需要下载该源文件,下载文件一般需要知道文件的下载链接即可.BIMACE平台提供了“获取文件下载链接”的服务接口.下面详细介绍其使用方法. 请求地址:GET https://file.bimface.com/download/url 说明:应用通过该接口获取文件的下载地址,然后下载文件.下载地址有效时间是5分钟. 参数: 请求 path(示例):https://file.bim…

系列目录     [已更新最新开发文章,点击查看详细] BIMFACE 平台为开发者提供了大量的服务器端 API 与 JavaScript API,用于二次开发 BIM 的相关应用. BIMFACE 所有的 RESTful API 都有对应的鉴权机制保护,目前 BIMFACE 支持两种鉴权方式: Access token 代表自身应用的身份,使用应用的 appkey, secret,通过调用/oauth2/token接口获取. View token 代表对单个模型/集成模型/模型对比的访问权限,…

系列目录     [已更新最新开发文章,点击查看详细] 在上一篇<C#开发BIMFACE系列16 服务端API之获取模型数据1:查询满足条件的构件ID列表>中介绍了获取单文件(模型)的所有构建ID列表.每个构建由多种材质组成,本文介绍获取单个构建ID的材质列表. 请求地址:GET https://api.bimface.com/data/v2/files/{fileId}/elements/{elementId}/materials 说明:根据单个构建ID获取其所有材质 参数: 请求 path…

系列目录     [已更新最新开发文章,点击查看详细] 本篇主要介绍如何获取单文件/模型下单个构建的属性信息. 请求地址:GET https://api.bimface.com/data/v2/files/{fileId}/elements/{elementId} 说明:支持查询模型属性重写后构件的属性,需要设置请求参数includeOverrides的值为true 参数: 请求 path(示例):https://api.bimface.com/data/v2/files/12112233820…

系列目录     [已更新最新开发文章,点击查看详细] 在前几篇博客中介绍了一个三维文件/模型包含多个构建,每个构建又是由多种材质组成,每个构建都有很多属性.不同的构建也有可能包含相同的属性. 上图中可以看到构建1与构建2拥有相同的属性2,构建2与构建n拥有相同的属性1. 本文主要介绍如何获取多个构建的共同属性. 请求地址:GET https://api.bimface.com/data/v2/files/{fileId}/commonElementProperties 说明:若传入的eleme…

系列目录     [已更新最新开发文章,点击查看详细] 一个文件/模型中可能包含多个楼层信息,获取楼层信息对于前端页面的动态展示非常有帮助.本篇介绍获取一个文件/模型中可能包含多个楼层信息的详细方法. 请求地址:GET https://api.bimface.com/data/v2/files/{fileId}/floors 说明:获取单个模型的所有楼层信息 参数: 请求 path(示例):https://api.bimface.com/data/v2/files/121122338206496…

系列目录     [已更新最新开发文章,点击查看详细] 大厦建筑模型中,基本上包含多个楼层,每个楼层包含多个房间等信息.在<C#开发BIMFACE系列21 服务端API之获取模型数据6:获取单模型的楼层信息>中介绍了如何获取一个模型中包含的楼层信息.面积分区.房间等信息.本篇主要介绍如何获取单个模型中单个房间信息. 请求地址:GET https://api.bimface.com/data/v2/files/{fileId}/rooms/{roomId} 说明:获取单个模型种单个房间信息 参数…

系列目录     [已更新最新开发文章,点击查看详细] 在<C#开发BIMFACE系列22 服务端API之获取模型数据7:获取多个模型的楼层信息>中,返回的楼层信息结果中包含了楼层的具体信息,其中包含楼层ID. 一个楼层中可能包含多个面积分区,本文介绍如何获取楼层对应面积分区列表. 请求地址:GET https://api.bimface.com/data/v2/files/{fileId}/areas 说明:获取单个模型中单个楼层对应的分区列表. 参数: 请求 path(示例):https:…

系列目录     [已更新最新开发文章,点击查看详细] 在<C#开发BIMFACE系列21 服务端API之获取模型数据6:获取单模型的楼层信息>中介绍获取单个模型的所有楼层信息.某些场景下根据需要也可以一次性获取多个模型的楼层信息. 请求地址:GET https://api.bimface.com/data/v2/files/{fileIds}/fileIdfloorsMappings 说明:一次性查询多个模型的楼层信息 参数: 请求 path(示例):https://api.bimface.…

系列目录     [已更新最新开发文章,点击查看详细] 在<C#开发BIMFACE系列25 服务端API之获取模型数据9:获取楼层对应面积分区列表>一文中介绍了如何获取单个模型中单个楼层包含的面积分区列表.有了面积分区列表之后,即可查询单个面积分区的具体信息. 请求地址:GET https://api.bimface.com/data/v2/files/{fileId}/areas 说明:获取单个模型中单个面积分区包含的信息 参数: 请求 path(示例):https://api.bimfac…

系列目录     [已更新最新开发文章,点击查看详细] 在<C#开发BIMFACE系列18 服务端API之获取模型数据3:获取构件属性>中介绍了获取单个文件/模型的单个构建的属性,本篇介绍如何一次性获取多个构建的属性. 请求地址:POST https://api.bimface.com/data/v2/files/{fileId}/elements 说明:支持查询模型属性重写后多个构件的属性,需要设置请求参数includeOverrides的值为true 参数: 其中 ElementPrope…

系列目录     [已更新最新开发文章,点击查看详细] 在<C#开发BIMFACE系列3 服务端API之获取应用访问凭证AccessToken>中详细介绍了应用程序访问API的令牌凭证.我们知道 Access token 代表自身应用的身份,使用应用的 appkey, secret,通过调用/oauth2/token接口获取.BIMFACE所有的接口调用都需要传递 Access token . 本篇主要介绍 ViewToken. View token 代表对单个模型/集成模型/模型对比的访问权…

系列目录     [已更新最新开发文章,点击查看详细] 在<C#开发BIMFACE系列12 服务端API之文件转换>中详细介绍了7种文件转换的方法.发起源文件/模型转换后,转换过程可能成功也可能失败.那么在这种情况下就需要查询源文件/模型的转换状态.一共有三种方式可以知道转换是否成功. 第一种:调用文件转换接口 https://api.bimface.com/translate,该接口的返回结果中包含转换结果信息. 第二种:调用文件转换接口 https://api.bimface.com/tr…

系列目录     [已更新最新开发文章,点击查看详细] 源文件/模型转换完成之后,可以获取模型的具体数据.本篇介绍根据文件ID查询满足条件的构件ID列表. 请求地址:GET https://api.bimface.com/data/v2/files/{fileId}/elementIds 说明:根据六个维度(专业,系统类型,楼层,构件类型,族,族类型)获取对应的构件ID列表,任何维度都是可选的. 构件ID分页查询相关请参考这里 同时,也支持根据空间关系从房间计算出房间内的构件ID列表 构件与房间…

系列目录     [已更新最新开发文章,点击查看详细] BIMFACE官方示例中,加载三维模型后,模型浏览器中左上角默认提供了“目录树”的功能,清晰地展示了模型的完整构成及上下级关系. 本篇介绍如何获取单个模型的构件分类树信息. 请求地址:POST https://api.bimface.com/data/v2/files/{fileId}/tree 说明:单模型构件分类树, treeType 接受两个值:default 和 customized,默认为 default. v参数用来区别 tre…

系列目录     [已更新最新开发文章,点击查看详细] 一个三维模型中可能包含对应多张二维图纸列表,本篇主要介绍如何获取模型文件对应的图纸列表. 请求地址:GET https://api.bimface.com/data/v2/files/{fileId}/drawingsheets 说明:获取单个模型文件对应的图纸列表.如果请求参数elementId为null,返回所有图纸,否则返回包含该构件的所有图纸. 参数: 请求 path(示例):https://api.bimface.com/data…

系列目录     [已更新最新开发文章,点击查看详细] 本篇主要介绍如何获取一个模型中包含的三维视点或二维视图列表. 请求地址:GET https://api.bimface.com/data/v2/files/{fileId}/views 说明:获取单模型中包含的三维视点或二维视图列表. 参数: 请求 path(示例):https://api.bimface.com/data/v2/files/1211223382064960/views 请求 header(示例):"Authorizatio…

系列目录     [已更新最新开发文章,点击查看详细] 在Revit等BIM设计工具中可以给模型的某个部位添加链接信息.即类似于在Office Word.Excel 中给一段文字添加本地文件链接或者网址链接等类似功能.例如下面的一个RVT模型种包含了2个链接. 下面详细介绍如何获取单个模型包含的所有链接信息. 请求地址:GET https://api.bimface.com/data/v2/files/{fileId}/links 说明:获取一个模型种包含的所有链接信息 参数: 请求 path(…

系列目录     [已更新最新开发文章,点击查看详细] 通过BIMFACE控制台或者调用服务接口上传文件成功后,如果不再需要该文件,则可以通过BIMFACE平台提供的“源文件删除”服务接口删除具体的文件.下面详细介绍其使用方法. 请求地址:DELETE https://file.bimface.com/file 说明:根据文件ID删除文件 参数: 请求 path(示例):https://file.bimface.com/file?fileId=1418750515413120 请求 header…

系列目录     [已更新最新开发文章,点击查看详细] 上一篇<C#开发BIMFACE系列13 服务端API之获取转换状态>中介绍了根据文件ID查询单个文件的转换状态. 本文介绍批量获取转换状态详情. 请求地址:POST https://api.bimface.com/translateDetails 说明:应用发起转换以后,可以根据筛选条件,通过该接口批量查询转换状态详情 参数: 请求 path(示例):https://api.bimface.com/translateDetails 请求…

在注册成为BIMFACE的应用开发者后,要能在浏览器里浏览你的模型或者获取你模型内的BIM数据, 首先需要把你的模型文件上传到BIMFACE.根据不同场景,BIMFACE提供了丰富的文件相关的接口. 文件相关所有接口都需要提供有效的Access token.不支持View token. 方式一:普通文件流上传 请求地址:PUT https://file.bimface.com/upload 说明:使用普通文件流上传,不支持表单方式:文件流需要在request body中传递. 参数: 内容类型(…

系列目录     [已更新最新开发文章,点击查看详细] 在实际项目中,由于需求变更经常需要对模型文件进行修改.为了便于用户了解模型在修改前后发生的变化,BIMFACE提供了模型在线对比功能,可以利用在线的模型对比接口,通过简单的四个步骤实现模型在线对比.模型对比可以对两个文件/模型进行差异性分析,确定两个文件/模型之间构件的几何和属性差异,包括增加的构件.删除的构件和修改的构件. 模型对应可以用于进行文件/模型的版本对比. 特别说明:模型对比是在BIMFACE云端进行的,通常需要5~10分钟.当…

系列目录     [已更新最新开发文章,点击查看详细] 在上一篇<C#开发BIMFACE系列30 服务端API之模型对比1:发起模型对比>中发起了2个模型对比,由于模型对比是在BIMFACE云端进行的,通常需要5~10分钟.当模型对比完成后,BIMFACE通过回调机制通知对比结果. 特别说明:BIMFACE可以通过回调机制将模型/文件转换.对比等耗时操作结果通知开发者.该方案与微信开发类似,需要开发者提供开发者服务器,并且该服务器对外公布一个外网地址,BIMFACE能访问到该地址才可以.如果没…

系列目录     [已更新最新开发文章,点击查看详细] 在<C#开发BIMFACE系列31 服务端API之模型对比2:获取模型对比状态>中介绍了根据对比ID,获取一笔记录的对比状态.由于模型对比是在BIMFACE云端进行的,通常需要5~10分钟,在等待对比的过程中还可以发起更多的模型对比,最后通过接口一次性批量获取模型对比状态 . 该功能与BIMFACE控制台中“图模对比”功能相同 请求地址:POST https://api.bimface.com/compares 说明:应用发起对比以后,可…

BIMFACE二次开发系列目录     [已更新最新开发文章,点击查看详细] 随着建筑信息化模型技术的发展,越来越多的人选择在云端浏览建筑模型.现阶段的云端模型浏览大多是基于文件级别,一次只可以浏览一个模型文件中的内容.而在工程项目模型设计的过程中,通常由多个设计师协同设计,不同的设计师负责不同的专业领域(例如建筑.结构.水电等).如果想要在云端浏览整个项目工程,就需要把这些组成部分集成起来一起展示.更近一步,如果要在集成的模型之上进行业务集成的话,就要求在集成过程中对构件按单体,楼层,专业,构…

BIMFACE二次开发系列目录     [已更新最新开发文章,点击查看详细] 在建筑施工图审查系统中,设计单位提交设计完成的模型/图纸,审查专家审查模型/图纸.审查过程中如果发现不符合规范的地方,则流程退回到设计单位,设计单位人员根据审查意见重新调整设计,调整完成后再次提交到审查专家.此时为了便于专家审查,需要知道当前轮次的模型/图纸与上一轮次的模型/图纸发生了哪些异动,针对异动情况进行审查即可. 先看效果 效果如上图.左侧是当前审查轮次的模型,中间是上一轮次的模型,右侧是2个模型的对比产生的异…