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

1,131

Version

0.4.3

License

MIT + file LICENSE

Maintainer

Kyle Walker

Last Published

November 20th, 2025

Functions in mapgl (0.4.3)

Add a hexagon source from the H3 geospatial indexing system.

Add a layer to a map from a source

Add a line layer to a map

add_layers_control

Add a layers control to the map

add_globe_minimap

Add a Globe Minimap to a map

add_heatmap_layer

Add a heatmap layer to a Mapbox GL map

add_raster_layer

Add a raster layer to a Mapbox GL map

Add a GeoJSON or sf 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_video_source

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

add_reset_control

Add a reset control to a map

add_vector_source

Add a vector tile 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_raster_dem_source

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

add_scale_control

Add a scale control to a map

add_symbol_layer

Add a symbol layer to a map

Clear legends from a map

clear_drawn_features

Clear all drawn features from a map

Add a visualization layer to an existing map

Clear layers from a map using a proxy

cluster_options

Prepare cluster options for circle layers

Get CARTO Style URL

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

Create a Compare widget

classification_helpers

Extract information from classification and continuous scale objects

Fly to a given view

Format numbers for legend labels

Create a concatenation expression

Clear markers from a map in a Shiny session

Get column or property for use in mapping

get_drawn_features

Get drawn features from the map

Create an interpolation expression

mapboxgl_compare_proxy

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

Fit the map to a bounding box

Jump to a given view

get_queried_features

Get queried features from a map as an sf object

enable_shiny_hover

Enable hover events for Shiny applications

Initialize a Mapbox GL Map

Get Mapbox Style URL

interpolate_palette

Create an interpolation expression with automatic palette and break calculation

Create a proxy object for a Mapbox GL map in Shiny

mapboxglCompareOutput

Create a Mapbox GL Compare output element for Shiny

Create a Mapbox GL output element for Shiny

Ease to a given view

Create custom styling for map legends

Add legends to Mapbox GL and MapLibre GL maps

Initialize a Maplibre GL Map

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

Quick visualization of geometries with MapLibre GL

maplibre_compare_proxy

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

Create a proxy object for a Maplibre GL map in Shiny

Create a match expression

Create a Maplibre GL output element for Shiny

Quick visualization of geometries with Mapbox GL

maplibreCompareOutput

Create a Maplibre GL Compare output element for Shiny

Get MapTiler Style URL

Observe events on story map section transitions

renderMapboxglCompare

Render a Mapbox GL Compare output element in Shiny

Render a Maplibre GL output element in Shiny

Move a layer to a different z-position

openfreemap_style

Get OpenFreeMap Style URL

Create a number formatting expression

Render a Mapbox GL output element in Shiny

query_rendered_features

Query rendered features on a map in a Shiny session

Convert R color palette to mapgl LUT

renderMaplibreCompare

Render a Maplibre GL Compare output element in Shiny

Set popup on a map layer

set_paint_property

Set a paint property on a map layer

Set rain effect on a Mapbox GL map

Set snow effect on a Mapbox GL map

Set Projection for a Mapbox/Maplibre Map

Set a filter on a map layer

set_config_property

Set a configuration property for a Mapbox GL map

Create a scrollytelling story map with Leaflet

Create a scrollytelling story map

Update the style of a map

Set terrain properties on a map

set_layout_property

Set a layout property on a map layer

Set fog on a Mapbox GL map

step_classification

Step expressions with automatic classification

Turf.js Geospatial Operations for mapgl

Create a step expression

turf_center_of_mass

Calculate center of mass

Calculate centroid of geometries

Create a story section for story maps

Create a scrollytelling story map with MapLibre

Calculate area of geometries

Spatial filter features by predicate

Create Voronoi diagram

Union geometries

Find intersection of two geometries

turf_difference

Find difference between two geometries

Set the map center and zoom level

Calculate distance between two features

Set source of a map layer

turf_concave_hull

Create concave hull

Set tooltip on a map layer

turf_convex_hull

Create convex hull

Add a fill layer to a map

add_geocoder_control

Add a geocoder control to a map

add_fullscreen_control

Add a fullscreen control to a map

add_fill_extrusion_layer

Add a fill-extrusion layer to a Mapbox GL map

add_features_to_draw

Add features to an existing draw control

add_draw_control

Add a draw control to a map

add_circle_layer

Add a circle layer to a Mapbox GL map

Add a custom control to a map

Add an image to the map

add_geolocate_control

Add a geolocate control to a map

add_globe_control

Add a globe control to a map

add_navigation_control

Add a navigation control to a map

Add markers to a Mapbox GL or Maplibre GL map

add_image_source

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