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

高度参考

用 heightReference 控制实体高度基准,理解三种模式的差别。

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

三种模式

NONE 用绝对高度,位置里的高度就是离椭球面的米数;CLAMP_TO_GROUND 忽略高度、完全贴地;RELATIVE_TO_GROUND 把高度解释为离地表的偏移。

常见错误

把模型的高度设成 0 又用绝对模式,模型会有一半埋进地里。想让物体站在地面,应使用 CLAMP_TO_GROUND 或给一个正的高度偏移。

模式高度含义典型用途
NONE离椭球面的绝对高度飞行器、卫星
CLAMP_TO_GROUND忽略高度,贴地贴地标牌、覆盖物
RELATIVE_TO_GROUND离地表的偏移建筑、车辆

贴地模式需要地形或椭球支持,贴地对象在地形加载完成后可能会重新计算位置,首次出现的位置会有轻微跳动。