Appearance
三维概览
实验功能
三维是实验功能，默认关闭，需要平台开启三维开关（GEOBRIDGE_FEATURE_3D=true，见功能开关）后才能发布、预览与访问三维服务。实验功能的界面与接口在后续版本中可能调整。
平台可以把高程、三维模型、实景三维、点云与高斯泼溅数据发布为服务，在控制台里用 Cesium（或 MapLibre）预览，再用 JS SDK 交给 CesiumJS 或 MapLibre 应用使用。
六类三维服务
| 数据 | 服务类型 | 交给谁用 | 说明 |
|---|---|---|---|
| 栅格地形 | 栅格地形（RasterTerrainServer） | MapLibre 三维地形与山体阴影 | 由单波段高程 GeoTIFF（DEM）按需生成 Terrarium 或 Mapbox 编码的高程切片 |
| 网格地形 | Mesh 地形服务（MeshTerrainServer） | Cesium 场景地形 | 量化网格（quantized-mesh）地形目录，layer.json 加 .terrain 瓦片 |
| 三维模型 | 三维模型服务（3DModelServer） | Cesium、deck.gl | glb / glTF 按逐文件的默认位置（经纬度、高度、朝向、缩放）放置 |
| 3D Tiles | 3D Tiles 服务（Cesium3DTileServer） | Cesium、deck.gl | 实景三维、倾斜摄影（已转为 3D Tiles）、建筑白模等 |
| 点云 | 3D Tiles 服务 | Cesium | LAS / LAZ 发布后由平台转为 3D Tiles 点云，可按 RGB、分类、强度、高程着色 |
| 高斯泼溅 | 三维模型服务 | Cesium 1.146 及以上 | .ply / .splat / .spz 发布后由平台转为高斯泼溅 3D Tiles |
服务地址与二维服务同在 https://map-demo.geobridge.cn/geobridge-mapserver/rest/geodata/services/{服务}/… 之下，例如 3D Tiles 的入口为 …/{服务}/Cesium3DTileServer/tile/tileset.json，网格地形为 …/{服务}/MeshTerrainServer/tile/layer.json。
开启三维开关
自行部署的平台在部署目录的 .env 中设置 GEOBRIDGE_FEATURE_3D=true，执行 docker compose up -d 后刷新浏览器页面，步骤见功能开关。开关关闭时：
- 控制台不显示三维数据源类型、三维发布选项（含「栅格地形」）、服务列表的三维筛选与服务详情里的三维页签；
- 三维服务的全部地址返回 404（
功能未启用），已发布的三维服务与数据保留，再次开启后恢复。
在线系统是否开启三维、提供哪些三维示例服务，以在线系统的实际情况为准。
与二维的关系
- 同一套数据与服务管理：三维数据同样先登记为数据源、准备数据、建图层，再发布为服务；服务的工作空间、成员权限、访问级别（公开、API Key、私有）与 API Key 都和二维一样，见访问级别。
- 可以和二维服务叠加：Cesium 场景里可以把平台的 MapServer 切片作为影像层，再叠加 3D Tiles 与模型；栅格地形直接加到 MapLibre 的二维地图上，配合矢量瓦片或栅格底图使用。
- JS SDK 通用：同一个
client既能加载二维服务，也能用client.cesium加载三维服务，见在 Cesium 中使用 SDK。
接下来
- 发布三维数据：六类数据的格式要求、发布步骤与转换。
- 在控制台预览：Cesium 与 MapLibre 渲染器、初始视角与缩略图、点云着色。
- 在 Cesium 中使用 SDK：引入 CesiumJS 与 SDK，加载地形、3D Tiles、点云、模型与泼溅。
- 三维示例：七个可在在线沙箱里直接运行的示例。示例数据以在线系统实际提供为准，数据来源与许可见示例数据的「三维示例数据」一节。