星火 3D Tiles 模型转换工具快速入门：把倾斜摄影 OSGB 转换为 3D Tiles 并接入一张图

这篇面向第一次使用星火 3D Tiles 模型转换工具的测绘、GIS 和三维可视化人员。读完后你能把一份倾斜摄影 OSGB 成果转换为 3D Tiles，在本地确认效果，并接入 GIS 一张图或其它 Cesium 生态三维平台。前置条件：已获取并安装转换工具（Windows 工作站或内网服务器），手头有一份完整的倾斜摄影成果。界面中各功能的具体名称以你所用版本为准。

第 1 步：检查源数据是否完整 #

目的：转换前确认数据目录和坐标信息齐全，避免转换后才发现错位或缺块。

1. 确认倾斜摄影成果的数据目录完整：通常是一个数据文件夹下按瓦片分成的多个子目录，每个子目录内有若干 .osgb 文件。只拷贝了部分瓦片会导致成果出现空洞。
2. 确认随成果提供的元数据文件（常见为 metadata.xml）存在，其中记录了坐标系（SRS）和模型原点（SRSOrigin）。
3. 记录坐标系信息：是 EPSG 代码、投影坐标还是 ENU 局部坐标，原点是多少。
4. 估算数据量与磁盘空间：输出目录所在磁盘要预留充足空间，建议使用 SSD。

预期结果：拿到一份“数据范围、坐标系、原点、数据量”的简单记录。数据要求详见三维模型数据准备规范。

第 2 步：导入模型并确认坐标设置 #

目的：让工具正确理解模型的坐标，从而把成果放到真实地理位置上。

1. 在工具中新建转换，选择输入类型为倾斜摄影（OSGB），指定数据目录。
2. 检查工具读取到的坐标系和原点是否与第 1 步记录一致。
3. 元数据缺失或模型使用局部坐标时，手动指定坐标系与原点，或准备控制点用于后续配准。
4. 如果目标平台使用的高程基准与模型不同（例如模型使用正常高、平台地形使用椭球高），记下需要的高程偏移，必要时在转换中设置。

预期结果：坐标设置与源数据记录一致。

第 3 步：设置输出并开始转换 #

目的：生成标准 3D Tiles 成果目录。

1. 指定输出目录。建议每份数据单独一个输出目录，目录名体现区域与日期。
2. LOD 分级分块参数第一次使用时保持工具推荐设置即可，工具会按场景体量自动分级。
3. 提交转换任务。多份数据可以依次加入任务队列批量转换，不需要人工盯守。
4. 转换过程中关注任务状态；失败的任务会记录原因，可按原因修正后重新提交。

预期结果：输出目录下生成入口文件 tileset.json 以及若干瓦片数据文件。

第 4 步：本地预览并校验成果 #

目的：确认成果无误后再接入正式平台，避免带着问题上线。

1. 用工具的本地预览功能打开成果。
2. 检查位置：模型是否落在正确的地理位置，与底图、影像或已有矢量数据叠加是否吻合，有无整体平移或旋转。
3. 检查高度：模型是否悬空或陷入地下。
4. 检查外观：纹理是否完整、有无破面、空洞或接缝；由远及近缩放，观察各级细节切换是否自然。
5. 位置有偏差时，使用控制点配准与仿射校正后重新转换。

预期结果：模型位置、高度和外观都符合要求。完整的校验项见3D Tiles 成果校验与平台接入指南。

第 5 步：发布成果并接入三维平台 #

目的：让 GIS 一张图或其它三维平台通过网络加载成果。

1. 把整个输出目录（包括 tileset.json 与全部瓦片文件，保持相对路径不变）放到 Web 服务器或对象存储上，通过 HTTP(S) 访问。不要用浏览器直接打开本地文件。
2. 三维平台与数据不在同一个域名时，在 Web 服务器上配置跨域访问（CORS）。
3. 在目标平台中添加 3D Tiles 图层，地址指向 tileset.json。在 Cesium 中对应 Cesium3DTileset 图层。
4. 在平台中再次核对位置与加载效果。

预期结果：模型在 GIS 一张图或三维平台中正确显示，缩放浏览流畅。

下一步 #

• 不同来源模型的格式、坐标和纹理要求：三维模型数据准备规范
• 成果校验清单与接入常见问题：3D Tiles 成果校验与平台接入指南
• 硬件配置、精度、格式支持等疑问：星火 3D Tiles 模型转换工具常见问题
• 下载产品彩页与数据准备清单：资料下载