上传模型

概述

本节内容将使用 postman 作为客户端工具访问 BIMBase云平台（OBV）平台的服务来完成一个常用的场景：上传一个文件并在浏览器中浏览查看该文件。如果使用其他的开发技术（Java, JavaScript，.net, PHP）等，可以参考本文档中的逻辑。postman 是一款开发人员常用的测试接口请求的工具，虽然您可从https://www.getpostman.com 下载该程序，我们依然推荐您使用 chrome 浏览器，下载并安装 postman 插件。

步骤 1 获取开发账号

开发账号是指访问构力云开放服务时使用的 client_id 和 client_secret，具体使用参考步骤 2。我们提供两种方式获取构力公有部署的开发账号。一种是线上的自主申请开发账号，可以满足试用用户的基本需求，我们推荐试用用户能进行自主申请；另一种是一个线下商谈的过程，线下申请的用户属于商业用户，拥有更大的空间容量以及大文件上传的权限，单个文件上传最大可达 5G，如需要，请与我们联系，我们会为每个授权的二次开发用户分配一个开发账号。在私有部署情况下，我们会给私有部署的 BIMBase云平台（OBV）平台内置一个唯一的开发账号，开发人员只需使用这个内置账号访问即可。

步骤 2 获取访问令牌

在每次访问 BIMBase云平台（OBV）平台的任何服务时，需要传入一个访问令牌（access token，以下简称令牌或 token）。该令牌是通过调用认证服务的 API 获得，且每半小时需要刷新一次。获取令牌时，需要将开发账号（client_id 和 client_secret）传入。具体的请求可以从BIMBase云平台（OBV）服务端 API中获得。

请求的 url 为：https://api.cloud.pkpm.cn/bimserver/auth/oauth/token

获取 token 时的参数设置，选择 POST 请求，Content-Type 为 application/x-www-form-urlencoded。

获取token-设置请求头

POST 请求提交数据的方式选择 x-www-form-urlencoded，在 Body 中传入 client_id、client_secret、grant_type 类型，grant_type 类型为 client_credentials。

获取token-请求参数

其中，client_id 和 client_secret 是开发账号的用户 ID 和密码，请在实际系统中替换成自己的开发账号，否则数据可能会丢失。https://api.cloud.pkpm.cn是 BIMBase云平台（OBV）平台的官方站点，供客户二次开发用户使用。如果在私有环境下部署 BIMBase云平台（OBV）平台，需要将此地址改为实际的部署地址，如”192.168.10.122”, 并且因没有浏览器认可的签名而须使用 http 协议。

调用成功以后，BIMBase云平台（OBV）平台将返回如下的 json 数据，后面的请求中均需要将此 token 传入。

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzY29wZSI6WyJyZWFkIiwid3JpdGUiXSwiZXhwIjoxNTQwMjQ2MDMxLCJqdGkiOiJiYTE4MDNhMy1jYzk5LTQ0NGItYmFhYi0zOGM3MGFmZWZmY2IiLCJjbGllbnRfaWQiOiJhZWN3b3Jrcy1vYnYtY29tbXVuaXR5In0.N-3BPoScBW76c34tUjwDV_f4tF3RbHqwZimFKmvR87GdBn3X07_cT395nzcnuynINKoKNSw_aDpcqFa0Kw5kzx7vlbJ8Ol5ZOPfkbB5x423fFn2roTp0uQ4uMF_L4i08NNkkQ-SV4OZ-_VfrgukMeo66r7ILer0oy5YNlQxNB7CrvUjiTqcSe4Q2MHSNRw9DPy5YMujJ5GClaFOI9KrVoVdKKukFDc665skWJ1Zn965nhavjfyGcZKoHwW6A5rbRvlYkKhobuTb23VNnvILAySFhVM4lq7Hthhlc3TCJ-EhP3MDGWNrlcJcDy92Iszdt9e-gcn5gmAzRw59gQF-31w",
  "token_type": "bearer",
  "expires_in": 43199,
  "scope": "read write",
  "jti": "ba1803a3-cc99-444b-baab-38c70afeffcb"
}

其中，eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...即为访问令牌（注：由于使用了 JWT 规范，对 JWTtoken 进行解析，可以获取到 access token 的详细信息）；43199 是有效时间，单位为秒。后面的示例中将会使用该 token，但是在实际使用的过程中，需要替换成有效的 Token。

步骤 3 获取所有的 Bucket_key

