Fill Extrusion Layer
An extruded (3D) polygon.
See also
Parameters
the source that drives this layer.
the ID of the layer, by default, a random id will be generated with UUID.
Radius of a fill extrusion edge in meters. If not zero, rounds extrusion edges for a smoother appearance. Default value: 0. Value range: 0, 1
Provides a control to futher fine-tune the look of the ambient occlusion on the ground beneath the extruded buildings. Lower values give the effect a more solid look while higher values make it smoother. Default value: 0.69. Value range: 0, 1
Defines the transition of fillExtrusionAmbientOcclusionGroundAttenuation. Default value: 0.69. Value range: 0, 1
The extent of the ambient occlusion effect on the ground beneath the extruded buildings in meters. Default value: 3. Minimum value: 0.
Defines the transition of fillExtrusionAmbientOcclusionGroundRadius. Default value: 3. Minimum value: 0.
Controls the intensity of shading near ground and concave angles between walls. Default value 0.0 disables ambient occlusion and values around 0.3 provide the most plausible results for buildings. Default value: 0. Value range: 0, 1
Defines the transition of fillExtrusionAmbientOcclusionIntensity. Default value: 0. Value range: 0, 1
Shades area near ground and concave angles between walls where the radius defines only vertical impact. Default value 3.0 corresponds to height of one floor and brings the most plausible results for buildings. This property works only with legacy light. When 3D lights are enabled fill-extrusion-ambient-occlusion-wall-radius
and fill-extrusion-ambient-occlusion-ground-radius
are used instead. Default value: 3. Minimum value: 0.
Defines the transition of fillExtrusionAmbientOcclusionRadius. Default value: 3. Minimum value: 0.
Shades area near ground and concave angles between walls where the radius defines only vertical impact. Default value 3.0 corresponds to height of one floor and brings the most plausible results for buildings. Default value: 3. Minimum value: 0.
Defines the transition of fillExtrusionAmbientOcclusionWallRadius. Default value: 3. Minimum value: 0.
The height with which to extrude the base of this layer. Must be less than or equal to fill-extrusion-height
. Default value: 0. Minimum value: 0.
Defines the transition of fillExtrusionBase. Default value: 0. Minimum value: 0.
The base color of the extruded fill. The extrusion's surfaces will be shaded differently based on this color in combination with the root light
settings. If this color is specified as rgba
with an alpha component, the alpha component will be ignored; use fill-extrusion-opacity
to set layer opacity. Default value: "#000000".
Defines the transition of fillExtrusionColor. Default value: "#000000".
This parameter defines the range for the fade-out effect before an automatic content cutoff on pitched map views. Fade out is implemented by scaling down and removing buildings in the fade range in a staggered fashion. Opacity is not changed. The fade range is expressed in relation to the height of the map view. A value of 1.0 indicates that the content is faded to the same extent as the map's height in pixels, while a value close to zero represents a sharp cutoff. When the value is set to 0.0, the cutoff is completely disabled. Note: The property has no effect on the map if terrain is enabled. Default value: 0. Value range: 0, 1
Controls the intensity of light emitted on the source features. Default value: 0. Minimum value: 0.
Defines the transition of fillExtrusionEmissiveStrength. Default value: 0. Minimum value: 0.
The color of the flood light effect on the walls of the extruded buildings. Default value: "#ffffff".
Defines the transition of fillExtrusionFloodLightColor. Default value: "#ffffff".
Provides a control to futher fine-tune the look of the flood light on the ground beneath the extruded buildings. Lower values give the effect a more solid look while higher values make it smoother. Default value: 0.69. Value range: 0, 1
Defines the transition of fillExtrusionFloodLightGroundAttenuation. Default value: 0.69. Value range: 0, 1
The extent of the flood light effect on the ground beneath the extruded buildings in meters. Default value: 0.
Defines the transition of fillExtrusionFloodLightGroundRadius. Default value: 0.
The intensity of the flood light color. Default value: 0. Value range: 0, 1
Defines the transition of fillExtrusionFloodLightIntensity. Default value: 0. Value range: 0, 1
The extent of the flood light effect on the walls of the extruded buildings in meters. Default value: 0. Minimum value: 0.
Defines the transition of fillExtrusionFloodLightWallRadius. Default value: 0. Minimum value: 0.
The height with which to extrude this layer. Default value: 0. Minimum value: 0.
Defines the transition of fillExtrusionHeight. Default value: 0. Minimum value: 0.
The opacity of the entire fill extrusion layer. This is rendered on a per-layer, not per-feature, basis, and data-driven styling is not available. Default value: 1. Value range: 0, 1
Defines the transition of fillExtrusionOpacity. Default value: 1. Value range: 0, 1
Name of image in sprite to use for drawing images on extruded fills. For seamless patterns, image width and height must be a factor of two (2, 4, 8, ..., 512). Note that zoom-dependent expressions will be evaluated only at integer zoom levels.
Indicates whether top edges should be rounded when fill-extrusion-edge-radius has a value greater than 0. If false, rounded edges are only applied to the sides. Default is true. Default value: true.
The geometry's offset. Values are x, y where negatives indicate left and up (on the flat plane), respectively. Default value: 0,0.
Defines the transition of fillExtrusionTranslate. Default value: 0,0.
Controls the frame of reference for fill-extrusion-translate
. Default value: "map".
Whether to apply a vertical gradient to the sides of a fill-extrusion layer. If true, sides will be shaded slightly darker farther down. Default value: true.
A global multiplier that can be used to scale base, height, AO, and flood light of the fill extrusions. Default value: 1. Minimum value: 0.
Defines the transition of fillExtrusionVerticalScale. Default value: 1. Minimum value: 0.
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.