Learn R Programming

mapgl

The mapgl R package makes the latest versions of Mapbox GL JS and MapLibre GL JS available to R users. The package interface is designed to make the powerful capabilities of both libraries available in R mapping projects, but also feel similar to users coming from other R mapping packages.

Install from CRAN:

install.packages("mapgl")

Or, install the development version from GitHub:

remotes::install_github("walkerke/mapgl")

Read through these vignettes to learn how to use the package:

Recommended training and how to learn more

If you find this project useful in your work and would like to ensure continued development of the package, you can provide support in the following ways:

Purchase the official mapgl workshop series, hosted by mapgl's author, Kyle Walker;
Chip in some funds to support package development via PayPal;
Set up a consulting engagement or workshop though Walker Data to help you implement mapgl in your project. Send a note to kyle@walker-data.com if you are interested;
File an issue - or even better, a pull request - at https://github.com/walkerke/mapgl/issues.

To stay on top of package updates / new features and to get information about mapgl trainings, be sure to sign up for the Walker Data mailing list here.

Copy Link

Version

Install

install.packages('mapgl')

Monthly Downloads

2,497

Version

0.3.1

License

MIT + file LICENSE

Maintainer

Kyle Walker

Last Published

July 3rd, 2025

Functions in mapgl (0.3.1)

add_circle_layer

Add a circle layer to a Mapbox GL map

Add markers to a Mapbox GL or Maplibre GL map

add_globe_minimap

Add a Globe Minimap to a map

Add a line layer to a map

add_navigation_control

Add a navigation control to a map

add_layers_control

Add a layers control to the map

add_heatmap_layer

Add a heatmap layer to a Mapbox GL map

Add a hexagon source from the H3 geospatial indexing system.

Add an image to the map

add_image_source

Add an image source to a Mapbox GL or Maplibre GL map

Add a layer to a map from a source

Add a GeoJSON or sf source to a Mapbox GL or Maplibre GL map

add_symbol_layer

Add a symbol layer to a map

add_raster_layer

Add a raster layer to a Mapbox GL map

add_video_source

Add a video source to a Mapbox GL or Maplibre GL map

add_raster_source

Add a raster tile source to a Mapbox GL or Maplibre GL map

add_vector_source

Add a vector tile source to a Mapbox GL or Maplibre GL map

add_raster_dem_source

Add a raster DEM source to a Mapbox GL or Maplibre GL map

add_pmtiles_source

Add a PMTiles source to a Mapbox GL or Maplibre GL map

add_scale_control

Add a scale control to a map

add_reset_control

Add a reset control to a map

cluster_options

Prepare cluster options for circle layers

Clear markers from a map in a Shiny session

Clear legends from a map

Create a Compare widget

Create a concatenation expression

Add a visualization layer to an existing map

Ease to a given view

Get CARTO Style URL

Fit the map to a bounding box

Get column or property for use in mapping

Clear layers from a map using a proxy

clear_drawn_features

Clear all drawn features from a map

enable_shiny_hover

Enable hover events for Shiny applications

get_drawn_features

Get drawn features from the map

Clear all controls from a Mapbox GL or Maplibre GL map in a Shiny app

classification_helpers

Extract information from classification and continuous scale objects

Initialize a Mapbox GL Map

Get Mapbox Style URL

mapboxglCompareOutput

Create a Mapbox GL Compare output element for Shiny

Create an interpolation expression

get_queried_features

Get queried features from a map as an sf object

Create a Mapbox GL output element for Shiny

Create custom styling for map legends

Add legends to Mapbox GL and MapLibre GL maps

Create a proxy object for a Maplibre GL map in Shiny

Quick visualization of geometries with MapLibre GL

Get MapTiler Style URL

Fly to a given view

Create a match expression

Create a number formatting expression

Move a layer to a different z-position

set_config_property

Set a configuration property for a Mapbox GL map

Set a filter on a map layer

Create a Maplibre GL output element for Shiny

Format numbers for legend labels

interpolate_palette

Create an interpolation expression with automatic palette and break calculation

Jump to a given view

maplibreCompareOutput

Create a Maplibre GL Compare output element for Shiny

renderMaplibreCompare

Render a Maplibre GL Compare output element in Shiny

Render a Maplibre GL output element in Shiny

Initialize a Maplibre GL Map

Create a proxy object for a Mapbox GL map in Shiny

Quick visualization of geometries with Mapbox GL

mapboxgl_compare_proxy

Create a proxy object for a Mapbox GL Compare widget in Shiny

maplibre_compare_proxy

Create a proxy object for a Maplibre GL Compare widget in Shiny

Set fog on a Mapbox GL map

set_layout_property

Set a layout property on a map layer

Set snow effect on a Mapbox GL map

Observe events on story map section transitions

Set Projection for a Mapbox/Maplibre Map

query_rendered_features

Query rendered features on a map in a Shiny session

Set source of a map layer

step_classification

Step expressions with automatic classification

Create a step expression

Update the style of a map

Render a Mapbox GL output element in Shiny

renderMapboxglCompare

Render a Mapbox GL Compare output element in Shiny

Create a scrollytelling story map

Create a scrollytelling story map with Leaflet

mapgl: Interactive Maps with 'Mapbox GL JS' and 'MapLibre GL JS'

set_paint_property

Set a paint property on a map layer

Set the map center and zoom level

Set tooltip on a map layer

Set popup on a map layer

Set terrain properties on a map

Set rain effect on a Mapbox GL map

Create a scrollytelling story map with MapLibre

Create a story section for story maps

add_globe_control

Add a globe control to a map

add_fullscreen_control

Add a fullscreen control to a map

add_geolocate_control

Add a geolocate control to a map

Add a fill layer to a map

add_fill_extrusion_layer

Add a fill-extrusion layer to a Mapbox GL map

add_draw_control

Add a draw control to a map

add_geocoder_control

Add a geocoder control to a map

Add a custom control to a map

add_features_to_draw

Add features to an existing draw control