bucket_key 是上传文件的存储容器，下面的方法展示如何获取当前开发账号下已有的所有 bucket_key。用户在创建新的 bucket_key 时应注意不要与已有的 bucket_key 重复。

请求的 url 为：https://api.cloud.pkpm.cn/bimserver/storage/v3/buckets

选择 GET 请求，Content-Type 为 application/json，在 Header 中 Authorization 字段中传入步骤二中所获取到的 token（前面需要加上 Bearer 字符串）。

获取所有bucket_key

成功后返回如下结果，从结果中可以看出，目前 aecworks-obv-community 这个账号中存在两条 bucket_key 相关的记录，translation_result 是在申请 client 信息的时候系统默认创建的，为了存储模型的转换结果，建议上传的模型文件存储到自定义的 bucket 下，而不要放到该 bucket 下。

获取所有bucket_key的返回结果

步骤 4 获取所有的文件转换类型

OBV 对于模型加载有两种方式，全量加载与流式加载。

全量加载：传统轻量化加载方式，在加载全量的模型数据后再展示模型，之后的模型浏览操作将不会再额外加载模型几何数据，整体浏览体验较好，但模型前期的加载时间则会偏长。

流式加载：LOD 加载方式，模型数据以瓦片形式组织。流式加载会大幅提升模型加载的速度及浏览性能。

两种加载方式对应两种转换方式，全量转换与流式转换(LOD)。

接口类型	适用场景
获取所有支持的文件转换类型	仅适用于全量转换，不推荐使用
获取所有支持的文件转换类型,支持一种文件类型匹配多种转换器	既适用于全量转换，也适用于流式/LOD 转换，推荐使用

（1）获取所有支持的文件转换类型 (仅适用于全量转换，旧版接口,不建议使用)

BIMBase云平台（OBV）对于不同类型的文件提供了不同的转化机制，通过以下接口可以获得 BIMBase云平台（OBV）支持的文件转化类型。

请求的 url 为：https://api.cloud.pkpm.cn/bimserver/translation/v3/filetypes

选择 GET 请求方式，获取 filetypes 的接口是公开的，此处不需要传入 token。

成功后返回如下结果，通过返回结果可以查询到不同文件格式对应的转化类型。

{
  "converters": {
    "rvt": "rvt-obv",
    "rfa": "rfa-obv",
    "rte": "rte-obv",
    "nwd": "nwd-obv",
    "nwc": "nwc-obv",
    "pmodel": "pmodel-obv",
    "dwg": "dwg-obv",
    "dxf": "dxf-obv",
    "imodel": "imodel-obv",
    "dgn": "dgn-obv",
    "xdb": "xdb-obv",
    "xdbd": "xdbd-obv",
    "dwf": "dwf-obv",
    "dwfx": "dwf-obv",
    "skp": "skp-obv",
    "ifc": "ifc-obv",
    "obj": "obj-obv",
    "dae": "dae-obv",
    "3ds": "3ds-obv",
    "fbx": "fbx-obv",
    "step": "step-obv",
    "stl": "stl-obv",
    "ipt": "ipt-obv",
    "sldprt": "sldprt-obv",
    "CATPart": "catpart-obv",
    "rvm": "rvm-obv",
    "3dm": "3dm-obv",
    "prj": "prj-obv",
    "dri": "dri-obv",
    "igs": "igs-obv",
    "iges": "iges-obv",
    "jt": "jt-obv",
    "rcs": "rcs-obv",
    "rcp": "rcp-obv",
    "sat": "sat-obv",
    "wrl": "wrl-obv",
    "wrz": "wrz-obv",
    "gltf": "gltf-obv",
    "xgl": "xgl-obv",
    "ms3d": "ms3d-obv",
    "x3d": "x3d-obv",
    "doc": "doc-obv",
    "docx": "docx-obv",
    "xls": "xls-obv",
    "xlsx": "xlsx-obv",
    "csv": "csv-obv",
    "ppt": "ppt-obv",
    "pptx": "pptx-obv",
    "pdf": "pdf-obv",
    "mpp": "mpp-obv",
    "mpt": "mpt-obv",
    "vsd": "vsd-obv",
    "xml": "xml-obv",
    "htm": "html-obv",
    "html": "html-obv",
    "txt": "txt-obv",
    "xps": "xps-obv",
    "oxps": "oxps-obv",
    "jpg": "jpg-obv",
    "jpeg": "jpeg-obv",
    "bmp": "bmp-obv",
    "png": "png-obv",
    "gif": "gif-obv",
    "tiff": "tiff-obv",
    "t": "pkpmt-obv",
    "bims": "bims-obv",
    "jws": "jws-obv",
    "jwd": "jws-obv",
    "obm": "obm-obv",
    "obmx": "obmx-obv",
    "bdls": "bdls-obv",
    "gim": "gim-obv",
    "glb": "glb-obv",
    "p3d": "p3d-obv",
    "bfa": "bfa-obv",
    "stp": "stp-obv",
    "obvzip": "obvzip-lod",
    "lodzip": "lodzip-lod",
    "json": "pilot-calc",
    "test": "test"
  }
}

