mapboxgl_view: Quick visualization of geometries with Mapbox GL

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

Quick visualization of geometries with Mapbox GL

Description

This function provides a quick way to visualize sf geometries using Mapbox GL JS. It automatically detects the geometry type and applies appropriate styling.

Usage

mapboxgl_view(
  data,
  color = "navy",
  column = NULL,
  n = NULL,
  palette = viridisLite::viridis,
  style = mapbox_style("light"),
  ...
)

Arguments

data	An sf object to visualize
color	The color used to visualize points, lines, or polygons if column is NULL. Defaults to "navy".
column	The name of the column to visualize. If NULL (default), geometries are shown with default styling.
n	Number of quantile breaks for numeric columns. If specified, uses step_expr() instead of interpolate().
palette	Color palette function that takes n and returns a character vector of colors. Defaults to viridisLite::viridis.
style	The Mapbox style to use. Defaults to mapbox_style("light").
...	Additional arguments passed to mapboxgl()

Value

A Mapbox GL map object

Examples

## Not run: 
library(sf)
nc <- st_read(system.file("shape/nc.shp", package = "sf"))

# Basic view
mapboxgl_view(nc)

# View with column visualization
mapboxgl_view(nc, column = "AREA")

# View with quantile breaks
mapboxgl_view(nc, column = "AREA", n = 5)

# Custom palette examples
mapboxgl_view(nc, column = "AREA", palette = viridisLite::mako)
mapboxgl_view(nc, column = "AREA", palette = function(n) RColorBrewer::brewer.pal(n, "RdYlBu"))
mapboxgl_view(nc, column = "AREA", palette = colorRampPalette(c("red", "white", "blue")))

## End(Not run)

mapgl documentation built on June 16, 2025, 5:09 p.m.