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

CZML 自定义属性

CZML 允许在对象里塞任意字段。示例给每个城市写上人口与等级,点一下就弹出自定义属性。

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

自定义字段放在哪

放在对象顶层即可,Cesium 会把它们收进 entity.properties。字段名不需要注册,读取时用 entity.properties.人口.getValue()。

点击怎么拿到实体

用 ScreenSpaceEventHandler 监听左键点击,scene.pick 拿到最上层的对象,再从 id 上取 properties。没有点中实体时清空面板。

可以直接改的地方

位置改什么效果
properties.人口改成别的字段名面板显示内容
左键点击事件改成 MOUSE_MOVE悬停即显示
infoBoxtrue用内置信息框代替面板

键名要一致:属性名用中文没问题,但取值时要和 CZML 里写的键完全一致。