（2）获取所有支持的文件转换类型,支持一种文件类型匹配多种转换器 (新版接口,建议使用)

为了 LOD 相关操作更加方便，二次开发改进了文件转换的流程。文件加载分为全量加载和流式加载，对应的转换方式分为全量转换与流式转换。

全量转换与流式转换所对应的jobtype是不同的，可以通过如下接口获取：

请求的 url 为：https://api.cloud.pkpm.cn/bimserver/translation/v3/convertertypes，选择GET请求方式，接口是公开的，此处不需要传入token。

成功后返回如下结果，通过返回结果可以查询到不同格式的文件对应的转换类型及相关配置参数。

// 以下只展示部分相关信息
{
  "filetypes": {
    "rvt": {
      "default": "rvt-obv",
      "converters": [
        {
          "name": "rvt-obv",
          "description": null,
          "options": [
            {
              "name": "viewname",
              "valueType": "string",
              "description": "视图名称",
              "selections": [
                {
                  "name": "default",
                  "description": "默认"
                },
                {
                  "name": "${custom}", // ${custom}表示任意字符串
                  "description": "自定义"
                }
              ]
            }
            // 其余配置未展示
            // ...
          ]
        },
        {
          "name": "rvt-lod",
          "description": null,
          "options": [
            // 配置信息未展示
            // ...
          ]
        }
      ]
    }
    // 其余格式未展示
    // ...
  }
}

每个格式对应的 converters 字段中包含该格式可选的转换方式，name 值的后缀为-obv 表示全量，-lod 表示流式。options 字段中包含该格式的转换配置参数。

步骤 5 创建 Bucket

注：Bucket是存储文件的存储容器，为保障文件资源存储信息安全，我们将不提供删除和重名命Bucket接口。请谨慎命名，合理使用本接口！

想要上传文件到 BIMBase云平台（OBV）中，首先需要创建一个储存空间(Bucket，也称“存储桶”)，现在我们创建一个 bucket_key 为 first_bucket 的存储桶。

此处创建名为 first_bucket 的存储桶，请求的 url 为：https://api.cloud.pkpm.cn/bimserver/storage/v3/buckets/first_bucket

选择 POST 请求方式，Content-Type 为 application/json 类型，传入步骤二中所获取到的 token（前面需要加上 Bearer 字符串）。对于存储空间和文件名字的命名，BIMBase云平台（OBV）平台并没有做硬性的规定，您可以使用熟悉的中文字符，但是仍建议您尽量使用英文命名以避免遇到计算机处理中文字符的各种麻烦。

创建bucket

成功后返回如下结果：

创建bucket的返回结果

步骤 6 获取上传的 URL

在上传之前我们需要获取存储文件的实际 URL，使用二次开发账户进行开发的用户传入的参数需包含 type、expire、bucket_key 和 object_key。二次开发用户对应的 type 为 7，expire 为过期时间，单位为秒，一旦超过这个时间步骤 5 中获取到的 signature 就会过期无法上传，所有开发者需要合理设置这个时间。object_key 为创建的容器中文件对象的 key, 需要上传者自己定义。

此处将 objectKey 为 3ds-model 的模型上传到 first_bucket 中，设置过期时间为 60000 秒，请求的 url 为：https://api.cloud.pkpm.cn/bimserver/storage/v3/uploadUrl?type=7&expire=60000&bucketKey=first_bucket&objectKey=first-model

选择 GET 请求方式，传入步骤二中所获取到的 token（前面需要加上 Bearer 字符串）。

获取上传的URL

成功后返回如下结果，请留意其中的 uploadUrl 和 signature 参数，在后面的上传文件步骤中会用到其值：

获取上传的URL的返回结果

步骤 7 上传文件

获取到上传的 URL 之后，我们就可以在“存储桶”里创建一个 object（存储对象），即上传文件。下面示例上传一个名为小别墅示例模型.rvt 的文件。

