1. 根据BIM模型创建GEO模型
根据一个或多个BIM模型创建GEO模型。
请求方式:POST
请求地址:/api/{databaseKey}/geomodels/bim
1.1. 请求参数
Headers:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
Authorization | string | c4570cb9ca324bc8ba7dd9d1967710ea | 是 | 操作的通关令牌 |
PathParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
databaseKey | string | test | 是 | 数据库key,必传 |
SearchParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
无参数 | NULL | NULL | NULL | NULL |
Body
application/json:
{
"models": [
"xxx",
"yyy"
], //BIM模型列表
"components": [
"zzz_1",
"zzz_2"
], //BIM模型构件列表
"name": "xxx" //模型名称(不带扩展名), 必填
"xattr": {
……
},
"docKey": "24543sdfdsfs2s"
}
Body示例:
{
"models": [
"M1590569425723"
],//BIM模型列表
"name": "1号学生公寓", //模型名称(不带扩展名), 必填
"xattr": {
"latitude": 39.749654,
"longitude": 116.283066,
"height": 11,
"heading": 0,
"pitch": 0,
"roll": 0,
"originX": 0,
"originY": 0,
"originZ": 0,
"minGeometricError": 0.001,
"boxRadius2GeometricError": 1,
"nextGeometricErrorFactor": 0.1,
"tileMaxDataSize": 2000000,
"simplifyMesh": "none",
"simplifyFactor": 1,
"forceDoubleSide": false,
"customShader": false,
"light": "default",
"textureGeometricErrorFactor": 16,
"splitPriority": "space",
"splitMaxDataSize": 10000000,
"splitUnit": "mesh",
"colorRatio": 1,
"ratio": 1,
"originUpAxis": "Z",
"reloadBimData": true,
"deleteBimData": true
},
"permission": "public" //权限控制
}
1.2. 参数说明
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
models | 数组 | NULL | 否 | BIM模型列表 |
components | 数组 | NULL | 否 | BIM模型构件列表 |
name | string | NULL | 是 | 模型名称(不带扩展名) |
docKey | string | NULL | 是 | docKey |
1.3. 正确返回
{
"message": "请求处理成功",
"code": "SUCCESS",
"data": {
"key": "GEO模型Key",
"type": "BIM",
"status": "模型当前解析状态",
"remark": "解析状态说明",
"compression": true //当dracoCompression或crnCompression为true时返回true
}
}
1.4. 状态码
状态码 | code | message | data | 原因 |
---|---|---|---|---|
400 | BAD_PARAMETER | 参数models、components不能同时为空 | NULL | 当models、components同时为空时 |
400 | BAD_PARAMETER | 参数models中的key值不能为空 | NULL | 当models中的key存在空值时 |
400 | MODEL_NOT_FOUND | 模型(xxx)不存在 | NULL | 当models中的模型不存在时 |
400 | PARSE_FAILED | 模型(xxx)解析失败 | NULL | 当models中的模型解析已经失败时 |
400 | PARSE_NOT_FINISHED | 模型(xxx)正在解析 | NULL | 当models中的模型解析尚未完成时 |
400 | BAD_PARAMETER | 参数components中的key值不能为空 | NULL | 当components中的key存在空值时 |
400 | COMPONENT_NOT_FOUND | 构件(xxx,yyy,zzz)不存在 | NULL | 当components中的构件不存在时 |
400 | BAD_PARAMETER | BIM模型的几何数据格式不支持 | NULL | 当BIM模型(包括构件对应的模型)的几何数据为不支持的格式时 |
400 | BAD_PARAMETER_TYPE | body类型不正确 | NULL | 当xattr参数中数据类型错误时 |
1.5. 备注
模型解析状态:
0:正在解析
1:解析成功
-1:解析失败
1.6. 注意事项
1、models、components参数指定BIM模型或构件清单,可以同时指定,不能同时为空。
2、BIM模型必须解析成功,几何格式为2.0版。
3、name:GEO模型名称,必填。
4、xattr:GEO模型构建参数,如不指定,则采用上述默认值。参数说明见后附表格。
5、当BIM参数仅为单一BIM模型时,GEO模型key取"G"+modelKey的数字部分,如系统已存在相同key,则自动生成key;
6、docKey为geo模型对应的BOSF文档key,在数据库启用gacl时必填。