操作指南
3D Tiles 成果校验与平台接入指南：星火 3D Tiles 模型转换工具成果验收与发布
初版内容
本文正在按正式版本补充截图与参数，界面名称与数值以实际软件为准。
要点速览
3D Tiles 成果是一个以 tileset.json 为入口的目录，必须整体通过 HTTP(S) 服务发布，保持相对路径不变。验收按位置、高度、外观、分级加载四项核对；位置偏差用控制点配准与仿射校正后重新转换。跨域访问需在服务端配置 CORS。
这篇面向负责验收转换成果并把成果接入 GIS 一张图、数字孪生平台的 GIS 工程师与运维人员。读完后你能按清单核对转换成果，并把它正确发布和加载到三维平台。前置条件：已按快速入门完成至少一次转换。
认识 3D Tiles 成果目录 #
3D Tiles 是面向海量三维数据流式加载的开放规范，转换成果是一个目录，而不是单个文件。
| 组成 | 作用 |
|---|---|
| tileset.json | 入口文件，描述瓦片树结构、每个瓦片的包围范围、几何误差和细化方式 |
| 瓦片数据文件 | 各级瓦片的几何与纹理内容，常见为 .b3dm（3D Tiles 1.0）或 .glb（3D Tiles 1.1） |
| 子 tileset 文件（可选） | 大场景下把瓦片树拆分为多个 json，由入口文件引用 |
几个要点：
- tileset.json 通过相对路径引用瓦片文件，移动或发布时必须保持整个目录结构不变；
- 几何误差（geometricError）决定三维引擎在什么距离切换到更精细的层级，这就是“远看简化、近看细节”的分级加载机制；
- 最高精度层级保留原始模型细节，远距离层级的简化是常规做法，不影响近距离查看。
成果校验清单 #
位置 #
- 与底图、影像叠加，检查是否存在整体平移、旋转或比例错误；
- 与已有矢量数据（道路边线、建筑轮廓、管线）叠加，在多个分散位置抽查吻合度；
- 位置偏差较大时，先检查源数据坐标系、带号和原点是否填写正确，再考虑控制点配准。
高度 #
- 模型底部是否与地形贴合，是否整体悬空或下沉；
- 整体偏差通常来自高程基准不一致，可设置高程偏移后重新转换。
外观 #
- 纹理是否完整，有无发黑、错贴或模糊；
- 有无破面、空洞、瓦片之间的接缝；
- 对照源数据，确认没有漏转的区域。
分级加载 #
- 由远及近缩放，各级切换是否平滑，有无明显“跳变”；
- 远距离浏览时是否流畅，近距离细节是否清晰；
- 在目标终端（办公电脑、大屏）和实际网络环境下实测加载体验。
校验结果建议形成记录：数据名称、范围、检查项、问题位置与处理方式，作为成果交付的附件。
位置偏差的处理 #
- 系统性偏移（整体平移固定距离）：多为坐标系、带号或原点填写错误，修正参数后重新转换；
- 整体旋转或比例不对：多为局部坐标未正确定向或单位错误，检查模型单位与朝上轴；
- 局部偏差：使用控制点配准与仿射校正，控制点要均匀分布在模型范围四周；
- 校正后再次与底图叠加抽查，直到偏差满足项目要求。
发布为 HTTP 服务 #
3D Tiles 需要通过 HTTP(S) 访问，不能用浏览器直接打开本地文件。
- 整体部署：把整个成果目录放到 Web 服务器（如 Nginx）或对象存储上，保持相对路径不变；
- 跨域：三维平台与成果不在同一域名、端口时，需要在服务端为成果路径配置 CORS 响应头，否则浏览器会拦截请求；
- MIME 类型：确保 .json、.b3dm、.glb 等文件以正确的类型返回；
- 压缩：如果瓦片文件以 gzip 预压缩方式存储，服务端需返回对应的 Content-Encoding 头，否则浏览器无法解析；
- 缓存：成果发布后一般不再变动，可设置较长的缓存时间；更新成果时建议换新目录或版本号，避免客户端读到旧缓存。
数据不出内网的项目，在内网服务器上发布即可。
接入三维平台 #
接入 GIS 一张图 #
在 GIS 应用与「一张图」平台 中把成果作为三维图层添加，地址指向 tileset.json，再配置图层的显示范围与权限，即可与管网、地块等业务图层叠加分析。
接入 Cesium 生态平台 #
在 Cesium 中通过 Cesium3DTileset 加载 tileset.json 的地址即可。其它基于 Cesium 生态的三维平台与数字孪生平台通常也提供“添加 3D Tiles 图层”的入口。
接入后的复核 #
接入正式平台后再做一次位置和加载体验复核：平台的地形、底图与本地预览环境可能不同，复核能及时发现高程基准或坐标差异。
转换与接入中的其它问题见星火 3D Tiles 模型转换工具常见问题。