此处我们在步骤 5 创建的 magical_bucket 中上传一个 rvt 格式的模型文件，上传的 url 为：https://api.cloud.pkpm.cn/zuul/bimserver/storage/v3/buckets/first_bucket/objectt/first-model。其中“zuul/bimserver/storage/v3/buckets/first_bucket/objects/first-model”为步骤6中获取到的uploadUrl。

选择 POST 请求方式，Content-Type 为 application/octet-stream，传入步骤二中所获取到的 token（前面需要加上 Bearer 字符串）。此处的 x-bimserver-upload-url 为自定义的数据类型，要求传入步骤 6 中返回结果的 signature 的值。

上传文件-1

注意：在 body 中请选择 binary 数据类型（不要使用form-data），并选择对应格式的模型文件。

上传文件-1

成功后返回如下结果：

上传文件的返回结果

注意：必须是 "Content-Type: application/octet-stream"。请注意不要与已有的 bucket 重复。

步骤 8 创建转换任务

文件上传成功之后可以请求 BIMBase云平台（OBV）的转换服务对文件进行转换。文件支持全量转换和流式/LOD 转换。大部分三维模型文件都支持全量转换和流式/LOD 转换，极个别格式，如 obvzip 仅支持流式/LOD 转换。

请求的 url 为：https://api.cloud.pkpm.cn/bimserver/translation/v3/jobs?isRegenerated=true

选择 POST 请求方式，Content-Type 为 application/json，传入步骤二中所获取到的 token（前面需要加上 Bearer 字符串）。

（可选） Query 参数，isRegenerated 为 true，表示强制生成新的转换任务，默认 false，推荐 true。

创建转换任务-1

在 body 中携带的参数为一个 JSON 对象，包含具体文件的 urn 和对应文件的转换类型，此处我们上传的是一个 rvt 格式的文件，选择了全量转换，所以 job_type 为'rvt-obv'；如果选择流式转换，则 job_type 为'rvt-lod'。

创建转换任务-2

urn 是指一个源文件(seed) 或某个文件版本在 BIMBase云平台（OBV）平台中的唯一标识。格式为：

urn:bimbox.object:{bucketKey}/{objectKey}

如：

urn:bimbox.object:viewing_bucket/my_special_rvt_model

parameters 字段中包含了该转换方式的配置参数，不同格式文件的转换方式所对应的配置参数(key 与 value)可在步骤四中请求接口的返回值 options 字段中查找。

下面以 rvt 格式与 ifc 格式传入的 parameters 举例。

如果传入的配置参数是非 bool 类型，则需传入一个对象包含 key 字段和 value 字段。例如 rvt 格式的配置参数：

需要注意的是，parameters中每个对象的key值前面需要加上中划线 '-'，为固定写法。如果不传入parameters，或者parameters字段值为null，转换配置则会为默认值。

"parameters":[
  {
    "key":"-viewname",
    "value":"default"
  },
  {
    "key":"-shadetype",
    "value":"shaded"
  },
  {
    "key":"-lod",
    "value":"rough"
  }
]

如果传入的配置参数是 bool 类型，若值为 true，则传入一个对象包含 key 字段；若值为 false，则无需传入该参数。

例如 ifc 格式的配置参数，若合并零件为构件为 true，不导出边线数据为 false，则传入如下参数：

需要注意的是，key值可以为空字符串，也可以不添加该对象参数。

"parameters":[
  {
    "key":"-assembly" // 合并零件为构件为true
  }
]

或者

"parameters":[
  {
    "key":"-assembly" // 合并零件为构件为true
  },
  {
    "key":"" // 不导出边线数据为false
  }
]

成功后返回如下的结果：

创建转换任务-3

步骤 9 查询转换状态

接口类型	适用场景
查询转换状态，支持查询文件的所有转换状态 (推荐)	可同时查询全量转换与流式/LOD 转换的任务转换状态，推荐使用
查询全量转换状态	仅查询全量转换的任务转换状态
查询流式/LOD 转换状态	仅查询流式/LOD 转换的任务转换状态

查询转换状态，支持查询文件的所有转换状态 (推荐)

由于转换过程需要一定时间，客户端可以通过调用下面的 API 来查询一个或多个 Job 的状态。

创建转换任务之后，查询步骤 7 上传的文件的转换状态。请求的 url 为：

https://api.cloud.pkpm.cn/bimserver/translation/v3/jobs/states

