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

天空层

白天天蓝、黄昏地平线偏暖、夜间整体压暗,三套预设只改一组颜色与混合系数。 天空在俯仰为 0 时不可见,倾斜后才进入视野。

MapLibre GL JS 4.x · 更新 2026-10-28
源码与运行效果
运行效果

说明

setSky 接受一组样式规范里的天空属性,调用后立即重绘。 三组预设分别覆盖天顶、地平线与雾的颜色,混合系数控制过渡宽度。

天空不是独立图层,而是贴在远景上的效果。俯仰为 0 且缩放较低时, 视锥里没有天空,改配置看不出变化,先把地图倾斜到 45 度以上。

属性默认作用
sky-color#199EF3天顶颜色
sky-horizon-blend0.5天顶到地平线的过渡宽度
horizon-color#ffffff地平线附近的颜色
horizon-fog-blend0.5地平线与雾的融合程度
fog-color#0000ff远处地面的雾色
fog-ground-blend0.5雾与地面的过渡
atmosphere-blend随缩放插值整体氛围强度,夜间可置 1

fog-color 会同时影响远处地面的色调。夜里把雾色调成深蓝, 地面边缘才会像真的融入夜色,而不是被一条硬边切断。

天空效果在移动端会增加片元计算。只在倾斜视角下开启, 平面视图时把 atmosphere-blend 降到 0,可以省下一部分开销。