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

按距离显示

用 DistanceDisplayCondition 给标注设置可见距离区间,按缩放层级分流。

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

距离是怎么量的

距离取相机到实体的直线距离,不是到地表的垂直高度。飞行中相机位置连续变化,标签会按区间自动淡入淡出。

用在哪

地标分级、POI 近处显示详情、远处只显示区域名。相比手动监听相机再改 show,距离条件由 Cesium 在渲染时判断,不会漏帧。

参数单位说明
near米小于该距离不显示
far米大于该距离不显示
适用范围—point / label / billboard / 面

区间之间留一点重叠可以避免临界距离时标签闪烁,示例里相邻区间首尾相接,快速缩放时能看到一瞬的替换。