选择 POST 请求方式，Content-Type 为 application/json，传入步骤二中获取到的 token（前面需要加上 Bearer 字符串）。

查询转换状态-1

在 body 中携带的参数为一个 JSON 对象，该对象 seeds 字段的值为一个 urn 数组，可以由一个或者多个 urn 组成。

查询转换状态-2

返回值数如下：

查询转换状态-3

每个 urn 对应三种转换方式，obv 表示全量转换，lod 表示流式转换，cal 表示计算相关的转换。

每个转换方式字段中都对应了当前文件最新一次的转换状态及相关信息。如果为 null，则当前文件未进行过相应转换。

每个转换方式字段的值如下：

查询转换状态-4

state 字段标识该任务的状态，converter_meta 字段中包含文件当前的转换配置，reason字段中包含文件转换失败的错误码、错误类型以及详细的错误信息，详细信息包含出错的接口名、具体错误、可能的原因(非必须)。

state	含义
queued	排队等待处理中
busy	正在处理
aborted	失败了，reason 字段有详细的原因
timeout	超时，在指定时间内没有处理完成
complete	成功

查询全量转换状态

客户端也可以通过调用下面的 API 来查询当前 Job 全量转换的状态。

创建转换任务之后，查询步骤 7 上传的文件的转换状态。请求的 url 为：https://api.cloud.pkpm.cn/bimserver/translation/v3/jobs?urn=urn:bimbox.object:first_bucket/first-model

选择 GET 请求方式，Content-Type 为 application/json，dataType 类型为 json，传入步骤二中所获取到的 token（前面需要加上 Bearer 字符串）。

查询转换状态

返回结果能够完整的描述当前 Job 的状态和信息：

查询转换状态

state	含义
queued	排队等待处理中
busy	正在处理
aborted	失败了，reason 字段有详细的原因
timeout	超时，在指定时间内没有处理完成
complete	成功

查询流式/LOD 转换状态

客户端也可以通过调用下面的 API 来查询当前文件的流式转换(LOD)状态。

创建 LOD 转换任务之后，查询 LOD 转换状态。请求的 url 为：https://api.cloud.pkpm.cn/bimserver/translation/v3/jobs?urn=urn:bimbox.object:first_bucket/first-model&jobType=rvt-lod

选择 GET 请求方式，Content-Type 为 application/json，传入步骤二中所获取到的 token（前面需要加上 Bearer 字符串）。

查询LOD转换状态-1

在 params 中传入文件 urn 与 jobType，不同格式文件对应的jobType参考步骤四中的接口二，urn 格式为：

urn:bimbox.object:{bucketKey}/{objectKey}

返回结果能够完整的描述当前 Job 的状态和信息：

查询LOD转换状态-3

state	含义
queued	排队等待处理中
busy	正在处理
aborted	失败了，reason 字段有详细的原因
timeout	超时，在指定时间内没有处理完成
complete	成功

LOD 加载代码参考 https://cloud.pkpm.cn/playground/lod/?sampleID=load3DModel

步骤 10 BIMBase云平台（OBV）嵌入客户系统页面

除了使用 BIMBase云平台（OBV）平台内置视图显示文件的模型数据外，更常用的是将 BIMBase云平台（OBV）视图嵌入 web 页面中浏览。本节演示如何将 BIMBase云平台（OBV）视图嵌入 html 页面以在网页中显示。新版 BIMBase云平台（OBV）（这里指 OBV5.0）中对模型的加载方式做了一些调整，这些改动看起来让人觉得要比之前的加载方式更复杂，但实际上新的加载方式只是将流程分隔开来了，并且提供了更多的可配置选项，让用户有了更高的自由度和灵活度。以下会对 BIMBase云平台（OBV）新的加载方式中涉及到的一些概念做简要解释。

在之前的加载方式中，用户调用 initializeViewer，传入容器 ID，配置选项和相应的回调函数就可以加载模型。在新的加载方式中，加载过程被分成了四步，并且我们提供了一个 ViewerInitializer.js 文件对调用 BIMBase云平台（OBV）的方法做了一些封装，用户只要调用这个包装类中的方法就可以实现 Viewer 的加载和显示。

初始化首先需要在页面中引入 BIMBase云平台（OBV）库文件和对应的样式文件，地址为:

<script
  src="https://api.cloud.pkpm.cn/bimviewer/viewer/v5/obv.js"
  type="text/javascript"
></script>
<link
  rel="stylesheet"
  href="https://api.cloud.pkpm.cn/bimviewer/viewer/v5/obv.css"
  type="text/css"
