mapgl (version 0.3.1)

add_view: Add a visualization layer to an existing map

Description

This function allows you to add additional data layers to existing maps created with mapboxgl_view() or maplibre_view(), enabling composition of multiple datasets on a single map.

Usage

add_view(
  map,
  data,
  color = "gold",
  column = NULL,
  n = NULL,
  palette = viridisLite::viridis,
  layer_id = NULL,
  legend = FALSE,
  legend_position = "bottom-left"
)

Value

The map object with the new layer added

Arguments

map

A map object created by mapboxgl_view(), maplibre_view(), mapboxgl(), or maplibre()

data

An sf object, SpatRaster, or RasterLayer 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.

layer_id

The layer ID to use for the visualization. If NULL, a unique ID will be auto-generated.

legend

Logical, whether to add a legend when a column is specified. Defaults to FALSE for subsequent layers to avoid overwriting existing legends.

legend_position

The position of the legend on the map. Defaults to "bottom-left".

Examples

if (FALSE) {
library(sf)
nc <- st_read(system.file("shape/nc.shp", package = "sf"))

# Basic layering
mapboxgl_view(nc) |>
  add_view(nc[1:10, ], color = "red", layer_id = "subset")

# Layer different geometries
mapboxgl_view(polygons) |>
  add_view(points, color = "blue") |>
  add_view(lines, color = "green")

# Add raster data
mapboxgl_view(boundaries) |>
  add_view(elevation_raster, layer_id = "elevation")
}