add_fill_extrusion_layer: Add a fill-extrusion layer to a Mapbox GL map
In mapgl: Interactive Maps with 'Mapbox GL JS' and 'MapLibre GL JS'

add_fill_extrusion_layer

R Documentation

Add a fill-extrusion layer to a Mapbox GL map

Description

Add a fill-extrusion layer to a Mapbox GL map

Usage

add_fill_extrusion_layer(
  map,
  id,
  source,
  source_layer = NULL,
  fill_extrusion_ambient_occlusion_intensity = NULL,
  fill_extrusion_ambient_occlusion_radius = NULL,
  fill_extrusion_base = NULL,
  fill_extrusion_cast_shadows = NULL,
  fill_extrusion_color = NULL,
  fill_extrusion_cutoff_fade_range = NULL,
  fill_extrusion_emissive_strength = NULL,
  fill_extrusion_height = NULL,
  fill_extrusion_opacity = NULL,
  fill_extrusion_pattern = NULL,
  fill_extrusion_translate = NULL,
  fill_extrusion_translate_anchor = "map",
  fill_extrusion_vertical_gradient = NULL,
  visibility = "visible",
  slot = NULL,
  min_zoom = NULL,
  max_zoom = NULL,
  popup = NULL,
  tooltip = NULL,
  hover_options = NULL,
  before_id = NULL,
  filter = NULL
)

Arguments

`map`	A map object created by the `mapboxgl` function.
`id`	A unique ID for the layer.
`source`	The ID of the source, alternatively an sf object (which will be converted to a GeoJSON source) or a named list that specifies `type` and `url` for a remote source.
`source_layer`	The source layer (for vector sources).
`fill_extrusion_ambient_occlusion_intensity`	Controls the intensity of ambient occlusion shading. Value between 0 and 1; around 0.3 provides the most plausible results for buildings.
`fill_extrusion_ambient_occlusion_radius`	Shades area near ground and concave angles between walls. Default 3.0 corresponds to one floor height.
`fill_extrusion_base`	The base height of the fill extrusion.
`fill_extrusion_cast_shadows`	If `TRUE` (the default), the fill extrusion casts shadows.
`fill_extrusion_color`	The color of the fill extrusion.
`fill_extrusion_cutoff_fade_range`	Defines the fade-out range before automatic content cutoff on pitched views. Value between 0 and 1; 0 disables cutoff.
`fill_extrusion_emissive_strength`	Controls the intensity of light emitted on the source features. Requires 3D lights.
`fill_extrusion_height`	The height of the fill extrusion.
`fill_extrusion_opacity`	The opacity of the fill extrusion.
`fill_extrusion_pattern`	Name of image in sprite to use for drawing image fills.
`fill_extrusion_translate`	The geometry's offset. Values are `c(x, y)` where negatives indicate left and up.
`fill_extrusion_translate_anchor`	Controls the frame of reference for `fill-extrusion-translate`.
`fill_extrusion_vertical_gradient`	If `TRUE` (the default), sides will be shaded slightly darker farther down.
`visibility`	Whether this layer is displayed.
`slot`	An optional slot for layer order.
`min_zoom`	The minimum zoom level for the layer.
`max_zoom`	The maximum zoom level for the layer.
`popup`	A column name containing information to display in a popup on click. Columns containing HTML will be parsed.
`tooltip`	A column name containing information to display in a tooltip on hover. Columns containing HTML will be parsed.
`hover_options`	A named list of options for highlighting features in the layer on hover.
`before_id`	The name of the layer that this layer appears "before", allowing you to insert layers below other layers in your basemap (e.g. labels).
`filter`	An optional filter expression to subset features in the layer.

Value

The modified map object with the new fill-extrusion layer added.

Examples

## Not run: 
library(mapgl)

maplibre(
    style = maptiler_style("basic"),
    center = c(-74.0066, 40.7135),
    zoom = 15.5,
    pitch = 45,
    bearing = -17.6
) |>
    add_vector_source(
        id = "openmaptiles",
        url = paste0(
            "https://api.maptiler.com/tiles/v3/tiles.json?key=",
            Sys.getenv("MAPTILER_API_KEY")
        )
    ) |>
    add_fill_extrusion_layer(
        id = "3d-buildings",
        source = "openmaptiles",
        source_layer = "building",
        fill_extrusion_color = interpolate(
            column = "render_height",
            values = c(0, 200, 400),
            stops = c("lightgray", "royalblue", "lightblue")
        ),
        fill_extrusion_height = list(
            "interpolate",
            list("linear"),
            list("zoom"),
            15,
            0,
            16,
            list("get", "render_height")
        )
    )

## End(Not run)

mapgl documentation built on April 14, 2026, 5:10 p.m.