Sky Layer
A spherical dome around the map that is always rendered behind all other layers.
Warning: As of v10.6.0, Atmosphere is the preferred method for atmospheric styling. Sky layer is not supported by the globe projection, and will be phased out in future major release.
See also
Parameters
the ID of the layer, by default, a random id will be generated with UUID.
A color used to tweak the main atmospheric scattering coefficients. Using white applies the default coefficients giving the natural blue color to the atmosphere. This color affects how heavily the corresponding wavelength is represented during scattering. The alpha channel describes the density of the atmosphere, with 1 maximum density and 0 no density. Default value: "white".
A color applied to the atmosphere sun halo. The alpha channel describes how strongly the sun halo is represented in an atmosphere sky layer. Default value: "white".
Position of the sun center a azimuthal angle, p polar angle. The azimuthal angle indicates the position of the sun relative to 0 degree north, where degrees proceed clockwise. The polar angle indicates the height of the sun, where 0 degree is directly above, at zenith, and 90 degree at the horizon. When this property is ommitted, the sun center is directly inherited from the light position. Minimum value: 0,0. Maximum value: 360,180.
Intensity of the sun as a light source in the atmosphere (on a scale from 0 to a 100). Setting higher values will brighten up the sky. Default value: 10. Value range: 0, 100
Defines a radial color gradient with which to color the sky. The color values can be interpolated with an expression using sky-radial-progress
. The range 0, 1 for the interpolant covers a radial distance (in degrees) of 0, `sky-gradient-radius` centered at the position specified by sky-gradient-center
. Default value: ["interpolate","linear","sky-radial-progress",0.8,"#87ceeb",1,"white"].
Position of the gradient center a azimuthal angle, p polar angle. The azimuthal angle indicates the position of the gradient center relative to 0 degree north, where degrees proceed clockwise. The polar angle indicates the height of the gradient center, where 0 degree is directly above, at zenith, and 90 degree at the horizon. Default value: 0,0. Minimum value: 0,0. Maximum value: 360,180.
The angular distance (measured in degrees) from sky-gradient-center
up to which the gradient extends. A value of 180 causes the gradient to wrap around to the opposite direction from sky-gradient-center
. Default value: 90. Value range: 0, 180
The opacity of the entire sky layer. Default value: 1. Value range: 0, 1
Defines the transition of skyOpacity. Default value: 1. Value range: 0, 1
The type of the sky Default value: "atmosphere".
Whether this layer is displayed. Default value: "visible".
The minimum zoom level for the layer. At zoom levels less than the minzoom, the layer will be hidden. Value range: 0, 24
The maximum zoom level for the layer. At zoom levels equal to or greater than the maxzoom, the layer will be hidden. Value range: 0, 24
Layer to use from a vector tile source. Required for vector tile sources; prohibited for all other source types, including GeoJSON sources.
An expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The ["feature-state", ...]
expression is not supported in filter expressions. The ["pitch"]
and ["distance-from-center"]
expressions are supported only for filter expressions on the symbol layer.