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

CZML 广告牌与标签

CZML 里 billboard 和 label 是两套独立图形,可以挂在同一个对象上,位置只写一次。

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

两套图形各自的字段

billboard 关注 image、scale、verticalOrigin;label 关注 text、font、pixelOffset。两者都挂在同一个 position 上,所以标签可以相对图标偏移。

图像从哪来

CZML 的 image 接受 dataURL。示例在页面里用 canvas 画一个圆形标记并转成 dataURL,避免引用外部图片。

可以直接改的地方

位置改什么效果
billboard.scale0.5 到 3图标大小
label.pixelOffset[0, -30]标签位置
label.font任意字号文字大小

像素偏移:标签默认与图标重心重合,把 pixelOffset 的纵坐标设成负值才能把文字抬到图标上方。