1. 快速上手

1.1. 整体介绍

更详细的整体流程参考：

以下将部分核心的流程内容进行再次说明。

1.2. 场景三：GIS地图展示BIM模型

1.2.1. BIM模型转GIS模型数据（方法一）

在场景一 的解析模型接口调用时追加参数，可以实现解析模型的同时生成GIS模型。

type: "POST"

url: http://bosgw.bimwinner.com/bos3dengine/api/b69a13caaf25400a9ff1fa64708bd5ec/parses/files

Headers: {
    "Content-Type": "application/json",
    "Authorization": "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyS2V5IjoiMTYwNjA2MTE5IiwidXNlck5hbWUiOiJscmQxMjM0NTYiLCJ1c2VyVHlwZSI6IjAiLCJhcHBLZXkiOiJwYTcwNDkzMzA5MWI0MWQ1ODhhNTZjM2U0ZmQ3OTRkYSIsImFwcE5hbWUiOiJCT1PlrpjnvZFkZW1v5qih5Z6LIiwiYXBwRGIiOiJwYTcwNDkzMzA5MWI0MWQ1ODhhNTZjM2U0ZmQ3OTRkYSIsImxvZ2luVGltZSI6IjE1OTg1MTIxMjY4NzUiLCJleHAiOjB9.4IYQAheRTCD9JPKCv37JMeW9XL9i2hCGRRzpDkIRFF0"
}

Body(form-data): {
    "fileKey":"Z3JvdXAxMixNMzUvMDIvMDQvckJBQUcxOUFrU2FBVXFleUFOYW9raWVYZFdrNjkzLmlmYw==",
    "priority":1,
    "mobile":true   //mobile参数可选，默认为false。当mobile为true时，模型解析成功后系统自动创建一个GEO模型；GEO模型key= "G"+modelKey的数字部分。
}

1.2.2. BIM模型转GIS模型数据（方法二）

通过调用接口来对已解析完成的BIM模型转换生成GIS模型。

根据BIM模型创建GEO模型--接口说明详情

type: "POST"

url: http://bosgw.bimwinner.com/bos3dengine/api/b69a13caaf25400a9ff1fa64708bd5ec/geomodels/bim

Headers: {
    "Content-Type": "application/json",
    "Authorization": "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyS2V5IjoiMTYwNjA2MTE5IiwidXNlck5hbWUiOiJscmQxMjM0NTYiLCJ1c2VyVHlwZSI6IjAiLCJhcHBLZXkiOiJwYTcwNDkzMzA5MWI0MWQ1ODhhNTZjM2U0ZmQ3OTRkYSIsImFwcE5hbWUiOiJCT1PlrpjnvZFkZW1v5qih5Z6LIiwiYXBwRGIiOiJwYTcwNDkzMzA5MWI0MWQ1ODhhNTZjM2U0ZmQ3OTRkYSIsImxvZ2luVGltZSI6IjE1OTg1MTIxMjY4NzUiLCJleHAiOjB9.4IYQAheRTCD9JPKCv37JMeW9XL9i2hCGRRzpDkIRFF0"
}

Body(application/json): {
    "models": [
        "M1598513198962"   //需要填写相应的模型key
    ],
    "name":"办公室模型" ,   //需要填写，名字可以自定义
    "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" 
}

数据返回里的data里的key就是GIS的模型key，以后把BIM模型放到GIS地图上展示时需要用到该key。

1.2.3. 查询GEO模型解析进展

通过上述两个方法中的任何一个，都可以拿到一个很关键的GIS模型key： G1598513198962。可以调用接口查询解析的进度。

查询GEO模型解析进展--接口说明详情

type: "GET"

url: http://bosgw.bimwinner.com/bos3dengine/api/b69a13caaf25400a9ff1fa64708bd5ec/geomodels/status?key=G1598077260624

Headers: {
    Authorization: "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyS2V5IjoiMTYwNjA2MTE5IiwidXNlck5hbWUiOiJscmQxMjM0NTYiLCJ1c2VyVHlwZSI6IjAiLCJhcHBLZXkiOiJwYTcwNDkzMzA5MWI0MWQ1ODhhNTZjM2U0ZmQ3OTRkYSIsImFwcE5hbWUiOiJCT1PlrpjnvZFkZW1v5qih5Z6LIiwiYXBwRGIiOiJwYTcwNDkzMzA5MWI0MWQ1ODhhNTZjM2U0ZmQ3OTRkYSIsImxvZ2luVGltZSI6IjE1OTg1MTIxMjY4NzUiLCJleHAiOjB9.4IYQAheRTCD9JPKCv37JMeW9XL9i2hCGRRzpDkIRFF0"
}

解析进度percentage为100%就代表成功了。

1.2.4. 下载GEO模型数据

要想在GIS地图上加载出BIM模型，就需要下载GIS的模型数据，这里我们需要组装一下下载链接。

type: "GET"

url: http://bosgw.bimwinner.com/bos3dengine/api/b69a13caaf25400a9ff1fa64708bd5ec/geomodels/G1598513198962/data/tileset.json

Headers: {
    Authorization: "eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyS2V5IjoiMTYwNjA2MTE5IiwidXNlck5hbWUiOiJscmQxMjM0NTYiLCJ1c2VyVHlwZSI6IjAiLCJhcHBLZXkiOiJwYTcwNDkzMzA5MWI0MWQ1ODhhNTZjM2U0ZmQ3OTRkYSIsImFwcE5hbWUiOiJCT1PlrpjnvZFkZW1v5qih5Z6LIiwiYXBwRGIiOiJwYTcwNDkzMzA5MWI0MWQ1ODhhNTZjM2U0ZmQ3OTRkYSIsImxvZ2luVGltZSI6IjE1OTg1MTIxMjY4NzUiLCJleHAiOjB9.4IYQAheRTCD9JPKCv37JMeW9XL9i2hCGRRzpDkIRFF0"
}

1.2.5. 加载GEO模型数据

这里我们通过在浏览器打开下面的链接--盈嘉提供的一个简易的GIS模型加载的在线编辑器来加载测试。

点击下面的链接进行跳转打开：

GIS模型加载在线编辑器

在弹出的在线编辑器里，我们把下载GEO模型数据里组装好的url按下图步骤来操作即可实现加载GIS模型。

1.2.6. 场景三总结

通过场景三的学习，我们学会了如何通过BOS的模型数据服务接口来实现BIM模型到GIS模型的转换以及如何加载显示GIS模型到BOSGeo中。

快速上手