/>
<link
  href="https://api.cloud.pkpm.cn/bimviewer/viewer/v4/locale/locale.properties"
  rel="resource"
  type="application/l10n"
/>

注意：加载 obv.js 文件后可直接调用 BIMBase云平台（OBV）方法进行操作

第一步：实例化 Builder（new OBV.Api.ObvBuilder），用于模型加载。

第二步：创建 Application (OBV.buildApplication)，一个 Application 可以理解为一个应用，环境中可以同时存在多个 Application 互不干扰。初始化一个应用需要提供相应的上下文信息即 applicationOptions（部署环境 serviceConfig 和用户有效期 getAccessToken）。

第三步：创建 ObvDocument 管理视图（builder.loadDocument），即需要在 BIMBase云平台（OBV）中显示的模型文件，这个模型的文件资源包含在 urn 中，这步工作完成后可以拿到 BIMBase云平台（OBV）对外暴露的 API 对象，此时已经可以对 BIMBase云平台（OBV）进行部分设置和操作了。

第四步：创建 Viewer 容器（builder.buildViewer3d），在 Viewer 中加载视图。

第五步：获取视图(obvDocument.get3dGeometryItems, obvDocument.get2dGeometryItems， obvDocument.getDocItems)，3D 文件、2D 文件和 DOC 模型分别对应着不同的视图。

第六步：加载模型，将模型在 viewer 中显示出来。具体代码参考 https://gitee.com/pkpm/obv-workshop/tree/master/src/examples 中的 01-load-model.html。

使用流行的 WEB 服务器（如 IIS、Apache、Nginx、NodeJS 等）将 obv-simplest-example.html 搭建起来后，使用 Chrome 等支持 WebGL 的浏览器打开 obv-simplest-example.html，将会得到所加载的模型。

最终显示结果

模型对比

若要进行二维模型对比、三维模型对比任务，请在完成创建转换任务之后，参考https://cloud.pkpm.cn/devcenter/help/server-api/docs/Translation/#_12 中步骤11-15。

分片上传

若要分片上传，请在创建Bucket之后、获取上传的URL之前进行。参考https://cloud.pkpm.cn/devcenter/help/server-api/docs/Storage/#_21。

倾斜摄影

倾斜摄影技术通过在飞行平台上搭载多个传感器，分别从一个垂直、四个倾斜、五个不同的视角同步采集影像，获取到丰富的建筑物顶面及侧视的高分辨率纹理。它不仅能够真实地反映地物情况，高精度地获取物方纹理信息，还可通过先进的定位、融合、建模等技术，生成真实的三维城市模型。BIMBase云平台（OBV）中集成了展示倾斜摄影数据的能力，下面将具体介绍通过BIMBase云平台（OBV）实现上传、转换、加载展示倾斜摄影数据的步骤。

倾斜摄影二次开发流程主要分为以下几部分：
1.数据格式处理；
BIMBase云平台（OBV）支持转换、加载原始格式为osgb的倾斜摄影数据，但需要对上传文件进行预处理，来保证文件的流式转换。分为以下两个步骤：
①需要将.osgb文件压缩为.zip文件。
②将.zip文件的后缀名由zip改为osgbzip
后缀修改完成的文件上传、转换后即可正常加载与展示。
2.文件上传；
存储倾斜摄影数据的标准格式是osgbzip，大部分倾斜摄影数据因为包含了大范围地理区域内的地形信息和贴图数据等，导致文件比较大。二次开发用户可以使用以下两种方式上传osgbzip文件：
①通过控制台的上传文件功能上传osgbzip文件
②二次开发用户如果需要在自己的系统中实现上传倾斜摄影数据的功能，需要先集成分片上传的接口，再通过分片上传接口上传大文件。
（一般超过500M的文件直接使用inputFile的方式上传容易出错，推荐使用分片上传）。
3.文件转换；
上传完成后可以对osgbzip文件发起转换，osgbzip的文件转换类型为“osgbzip-lod”，在控制台界面上用户直接点击转换即可，控制台会根据当前的文件类型发起转换。
通过接口调用时，调用文件转换接口发起转换即可。
4.加载倾斜摄影数据；
转换完成后点击查看即可看到相应的倾斜摄影数据了。
若要进行请倾斜摄影高度、经纬度坐标等设置，请在转换完成后，参考倾斜摄影开发文档。
若要查看加载效果，参考加载倾斜摄影代码示例。

概述