List air quality measurements
Usage
luftqualitaet_airquality(params = list(), safe = TRUE, refresh = FALSE)Arguments
- params
Named list of query parameters. Common keys:
- date_from
Start date/time filter (character, ISO-8601/date).
- date_to
End date/time filter (character, ISO-8601/date).
- component
Pollutant component id/code (character).
- scope
Scope id/code (character).
- station
Station id/code (character).
- network
Network id/code (character).
- lang
Language code for labels/descriptions (character).
- safe
Logical; if
TRUE(default), apply rate-limiting and cache GET responses totools::R_user_dir("bunddev", "cache").- refresh
Logical; if
TRUE, ignore cached responses and re-fetch from the API (defaultFALSE).
Value
A tibble with one row per station/time observation.
Column names are derived from the indices metadata in the API
response and typically include a station id key column followed by
date end (CET), an overall air-quality index, an incompleteness
flag, and per-component sub-arrays (component id, value, index, percent).
Exact column names and count vary by query parameters.
Details
The Luftqualitaet API provides air quality data and metadata from the Umweltbundesamt. Use query parameters to filter by date/time and station. API documentation: https://luftqualitaet.api.bund.dev.
See also
bunddev_parameters() to inspect available query parameters.
luftqualitaet_measures() for measurement metadata and
luftqualitaet_components() for pollutant components.
Other Luftqualitaet:
luftqualitaet_airquality_limits(),
luftqualitaet_annualbalances(),
luftqualitaet_components(),
luftqualitaet_measures(),
luftqualitaet_measures_limits(),
luftqualitaet_meta(),
luftqualitaet_networks(),
luftqualitaet_scopes(),
luftqualitaet_stationsettings(),
luftqualitaet_stationtypes(),
luftqualitaet_thresholds(),
luftqualitaet_transgressions(),
luftqualitaet_transgressiontypes()
Examples
if (FALSE) { # \dontrun{
luftqualitaet_airquality(params = list(
date_from = "2024-01-01",
date_to = "2024-01-02"
))
} # }