经纬志
首页 / Cesium / 使用示例

CZML 加载模型

用 CZML 描述模型的地址与位置,交给 CzmlDataSource 生成实体。

CesiumJS 1.121 · 更新 2026-10-28
源码与运行效果
运行效果

CZML 是一种 JSON 描述

每条 position、model 都对应实体的同名属性。CzmlDataSource.load 把 JSON 解析成实体,加进 dataSources 后就能参与渲染与拾取。

模型字段

gltf 是地址,可以是远程文件、data URL 或示例里的 Blob URL;scale 是整体缩放,minimumPixelSize 保证远距离时不会缩成一个点。

CZML 字段含义备注
model.gltf模型地址支持 data URL
model.scale缩放倍数模型单位是米
model.minimumPixelSize最小屏幕尺寸防止远处消失

CZML 的坐标顺序是 [经度, 纬度, 高度],没有 cartographicDegrees 前缀时会被当成其他格式解析。