Map EDR locations or coverage data

Builds a leaflet::leaflet map of station features or gridded/profile CoverageJSON data. Station maps can show per-station popups with interactive time-series charts and CSV downloads. Coverage maps keep all supplied parameters, times, and vertical levels in the widget and expose in-map controls for choosing the active slice; grid cells open popups with a time-series chart for the clicked cell.

Usage

edr_map(
  locations,
  data = NULL,
  popup = c("plot+csv", "plot", "csv", "table", "all"),
  location_col = "coverage_id",
  id_col = NULL,
  label_col = NULL,
  parameter = NULL,
  plot_width = 7,
  plot_height = 3.5,
  plot_dpi = 72,
  tile_provider = "CartoDB.Positron",
  marker_radius = 6,
  matched_color = "#2C7FB8",
  unmatched_color = "#BBBBBB",
  show_unmatched = TRUE,
  legend = TRUE,
  max_match_distance = NULL,
  mode = c("auto", "stations", "grid", "profile"),
  controls = TRUE,
  initial = list(),
  grid_opacity = 0.75,
  grid_transform = c("identity", "sqrt", "log1p")
)

Arguments

locations: An sf object from edr_locations(), an edr_response wrapping GeoJSON, or tidy coverage data from covjson_to_tibble() / a CoverageJSON edr_response.
data: See above. Defaults to NULL.
popup: One of "plot+csv" (default), "plot", "csv", "table", or "all".
location_col: Column in data carrying the location id when data is a single tibble. Default "coverage_id".
id_col: Column in locations to join on. If NULL, the function looks for "id" then "_id" then the first character column.
label_col: Column in locations used for the popup heading. If NULL, tries "name", "locationName", "title", then the detected id column.
parameter: Optional character vector restricting which parameters are displayed. On station maps, the filtered rows also determine whether a station is marked as having data. On coverage maps, only matching rows are included in the widget payload.
plot_width, plot_height: Popup chart dimensions in inches. Display size in pixels is plot_width * plot_dpi by plot_height * plot_dpi, with a larger minimum size for readable interactive popups.
plot_dpi: Display dots-per-inch for popup charts. Default 72; bump to 90+ if popups look small on hi-DPI displays.
tile_provider: Leaflet basemap. Default "CartoDB.Positron".
marker_radius: Marker radius in pixels for stations that have time-series data. Data-less stations are drawn one pixel smaller.
matched_color: Marker colour for stations that joined to a coverage in data. Default deep blue.
unmatched_color: Marker colour for stations without data (only relevant when data is supplied and show_unmatched = TRUE). Default light grey.
show_unmatched: If TRUE (default), data-less stations are drawn in unmatched_color so the user can see the full station network. Set to FALSE to drop them entirely. Ignored when data is NULL.
legend: If TRUE (default), add a legend distinguishing stations with data from those without. Suppressed automatically when there are no unmatched markers to label.
max_match_distance: Optional maximum coordinate distance for spatially matching data rows with x / y columns to stations. Units are those of the station coordinates. NULL (default) keeps the nearest-station fallback unlimited.
mode: Map mode. "auto" (default) uses station markers for spatial feature inputs, grid cells for gridded coverage data, and profile markers for vertical profiles. Use "stations", "grid", or "profile" to force a mode.
controls: If TRUE (default), coverage maps include in-map controls for available slice dimensions (parameter, datetime, z, and any varying .axis_* CoverageJSON coordinates).
initial: Named list of initial coverage-map selections, e.g. list(parameter = "temperature", datetime = "2024-01-01", z = 0).
grid_opacity: Fill opacity for gridded coverage cells.
grid_transform: Colour transform for grid values: "identity" (default), "sqrt", or "log1p". The legend continues to report values on the original scale.

Value

A leaflet htmlwidget. Pass it to edr_save_html() to write a selfcontained HTML file.

Details

data can be one of:

NULL – just markers with the sf attribute table as a popup (when popup = "table" or popup = "all").
A long tibble (the output of covjson_to_tibble()) with one column matching the locations' id column. Set location_col = to the column in data that holds the location id and id_col = to the column in locations.
A named list of tibbles, keyed by feature id. This is what edr_explore() passes when it fetches one time series per station — and the right shape when each station has its own CovJSON response, because server-assigned coverage_ids like "1" won't naturally match the feature id.