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

实体贴地

用 CLAMP_TO_GROUND 让标注忽略自身高度,始终贴在球面上。

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

贴地在哪里生效

点、标注、广告牌、折线都有 heightReference 或 clampToGround。贴地对象在渲染时按地表高度重算位置,位置里的高度被忽略。

遮挡问题

贴地对象容易被地形或建筑挡住。disableDepthTestDistance 设为无穷大可以始终可见,适合做城市名标注,不适合需要真实遮挡的物体。

设置对象说明
heightReferencepoint / label / model贴地或相对地面
clampToGroundpolyline / polygon贴合地表
disableDepthTestDistance标注类是否穿透遮挡

贴地标注在相机转到地球背面时仍然会绘制,需要配合 DistanceDisplayCondition 或可见性判断。