| Title: | Discover and Call 'Bund.dev' APIs |
| Version: | 0.1.0 |
| Author: | Michael Bücker [aut, cre] |
| Maintainer: | Michael Bücker <michael.buecker@fh-muenster.de> |
| Depends: | R (≥ 4.1.0) |
| Description: | Provides a registry of APIs listed on https://bund.dev and a core 'OpenAPI' client layer to explore specs and perform requests. Adapter helpers return tidy tibbles for supported APIs, with optional response caching and rate limiting guidance. |
| License: | MIT + file LICENSE |
| Encoding: | UTF-8 |
| RoxygenNote: | 7.3.3 |
| Suggests: | ggplot2, knitr, rmarkdown, testthat (≥ 3.0.0), withr |
| Config/testthat/edition: | 3 |
| Imports: | cli, dplyr, httr2, jsonlite, purrr, rlang, stringr, tibble, tidyr, tools, xml2, yaml |
| VignetteBuilder: | knitr, rmarkdown |
| NeedsCompilation: | no |
| Packaged: | 2026-02-04 19:46:14 UTC; michael |
| Repository: | CRAN |
| Date/Publication: | 2026-02-08 16:50:02 UTC |
List waste fractions
Description
List waste fractions
Usage
abfallnavi_fraktionen(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with waste fractions.
List waste fractions for a house number
Description
List waste fractions for a house number
Usage
abfallnavi_fraktionen_hausnummern(hausnummern_id, safe = TRUE, refresh = FALSE)
Arguments
hausnummern_id |
House number id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with waste fractions.
List waste fractions for a street
Description
List waste fractions for a street
Usage
abfallnavi_fraktionen_strassen(strassen_id, safe = TRUE, refresh = FALSE)
Arguments
strassen_id |
Street id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with waste fractions.
List house numbers for a street
Description
List house numbers for a street
Usage
abfallnavi_hausnummern(strassen_id, safe = TRUE, refresh = FALSE)
Arguments
strassen_id |
Street id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with house numbers.
Download calendar file
Description
Download calendar file
Usage
abfallnavi_kalender_download(
region,
format,
jahr,
ort,
strasse,
hnr,
fraktion,
safe = TRUE,
refresh = FALSE
)
Arguments
region |
Region code. |
format |
File format. |
jahr |
Year. |
ort |
Place name. |
strasse |
Street id. |
hnr |
House number id. |
fraktion |
Fraction ids. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Downloads a calendar file for the requested address and fraction.
Value
A tibble with raw file bytes.
Get a place by id
Description
Get a place by id
Usage
abfallnavi_ort(ort_id, safe = TRUE, refresh = FALSE)
Arguments
ort_id |
Place id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with place metadata.
List available places
Description
List available places
Usage
abfallnavi_orte(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
The Abfallnavi API provides waste collection data for supported regions.
Start by listing places (Orte) to obtain an ortId. Official docs:
https://bundesapi.github.io/abfallnavi-api/.
Value
A tibble with places.
See Also
abfallnavi_strassen() for streets in a place.
Examples
## Not run:
abfallnavi_orte()
## End(Not run)
List streets for a place
Description
List streets for a place
Usage
abfallnavi_strassen(ort_id, safe = TRUE, refresh = FALSE)
Arguments
ort_id |
Place id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with streets.
List collection dates for a house number
Description
List collection dates for a house number
Usage
abfallnavi_termine_hausnummern(
hausnummern_id,
fraktion,
safe = TRUE,
refresh = FALSE
)
Arguments
hausnummern_id |
House number id. |
fraktion |
Fraction ids. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with collection dates.
Includes date_time as POSIXct in Europe/Berlin.
List collection dates for a street
Description
List collection dates for a street
Usage
abfallnavi_termine_strassen(
strassen_id,
fraktion,
safe = TRUE,
refresh = FALSE
)
Arguments
strassen_id |
Street id. |
fraktion |
Fraction ids. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with collection dates.
Includes date_time as POSIXct in Europe/Berlin.
DiGA API adapters
Description
Functions to call the DiGA API endpoints.
Get training offer details
Description
Get training offer details
Usage
ausbildungssuche_details(offer_id, safe = TRUE, refresh = FALSE)
Arguments
offer_id |
Offer id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns detailed information for a single offer.
Value
A tibble with offer details.
See Also
ausbildungssuche_search() to find offer ids.
Examples
## Not run:
Sys.setenv(AUSBILDUNGSSUCHE_API_KEY = "infosysbub-absuche")
bunddev_auth_set("ausbildungssuche", type = "api_key", env_var = "AUSBILDUNGSSUCHE_API_KEY")
ausbildungssuche_details(12345)
## End(Not run)
Search training offers
Description
Search training offers
Usage
ausbildungssuche_search(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
The Ausbildungssuche API provides training offer data from the
Bundesagentur fuer Arbeit. Authentication is required via X-API-Key
(clientId infosysbub-absuche, discoverable from
https://web.arbeitsagentur.de/weiterbildungssuche/suche). Official docs:
https://bundesapi.github.io/ausbildungssuche-api/.
This adapter uses the X-API-Key header. Set it via bunddev_auth_set() and
AUSBILDUNGSSUCHE_API_KEY.
Value
A tibble with training offers.
Includes aktualisierungsdatum_time as POSIXct in Europe/Berlin.
See Also
ausbildungssuche_details() for a single offer and bunddev_auth_set() for
authentication.
Examples
## Not run:
Sys.setenv(AUSBILDUNGSSUCHE_API_KEY = "infosysbub-absuche")
bunddev_auth_set("ausbildungssuche", type = "api_key", env_var = "AUSBILDUNGSSUCHE_API_KEY")
ausbildungssuche_search(params = list(size = 5))
## End(Not run)
Get Autobahn charging station details
Description
Get Autobahn charging station details
Usage
autobahn_charging_station_details(
station_id,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
station_id |
Charging station identifier. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns full details for a single charging station entry. Official docs: https://autobahn.api.bund.dev.
Value
A tibble with charging station details.
See Also
autobahn_charging_stations() to list stations.
Examples
## Not run:
roads <- autobahn_roads()
stations <- autobahn_charging_stations(roads$road_id[[1]])
autobahn_charging_station_details(stations$identifier[[1]])
## End(Not run)
List Autobahn charging stations
Description
List Autobahn charging stations
Usage
autobahn_charging_stations(road_id, flatten = FALSE, flatten_mode = "json")
Arguments
road_id |
Road identifier. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns charging stations for a specific Autobahn road id. Official docs: https://autobahn.api.bund.dev.
Value
A tibble with charging stations.
See Also
autobahn_roads() and autobahn_charging_station_details().
Examples
## Not run:
roads <- autobahn_roads()
autobahn_charging_stations(roads$road_id[[1]], flatten = TRUE)
## End(Not run)
Get Autobahn closure details
Description
Get Autobahn closure details
Usage
autobahn_closure_details(closure_id, flatten = FALSE, flatten_mode = "json")
Arguments
closure_id |
Closure identifier. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns full details for a single closure entry. Official docs: https://autobahn.api.bund.dev.
Value
A tibble with closure details.
See Also
autobahn_closures() to list closures.
Examples
## Not run:
roads <- autobahn_roads()
closures <- autobahn_closures(roads$road_id[[1]])
autobahn_closure_details(closures$identifier[[1]])
## End(Not run)
List Autobahn closures
Description
List Autobahn closures
Usage
autobahn_closures(road_id, flatten = FALSE, flatten_mode = "json")
Arguments
road_id |
Road identifier. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns current closures for a specific Autobahn road id. Official docs: https://autobahn.api.bund.dev.
Value
A tibble with closures.
See Also
autobahn_roads() and autobahn_closure_details().
Examples
## Not run:
roads <- autobahn_roads()
autobahn_closures(roads$road_id[[1]], flatten = TRUE)
## End(Not run)
List Autobahn lorry parking areas
Description
List Autobahn lorry parking areas
Usage
autobahn_parking_lorries(road_id, flatten = FALSE, flatten_mode = "json")
Arguments
road_id |
Road identifier. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns lorry parking areas for a specific Autobahn road id. Official docs: https://autobahn.api.bund.dev.
Value
A tibble with lorry parking areas.
See Also
autobahn_roads() and autobahn_parking_lorry_details().
Examples
## Not run:
roads <- autobahn_roads()
autobahn_parking_lorries(roads$road_id[[1]], flatten = TRUE)
## End(Not run)
Get Autobahn lorry parking details
Description
Get Autobahn lorry parking details
Usage
autobahn_parking_lorry_details(
lorry_id,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
lorry_id |
Lorry parking identifier. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns full details for a single lorry parking entry. Official docs: https://autobahn.api.bund.dev.
Value
A tibble with lorry parking details.
See Also
autobahn_parking_lorries() to list parking areas.
Examples
## Not run:
roads <- autobahn_roads()
parking <- autobahn_parking_lorries(roads$road_id[[1]])
autobahn_parking_lorry_details(parking$identifier[[1]])
## End(Not run)
List Autobahn road ids
Description
List Autobahn road ids
Usage
autobahn_roads()
Details
Lists Autobahn road ids from the Autobahn App API (Autobahn GmbH). Official docs: https://autobahn.api.bund.dev.
Value
A tibble with available road ids.
See Also
autobahn_roadworks() and autobahn_warnings() for road-specific data.
Examples
## Not run:
autobahn_roads()
## End(Not run)
Get Autobahn roadwork details
Description
Get Autobahn roadwork details
Usage
autobahn_roadwork_details(roadwork_id, flatten = FALSE, flatten_mode = "json")
Arguments
roadwork_id |
Roadwork identifier. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns full details for a single roadwork entry. Official docs: https://autobahn.api.bund.dev.
Value
A tibble with roadwork details.
See Also
autobahn_roadworks() to list roadworks.
Examples
## Not run:
roads <- autobahn_roads()
roadworks <- autobahn_roadworks(roads$road_id[[1]])
autobahn_roadwork_details(roadworks$identifier[[1]])
## End(Not run)
List Autobahn roadworks
Description
List Autobahn roadworks
Usage
autobahn_roadworks(road_id, flatten = FALSE, flatten_mode = "json")
Arguments
road_id |
Road identifier. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns current roadworks for a specific Autobahn road id. Official docs: https://autobahn.api.bund.dev.
Value
A tibble with roadworks.
See Also
autobahn_roads() to list available roads, and autobahn_roadwork_details()
for detail records.
Examples
## Not run:
roads <- autobahn_roads()
autobahn_roadworks(roads$road_id[[1]], flatten = TRUE)
## End(Not run)
Get Autobahn warning details
Description
Get Autobahn warning details
Usage
autobahn_warning_details(warning_id, flatten = FALSE, flatten_mode = "json")
Arguments
warning_id |
Warning identifier. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns full details for a single warning entry. Official docs: https://autobahn.api.bund.dev.
Value
A tibble with warning details.
See Also
autobahn_warnings() to list warnings.
Examples
## Not run:
roads <- autobahn_roads()
warnings <- autobahn_warnings(roads$road_id[[1]])
autobahn_warning_details(warnings$identifier[[1]])
## End(Not run)
List Autobahn warnings
Description
List Autobahn warnings
Usage
autobahn_warnings(road_id, flatten = FALSE, flatten_mode = "json")
Arguments
road_id |
Road identifier. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns current warnings for a specific Autobahn road id. Official docs: https://autobahn.api.bund.dev.
Value
A tibble with warnings.
See Also
autobahn_roads() to list roads and autobahn_warning_details() for details.
Examples
## Not run:
roads <- autobahn_roads()
autobahn_warnings(roads$road_id[[1]], flatten = TRUE)
## End(Not run)
Get Autobahn webcam details
Description
Get Autobahn webcam details
Usage
autobahn_webcam_details(webcam_id, flatten = FALSE, flatten_mode = "json")
Arguments
webcam_id |
Webcam identifier. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns full details for a single webcam entry. Official docs: https://autobahn.api.bund.dev.
Value
A tibble with webcam details.
See Also
autobahn_webcams() to list webcams.
Examples
## Not run:
roads <- autobahn_roads()
webcams <- autobahn_webcams(roads$road_id[[1]])
autobahn_webcam_details(webcams$identifier[[1]])
## End(Not run)
List Autobahn webcams
Description
List Autobahn webcams
Usage
autobahn_webcams(road_id, flatten = FALSE, flatten_mode = "json")
Arguments
road_id |
Road identifier. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns webcam entries for a specific Autobahn road id. Official docs: https://autobahn.api.bund.dev.
Value
A tibble with webcams.
See Also
autobahn_roads() and autobahn_webcam_details().
Examples
## Not run:
roads <- autobahn_roads()
autobahn_webcams(roads$road_id[[1]], flatten = TRUE)
## End(Not run)
Search language course offers
Description
Search language course offers
Usage
berufssprachkurssuche_search(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
The Berufssprachkurssuche API provides language course data. Authentication
can be done via OAuth2 client credentials or by sending the public client id
as X-API-Key (clientId bd24f42e-ad0b-4005-b834-23bb6800dc6c). Official
docs: https://berufssprachkurssuche.api.bund.dev/.
Recommended: Configure OAuth2 via bunddev_auth_set() with type "oauth2".
If you provide a client secret, it fetches an OAuth token; otherwise it falls
back to sending the client ID as X-API-Key.
Value
A tibble with course offers.
Includes beginn_time, ende_time, and anmeldeschluss_time as POSIXct in Europe/Berlin.
See Also
bunddev_auth_set() to configure authentication.
Examples
## Not run:
# Recommended: OAuth2 configuration
Sys.setenv(
BERUFSSPRACHKURSSUCHE_API_KEY = "bd24f42e-ad0b-4005-b834-23bb6800dc6c",
BERUFSSPRACHKURSSUCHE_CLIENT_SECRET = "<client-secret>"
)
bunddev_auth_set("berufssprachkurssuche",
type = "oauth2",
oauth_url = "https://rest.arbeitsagentur.de/oauth/gettoken_cc",
env_var = "BERUFSSPRACHKURSSUCHE_API_KEY",
oauth_secret_env = "BERUFSSPRACHKURSSUCHE_CLIENT_SECRET",
oauth_default_id = "bd24f42e-ad0b-4005-b834-23bb6800dc6c")
berufssprachkurssuche_search(params = list(page = 0, systematiken = "MC"))
## End(Not run)
Retrieve Bewerberboerse candidate details
Description
Retrieve Bewerberboerse candidate details
Usage
bewerberboerse_details(referenznummer, flatten = FALSE, flatten_mode = "json")
Arguments
referenznummer |
Bewerber referenznummer. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Fetches details for a single candidate. The referenznummer typically comes
from bewerberboerse_search(). See https://bundesapi.github.io/bewerberboerse-api/.
Value
A tibble containing detailed information for a single candidate,
including personal details, skills, work history, education, and contact
preferences. Structure is similar to bewerberboerse_search() results.
See Also
bewerberboerse_search() to find candidates and bunddev_auth_set() for auth.
Examples
## Not run:
Sys.setenv(BEWERBERBOERSE_API_KEY = "jobboerse-bewerbersuche-ui")
bunddev_auth_set("bewerberboerse", type = "api_key", env_var = "BEWERBERBOERSE_API_KEY")
bewerberboerse_details("12345", flatten = TRUE)
## End(Not run)
Search the Bewerberboerse API
Description
Search the Bewerberboerse API
Usage
bewerberboerse_search(params = list(), flatten = FALSE, flatten_mode = "json")
Arguments
params |
List of query parameters. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
The Bewerberboerse API provides access to candidate listings. Authentication
uses an API key passed as X-API-Key (clientId jobboerse-bewerbersuche-ui).
See https://bundesapi.github.io/bewerberboerse-api/ for official docs.
Use bunddev_auth_set() to configure the key and bunddev_parameters() to
inspect available query parameters.
Value
A tibble containing candidate listings with columns including
reference number, availability, location, skills, and contact flags. When
flatten = FALSE, includes nested list columns for education and
experience. Metadata columns include page, size, and max_ergebnisse.
See Also
bewerberboerse_details() for detailed entries and bunddev_auth_set() for
authentication setup.
Examples
## Not run:
Sys.setenv(BEWERBERBOERSE_API_KEY = "jobboerse-bewerbersuche-ui")
bunddev_auth_set("bewerberboerse", type = "api_key", env_var = "BEWERBERBOERSE_API_KEY")
bewerberboerse_search(params = list(was = "data", size = 10), flatten = TRUE)
## End(Not run)
Get authentication configuration for an API
Description
Get authentication configuration for an API
Usage
bunddev_auth_get(api)
Arguments
api |
Registry id. |
Details
Returns the stored auth configuration for the API or a default none entry
if no auth has been configured.
Value
A list with auth settings.
See Also
bunddev_auth_set() to configure credentials.
Examples
bunddev_auth_get("jobsuche")
Build Authorization header value
Description
Build Authorization header value
Usage
bunddev_auth_header(api, token = NULL)
Arguments
api |
Registry id. |
token |
Optional token to use instead of env_var lookup. |
Details
Constructs the Authorization header value based on the configured scheme.
Supports template-style schemes containing %s for the key/token.
Value
A character string for the Authorization header, or NULL if no auth.
Set authentication configuration for an API
Description
Set authentication configuration for an API
Usage
bunddev_auth_set(
api,
type = "api_key",
env_var,
scheme = NULL,
oauth_url = NULL,
oauth_secret_env = NULL,
oauth_default_id = NULL,
oauth_token_header = "OAuthAccessToken",
oauth_fallback_header = "X-API-Key"
)
Arguments
api |
Registry id. |
type |
Authentication type ("none", "api_key", or "oauth2"). |
env_var |
Environment variable containing credentials (for api_key) or client ID (for oauth2). |
scheme |
Authentication scheme used in the Authorization header (e.g., "Bearer", "ApiKey", "OAuth"). |
oauth_url |
OAuth2 token endpoint URL (for oauth2 type). |
oauth_secret_env |
OAuth2 client secret environment variable (for oauth2 type). |
oauth_default_id |
Default OAuth2 client ID if env_var is not set (for oauth2 type). |
oauth_token_header |
Header name for OAuth token (default "OAuthAccessToken"). |
oauth_fallback_header |
Header name when no secret available (default "X-API-Key"). |
Details
Store auth configuration used by bunddev_call() and adapter helpers.
For API key auth: set env_var to the name of an environment variable containing
the key. The key is sent as Authorization: {scheme} <key>.
For OAuth2 client credentials: set oauth_url to the token endpoint,
env_var to the client ID env var, and oauth_secret_env to the client secret
env var. If the secret is available, fetches an OAuth token; otherwise falls
back to sending the client ID as an API key.
Value
The updated auth configuration.
See Also
bunddev_auth_get() to inspect the stored configuration, and
bunddev_call() to make authenticated requests.
Examples
# API key authentication
Sys.setenv(JOBBOERSE_API_KEY = "jobboerse-jobsuche")
bunddev_auth_set("jobsuche", type = "api_key", env_var = "JOBBOERSE_API_KEY", scheme = "X-API-Key")
# OAuth2 client credentials
bunddev_auth_set("berufssprachkurssuche",
type = "oauth2",
oauth_url = "https://rest.arbeitsagentur.de/oauth/gettoken_cc",
env_var = "BERUFSSPRACHKURSSUCHE_API_KEY",
oauth_secret_env = "BERUFSSPRACHKURSSUCHE_CLIENT_SECRET",
oauth_default_id = "bd24f42e-ad0b-4005-b834-23bb6800dc6c")
Get raw auth token for an API
Description
Get raw auth token for an API
Usage
bunddev_auth_token(api)
Arguments
api |
Registry id. |
Value
The raw token value, or NULL if no auth configured.
Locate the bunddev cache directory
Description
Locate the bunddev cache directory
Usage
bunddev_cache_dir()
Details
The cache directory is used to store downloaded OpenAPI specs and cached API responses. Use this to inspect or clean cached files.
Value
Cache directory path.
See Also
bunddev_spec() to download specs, and bunddev_spec_path() to locate
a specific spec file.
Examples
bunddev_cache_dir()
Call an API operation
Description
Call an API operation
Usage
bunddev_call(
api,
operation_id = NULL,
params = list(),
path = NULL,
method = NULL,
parse = c("json", "text", "raw", "xml"),
base_url = NULL,
body = NULL,
body_type = c("json", "form"),
headers = NULL,
safe = TRUE,
refresh = FALSE
)
Arguments
api |
Registry id. |
operation_id |
OpenAPI operationId (use this OR path+method). |
params |
List of query parameters. |
path |
API path (use with method instead of operation_id). |
method |
HTTP method (use with path instead of operation_id). |
parse |
Response parsing mode. |
base_url |
Optional base URL override. |
body |
Optional request body (for POST/PUT requests). |
body_type |
Body encoding type ("json" or "form"). |
headers |
Optional named list of custom HTTP headers. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached GET responses. |
Details
This is the low-level OpenAPI caller. It supports two modes:
Use
operation_idto lookup endpoints by their OpenAPI operationIdUse
path+methodfor APIs without operationIds
The function fills path parameters from params, applies auth (if
configured), and optionally caches GET responses when safe = TRUE.
Use bunddev_parameters() and bunddev_parameter_values() to discover valid
parameters before calling.
Value
Parsed response.
See Also
bunddev_call_tidy() for adapter-specific tidy outputs, and
bunddev_auth_set() to configure API keys.
Examples
# Retrieve Autobahn road ids (raw response)
bunddev_call("autobahn", "list-autobahnen")
Call an API operation and return tidy data
Description
Call an API operation and return tidy data
Usage
bunddev_call_tidy(api, operation_id, params = list(), ...)
Arguments
api |
Registry id. |
operation_id |
OpenAPI operationId. |
params |
List of parameters. |
... |
Additional arguments passed to the tidier. |
Details
This helper calls bunddev_call() and then applies the adapter-specific
tidier for the API. If no tidier is registered, a tibble containing the raw
response is returned.
Value
A tibble with tidied results.
See Also
bunddev_call() for raw responses, and bunddev_parameters() to discover
available parameters.
Examples
# Tidy Autobahn roadworks
bunddev_call_tidy("autobahn", "list-roadworks", params = list(roadId = "A1"))
Retrieve endpoints for a given API
Description
Retrieve endpoints for a given API
List OpenAPI endpoints for an API
Usage
bunddev_endpoints(id)
bunddev_endpoints(id)
Arguments
id |
Registry id. |
Details
Parses the cached OpenAPI spec and returns every available path + method with its operationId and summary, if provided.
Value
A tibble with columns method, path, operation_id, summary
A tibble with endpoints.
See Also
bunddev_parameters() to inspect parameters and bunddev_spec() to access
the full spec.
Examples
bunddev_endpoints("autobahn")
Get a registry entry by id
Description
Get a registry entry by id
Usage
bunddev_info(id)
Arguments
id |
Registry id. |
Details
Use this to access the spec URL, documentation URL, and authentication requirements for a single API.
Value
A tibble with a single registry entry.
See Also
bunddev_list() for discovery and bunddev_registry() for the full table.
Examples
bunddev_info("smard")
List registry entries
Description
List registry entries
Usage
bunddev_list(tag = NULL, auth = NULL)
Arguments
tag |
Optional tag to filter on. |
auth |
Optional auth type to filter on. |
Details
Use this to quickly narrow down APIs by topic or authentication type. Tags correspond to the taxonomy in the bundled registry.
Value
A tibble of registry entries.
See Also
bunddev_registry() for the full table and bunddev_info() for one entry.
Examples
bunddev_list(tag = "jobs")
bunddev_list(auth = "api_key")
Convert milliseconds to POSIXct
Description
Convert milliseconds to POSIXct
Usage
bunddev_ms_to_posix(value, tz = "Europe/Berlin")
Arguments
value |
Timestamp in milliseconds. |
tz |
Timezone for conversion. |
Details
Converts epoch milliseconds to POSIXct in the requested timezone.
Value
POSIXct timestamp.
Examples
bunddev_ms_to_posix(1704067200000, tz = "Europe/Berlin")
Get OAuth2 client ID for an API
Description
Get OAuth2 client ID for an API
Usage
bunddev_oauth_client_id(api)
Arguments
api |
Registry id. |
Details
Returns the OAuth2 client ID from env var or default config.
Value
Client ID string.
Fetch OAuth2 token for an API
Description
Fetch OAuth2 token for an API
Usage
bunddev_oauth_token(api)
Arguments
api |
Registry id. |
Details
Fetches an OAuth2 access token using the client credentials flow. Returns NULL if no client secret is available (will fall back to API key auth).
Value
OAuth token string, or NULL if unavailable.
Extract parameter enum values
Description
Extract parameter enum values
Usage
bunddev_parameter_values(endpoint, name)
Arguments
endpoint |
Adapter function or its name. |
name |
Parameter name. |
Details
Returns unique enum values for a parameter defined on the adapter endpoint.
Value
A character vector of enum values.
See Also
bunddev_parameters_for() to inspect all parameters for an adapter.
Examples
bunddev_parameter_values(smard_timeseries, "resolution")
List OpenAPI parameters for an API
Description
List OpenAPI parameters for an API
Usage
bunddev_parameters(id, name = NULL, path = NULL, method = NULL)
Arguments
id |
Registry id. |
name |
Optional parameter name to filter. |
path |
Optional endpoint path to filter. |
method |
Optional HTTP method to filter. |
Details
Returns one row per parameter defined in the OpenAPI spec. Enumerations are
stored in a list-column (enum). Use the filter arguments to narrow down
results to a specific endpoint or parameter name.
Value
A tibble with parameter metadata.
See Also
bunddev_parameters_for() for adapter-specific parameters and
bunddev_parameter_values() for enum values.
Examples
bunddev_parameters("smard", name = "resolution")
List OpenAPI parameters for a specific adapter
Description
List OpenAPI parameters for a specific adapter
Usage
bunddev_parameters_for(endpoint)
Arguments
endpoint |
Adapter function or its name. |
Details
Resolves the adapter to an OpenAPI path/method mapping and filters parameters accordingly.
Value
A tibble with parameter metadata.
See Also
bunddev_parameters() for the full API parameter table.
Examples
bunddev_parameters_for(smard_timeseries)
Get API rate limit configuration
Description
Get API rate limit configuration
Usage
bunddev_rate_limit_get(api)
Arguments
api |
Registry id. |
Details
If no explicit limit was set, the function tries to infer one from the
registry entry. The result is used by adapter helpers when safe = TRUE.
Value
The rate limit configuration.
See Also
bunddev_rate_limit_set() to override the default.
Examples
bunddev_rate_limit_get("smard")
Set API rate limit configuration
Description
Set API rate limit configuration
Usage
bunddev_rate_limit_set(api, max_per_hour)
Arguments
api |
Registry id. |
max_per_hour |
Maximum number of calls per hour. |
Details
Use this to override or enforce a per-hour rate limit for a given API. The default is inferred from the registry entry when available.
Value
The stored rate limit configuration.
See Also
bunddev_rate_limit_get() to inspect the current setting.
Examples
bunddev_rate_limit_set("smard", max_per_hour = 60)
Read the bundled API registry
Description
Read the bundled API registry
Usage
bunddev_registry()
Details
The registry is bundled with the package and contains metadata such as the API title, provider, documentation URL, OpenAPI spec URL, authentication type, and any declared rate limits. The data originates from bund.dev and the bundesAPI registry.
Value
A tibble with registry entries.
See Also
bunddev_list() for filtered listings, bunddev_search() for keyword
searches, and bunddev_info() for a single entry.
Examples
registry <- bunddev_registry()
head(registry, 3)
Search registry entries
Description
Search registry entries
Usage
bunddev_search(q)
Arguments
q |
Search query. |
Details
Searches across registry ids, titles, providers, and tags using a simple substring match.
Value
A tibble of matching registry entries.
See Also
bunddev_list() to filter by tag or auth, and bunddev_info() for details
on a single API.
Examples
bunddev_search("weather")
Retrieve a cached API spec
Description
Retrieve a cached API spec
Usage
bunddev_spec(id, refresh = FALSE)
Arguments
id |
Registry id. |
refresh |
Logical; refresh cached spec. |
Details
Downloads the OpenAPI spec from the registry if it is missing or when
refresh = TRUE. Parsed specs are returned as lists.
Value
Parsed OpenAPI spec.
See Also
bunddev_endpoints() to list operations and bunddev_parameters() to
inspect parameters.
Examples
bunddev_spec("smard")
Build a cache path for an API spec
Description
Build a cache path for an API spec
Usage
bunddev_spec_path(id)
Arguments
id |
Registry id. |
Details
Determines the cache file name based on the spec URL extension (.yaml/.json).
Value
File path for the cached spec.
See Also
bunddev_spec() to download and parse specs.
Examples
bunddev_spec_path("smard")
Convert timestamps to milliseconds
Description
Convert timestamps to milliseconds
Usage
bunddev_timestamp_to_ms(value, tz = "Europe/Berlin")
Arguments
value |
Timestamp as numeric (ms), Date, or POSIXct. |
tz |
Timezone for Date/POSIXct conversion. |
Details
This helper standardizes timestamps for APIs that expect epoch milliseconds. Dates are interpreted in the supplied timezone.
Value
Numeric timestamp in milliseconds.
Examples
bunddev_timestamp_to_ms(as.POSIXct("2024-01-01 00:00:00", tz = "Europe/Berlin"))
Query Bundeshaushalt budget data
Description
Query Bundeshaushalt budget data
Usage
bundeshaushalt_budget_data(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
The Bundeshaushalt API provides budget data for federal income and expenses.
Required query parameters are year and account. Official docs:
https://github.com/bundesAPI/bundeshaushalt-api.
Value
A tibble with budget data and nested detail lists.
Includes timestamp_time as POSIXct in Europe/Berlin.
Examples
## Not run:
bundeshaushalt_budget_data(params = list(year = 2021, account = "expenses"))
## End(Not run)
List current Bundesrat news
Description
List current Bundesrat news
Usage
bundesrat_aktuelles(view = "renderXml", safe = TRUE, refresh = FALSE)
Arguments
view |
Rendering mode for the XML output. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns current news items from the Bundesrat app feed. Official docs: https://bundesrat.api.bund.dev.
Value
A tibble with news items.
Examples
## Not run:
bundesrat_aktuelles()
## End(Not run)
List Bundesrat members
Description
List Bundesrat members
Usage
bundesrat_mitglieder(view = "renderXml", safe = TRUE, refresh = FALSE)
Arguments
view |
Rendering mode for the XML output. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns Bundesrat member entries from the mobile feed. Official docs: https://bundesrat.api.bund.dev.
Value
A tibble with member entries.
Examples
## Not run:
bundesrat_mitglieder()
## End(Not run)
List Bundesrat current plenum session entries
Description
List Bundesrat current plenum session entries
Usage
bundesrat_plenum_aktuelle_sitzung(
view = "renderXml",
safe = TRUE,
refresh = FALSE
)
Arguments
view |
Rendering mode for the XML output. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns entries for the current plenum session. Official docs: https://bundesrat.api.bund.dev.
Value
A tibble with current plenum session entries.
Examples
## Not run:
bundesrat_plenum_aktuelle_sitzung()
## End(Not run)
List Bundesrat plenum entries in chronological order
Description
List Bundesrat plenum entries in chronological order
Usage
bundesrat_plenum_chronologisch(
view = "renderXml",
safe = TRUE,
refresh = FALSE
)
Arguments
view |
Rendering mode for the XML output. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns plenum entries ordered chronologically. Official docs: https://bundesrat.api.bund.dev.
Value
A tibble with plenum entries.
Examples
## Not run:
bundesrat_plenum_chronologisch()
## End(Not run)
List Bundesrat plenum compact entries
Description
List Bundesrat plenum compact entries
Usage
bundesrat_plenum_kompakt(view = "renderXml", safe = TRUE, refresh = FALSE)
Arguments
view |
Rendering mode for the XML output. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns plenum compact entries for Bundesrat sessions. Official docs: https://bundesrat.api.bund.dev.
Value
A tibble with plenum compact entries.
Examples
## Not run:
bundesrat_plenum_kompakt()
## End(Not run)
Get Bundesrat upcoming plenum sessions
Description
Get Bundesrat upcoming plenum sessions
Usage
bundesrat_plenum_naechste_sitzungen(
view = "render[iOSDetailsWithoutInnerDate]",
safe = TRUE,
refresh = FALSE
)
Arguments
view |
Rendering mode for the XML output. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns upcoming Bundesrat sessions. Official docs: https://bundesrat.api.bund.dev.
Value
A tibble with upcoming session metadata.
Examples
## Not run:
bundesrat_plenum_naechste_sitzungen()
## End(Not run)
List Bundesrat presidium entries
Description
List Bundesrat presidium entries
Usage
bundesrat_praesidium(view = "renderXml", safe = TRUE, refresh = FALSE)
Arguments
view |
Rendering mode for the XML output. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns Bundesrat presidium entries. Official docs: https://bundesrat.api.bund.dev.
Value
A tibble with presidium entries.
Examples
## Not run:
bundesrat_praesidium()
## End(Not run)
List Bundesrat API endpoints
Description
List Bundesrat API endpoints
Usage
bundesrat_startlist(view = "renderXml", safe = TRUE, refresh = FALSE)
Arguments
view |
Rendering mode for the XML output. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns the start list for the Bundesrat mobile API, including the URLs for other available resources. Official docs: https://bundesrat.api.bund.dev.
Value
A tibble with endpoint metadata.
Examples
## Not run:
bundesrat_startlist()
## End(Not run)
Get Bundesrat voting distribution
Description
Get Bundesrat voting distribution
Usage
bundesrat_stimmverteilung(
view = "render[iOSDetailsWithoutInnerDate]",
safe = TRUE,
refresh = FALSE
)
Arguments
view |
Rendering mode for the XML output. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns the Bundesrat voting distribution. Official docs: https://bundesrat.api.bund.dev.
Value
A tibble with voting distribution metadata.
Examples
## Not run:
bundesrat_stimmverteilung()
## End(Not run)
List Bundesrat dates and events
Description
List Bundesrat dates and events
Usage
bundesrat_termine(view = "renderXml", safe = TRUE, refresh = FALSE)
Arguments
view |
Rendering mode for the XML output. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns scheduled Bundesrat dates and events. Official docs: https://bundesrat.api.bund.dev.
Value
A tibble with dates and events.
Examples
## Not run:
bundesrat_termine()
## End(Not run)
Get a Bundestag news article
Description
Get a Bundestag news article
Usage
bundestag_article(article_id, safe = TRUE, refresh = FALSE)
Arguments
article_id |
Article id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns a single Bundestag news article in XML format. Official docs: https://bundesapi.github.io/bundestag-api/.
Value
A tibble with article fields.
Examples
## Not run:
bundestag_article(849630)
## End(Not run)
List Bundestag committees
Description
List Bundestag committees
Usage
bundestag_ausschuesse(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns the committee index from Bundestag XML feeds. Official docs: https://bundesapi.github.io/bundestag-api/.
Value
A tibble with committee entries.
Examples
## Not run:
bundestag_ausschuesse()
## End(Not run)
Get Bundestag committee details
Description
Get Bundestag committee details
Usage
bundestag_ausschuss(ausschuss_id, safe = TRUE, refresh = FALSE)
Arguments
ausschuss_id |
Committee id (e.g. "a11"). |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns details for a single committee. Official docs: https://bundesapi.github.io/bundestag-api/.
Value
A tibble with committee details.
Examples
## Not run:
bundestag_ausschuss("a11")
## End(Not run)
Get Bundestag conferences overview
Description
Get Bundestag conferences overview
Usage
bundestag_conferences(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns conference overview data from the plenum feed. Official docs: https://bundesapi.github.io/bundestag-api/.
Value
A tibble with conference fields.
Examples
## Not run:
bundestag_conferences()
## End(Not run)
Search the Bundestag lobbyregister
Description
Search the Bundestag lobbyregister
Usage
bundestag_lobbyregister_search(
q = NULL,
sort = NULL,
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
q |
Optional search string. |
sort |
Optional sorting order. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns search results from the Bundestag lobbyregister. Official docs: https://bundesapi.github.io/bundestag-lobbyregister-api/.
Value
A tibble with search metadata and result entries.
Examples
## Not run:
bundestag_lobbyregister_search(q = "energie")
## End(Not run)
Get a Bundestag biography
Description
Get a Bundestag biography
Usage
bundestag_mdb_bio(mdb_id, safe = TRUE, refresh = FALSE)
Arguments
mdb_id |
Member id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns details for a single member of parliament. Official docs: https://bundesapi.github.io/bundestag-api/.
Value
A tibble with biography fields.
Examples
## Not run:
bundestag_mdb_bio(1769)
## End(Not run)
List Bundestag members of parliament
Description
List Bundestag members of parliament
Usage
bundestag_mdb_index(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns the index of members of parliament. Official docs: https://bundesapi.github.io/bundestag-api/.
Value
A tibble with member entries.
Examples
## Not run:
bundestag_mdb_index()
## End(Not run)
Get the current Bundestag speaker
Description
Get the current Bundestag speaker
Usage
bundestag_speaker(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns the current speaker from the plenum feed. Official docs: https://bundesapi.github.io/bundestag-api/.
Value
A tibble with speaker fields.
Examples
## Not run:
bundestag_speaker()
## End(Not run)
Get a Bundestag video feed entry
Description
Get a Bundestag video feed entry
Usage
bundestag_video_feed(content_id, safe = TRUE, refresh = FALSE)
Arguments
content_id |
Video content id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns a video feed entry from the Bundestag webtv service. Official docs: https://bundesapi.github.io/bundestag-api/.
Value
A tibble with video feed fields.
Examples
## Not run:
bundestag_video_feed(7529016)
## End(Not run)
Search coaching offers
Description
Search coaching offers
Usage
coachingangebote_search(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
The Coachingangebote API provides coaching and activation offers from the
Bundesagentur fuer Arbeit. Authentication can be done via OAuth2 client
credentials or by sending the public client id as X-API-Key (clientId
ee971dcb-96fa-47b3-b2be-00863e4fc88b). Official docs:
https://bundesapi.github.io/coachingangebote-api/.
Recommended: Configure OAuth2 via bunddev_auth_set() with type "oauth2".
If you provide a client secret, it fetches an OAuth token; otherwise it falls
back to sending the client ID as X-API-Key.
Value
A tibble with coaching offers.
Includes gueltig_von_time, gueltig_bis_time, and aktualisierungsdatum_time as POSIXct in Europe/Berlin.
See Also
bunddev_auth_set() to configure authentication.
Examples
## Not run:
# Recommended: OAuth2 configuration
Sys.setenv(
COACHINGANGEBOTE_API_KEY = "ee971dcb-96fa-47b3-b2be-00863e4fc88b",
COACHINGANGEBOTE_CLIENT_SECRET = "<client-secret>"
)
bunddev_auth_set("coachingangebote",
type = "oauth2",
oauth_url = "https://rest.arbeitsagentur.de/oauth/gettoken_cc",
env_var = "COACHINGANGEBOTE_API_KEY",
oauth_secret_env = "COACHINGANGEBOTE_CLIENT_SECRET",
oauth_default_id = "ee971dcb-96fa-47b3-b2be-00863e4fc88b")
coachingangebote_search(params = list(mz = "SA 01"))
## End(Not run)
Get Dashboard Deutschland GeoJSON
Description
Get Dashboard Deutschland GeoJSON
Usage
dashboard_deutschland_geo(
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns GeoJSON data for Germany and the federal states. Official docs: https://bundesapi.github.io/dashboard-deutschland-api/.
Value
A tibble with GeoJSON metadata.
Examples
## Not run:
dashboard_deutschland_geo(flatten = TRUE)
## End(Not run)
List Dashboard Deutschland entries
Description
List Dashboard Deutschland entries
Usage
dashboard_deutschland_get(
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns the full list of dashboard entries and metadata for each item. Official docs: https://bundesapi.github.io/dashboard-deutschland-api/.
Value
A tibble with dashboard entries.
Examples
## Not run:
dashboard_deutschland_get()
## End(Not run)
Query Dashboard Deutschland indicators
Description
Query Dashboard Deutschland indicators
Usage
dashboard_deutschland_indicators(ids = NULL, safe = TRUE, refresh = FALSE)
Arguments
ids |
Indicator ids, semicolon-separated or as a character vector. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns indicator data for the specified ids. Official docs: https://bundesapi.github.io/dashboard-deutschland-api/.
Value
A tibble with indicator data.
Includes date_time as POSIXct in Europe/Berlin.
Examples
## Not run:
dashboard_deutschland_indicators("tile_1667811574092")
## End(Not run)
List DDB institution sectors
Description
List DDB institution sectors
Usage
ddb_institution_sectors(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns institution sector metadata. Requires the DDB API key.
Value
A tibble with sector entries.
Examples
## Not run:
ddb_institution_sectors()
## End(Not run)
List DDB institutions
Description
List DDB institutions
Usage
ddb_institutions(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns institutions registered in the DDB. Requires the DDB API key.
Value
A tibble with institution entries.
Examples
## Not run:
ddb_institutions(params = list(hasItems = TRUE))
## End(Not run)
Search Deutsche Digitale Bibliothek
Description
Search Deutsche Digitale Bibliothek
Usage
ddb_search(
query,
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
query |
Search query string. |
params |
Additional query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns search results from the Deutsche Digitale Bibliothek API. You need an
API key from https://www.deutsche-digitale-bibliothek.de/user/apikey. The key
is sent in the Authorization header as OAuth oauth_consumer_key="<key>".
Configure authentication via bunddev_auth_set() using a template-style
scheme, or set the DDB_API_KEY environment variable directly.
Value
A tibble with search metadata and result payload.
See Also
bunddev_auth_set() to configure authentication.
Examples
## Not run:
# Recommended: use bunddev_auth_set with template scheme
Sys.setenv(DDB_API_KEY = "<api-key>")
bunddev_auth_set("ddb", type = "api_key", env_var = "DDB_API_KEY",
scheme = "OAuth oauth_consumer_key=\"%s\"")
ddb_search(query = "berlin", params = list(rows = 5))
## End(Not run)
List Destatis cubes
Description
List Destatis cubes
Usage
destatis_catalogue_cubes(
params = list(),
username = "GAST",
password = "GAST",
safe = TRUE,
refresh = FALSE
)
Arguments
params |
Query parameters. |
username |
Genesis username (default "GAST"). |
password |
Genesis password (default "GAST"). |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns the cube catalogue from the Destatis Genesis API. Official docs: https://github.com/bundesAPI/destatis-api.
Value
A tibble with the raw response payload.
Examples
## Not run:
destatis_catalogue_cubes()
## End(Not run)
List Destatis tables
Description
List Destatis tables
Usage
destatis_catalogue_tables(
params = list(),
username = "GAST",
password = "GAST",
safe = TRUE,
refresh = FALSE
)
Arguments
params |
Query parameters. |
username |
Genesis username (default "GAST"). |
password |
Genesis password (default "GAST"). |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns the table catalogue from the Destatis Genesis API. Official docs: https://github.com/bundesAPI/destatis-api.
Value
A tibble with the raw response payload.
Examples
## Not run:
destatis_catalogue_tables()
## End(Not run)
Retrieve Destatis cube data
Description
Retrieve Destatis cube data
Usage
destatis_data_cube(
name,
params = list(),
username = "GAST",
password = "GAST",
safe = TRUE,
refresh = FALSE
)
Arguments
name |
Cube id. |
params |
Query parameters. |
username |
Genesis username (default "GAST"). |
password |
Genesis password (default "GAST"). |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns cube data as text (csv by default). Official docs: https://github.com/bundesAPI/destatis-api.
Value
A tibble with cube data in a text column.
Examples
## Not run:
destatis_data_cube("21231BJ001")
## End(Not run)
Retrieve Destatis table data
Description
Retrieve Destatis table data
Usage
destatis_data_table(
name,
params = list(),
username = "GAST",
password = "GAST",
safe = TRUE,
refresh = FALSE
)
Arguments
name |
Table id. |
params |
Query parameters. |
username |
Genesis username (default "GAST"). |
password |
Genesis password (default "GAST"). |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns table data as text (csv by default). Official docs: https://github.com/bundesAPI/destatis-api.
Value
A tibble with table data in a text column.
Examples
## Not run:
destatis_data_table("12411-0001")
## End(Not run)
Query Deutschlandatlas indicators
Description
Query Deutschlandatlas indicators
Usage
deutschlandatlas_query(
table = "p_apo_f_ZA2022",
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
table |
Table id (default "p_apo_f_ZA2022"). |
params |
Query parameters for the ArcGIS service. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
The Deutschlandatlas API is backed by an ArcGIS feature service. You must
supply a where filter and output format f (usually "json"). Official docs:
https://github.com/AndreasFischer1985/deutschlandatlas-api.
Value
A tibble with indicator records.
See Also
bunddev_parameters() to inspect available query parameters.
Examples
## Not run:
deutschlandatlas_query(
table = "p_apo_f_ZA2022",
params = list(
where = "1=1",
outFields = "*",
f = "json",
returnGeometry = "false",
resultRecordCount = 5
)
)
## End(Not run)
List DiGA catalog entries
Description
List DiGA catalog entries
Usage
diga_catalog_entries(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. |
Value
A tibble containing DiGA catalog entry resources from the FHIR API.
Structure depends on flatten setting (see diga_device_definitions()).
List DiGA prescription units
Description
List DiGA prescription units
Usage
diga_charge_item_definitions(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. |
Value
A tibble containing DiGA prescription unit (ChargeItemDefinition)
resources from the FHIR API. Structure depends on flatten setting.
List DiGA device definitions
Description
List DiGA device definitions
Usage
diga_device_definitions(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Value
A tibble containing DiGA device definitions from the FHIR API. When
flatten = FALSE, nested FHIR resource elements are preserved as list
columns. When flatten = TRUE, list columns are expanded based on the
specified flatten_mode.
Examples
## Not run: dig_device_definitions()
List DiGA manufacturers
Description
List DiGA manufacturers
Usage
diga_organizations(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. |
Value
A tibble containing DiGA manufacturer organization resources from
the FHIR API. Structure depends on flatten setting.
List DiGA questionnaire responses
Description
List DiGA questionnaire responses
Usage
diga_questionnaire_responses(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. |
Value
A tibble containing DiGA questionnaire response resources from the
FHIR API. Structure depends on flatten setting.
List DiGA questionnaires
Description
List DiGA questionnaires
Usage
diga_questionnaires(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. |
Value
A tibble containing DiGA questionnaire resources from the FHIR API.
Structure depends on flatten setting.
Get a DIP Aktivität
Description
Get a DIP Aktivität
Usage
dip_bundestag_aktivitaet(
aktivitaet_id,
params = list(),
safe = TRUE,
refresh = FALSE
)
Arguments
aktivitaet_id |
Aktivität id. |
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with Aktivität metadata.
Examples
## Not run:
dip_bundestag_aktivitaet(1493545)
## End(Not run)
List DIP Aktivitäten
Description
List DIP Aktivitäten
Usage
dip_bundestag_aktivitaet_list(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Value
A tibble with DIP response metadata.
Examples
## Not run:
dip_bundestag_aktivitaet_list()
## End(Not run)
Get a DIP Drucksache
Description
Get a DIP Drucksache
Usage
dip_bundestag_drucksache(
drucksache_id,
params = list(),
safe = TRUE,
refresh = FALSE
)
Arguments
drucksache_id |
Drucksache id. |
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with Drucksache metadata.
Examples
## Not run:
dip_bundestag_drucksache(68852)
## End(Not run)
List DIP Drucksachen
Description
List DIP Drucksachen
Usage
dip_bundestag_drucksache_list(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Value
A tibble with DIP response metadata.
Examples
## Not run:
dip_bundestag_drucksache_list()
## End(Not run)
Get a DIP Drucksache text
Description
Get a DIP Drucksache text
Usage
dip_bundestag_drucksache_text(
drucksache_id,
params = list(),
safe = TRUE,
refresh = FALSE
)
Arguments
drucksache_id |
Drucksache id. |
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with Drucksache text metadata.
Examples
## Not run:
dip_bundestag_drucksache_text(68852)
## End(Not run)
List DIP Drucksache texts
Description
List DIP Drucksache texts
Usage
dip_bundestag_drucksache_text_list(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Value
A tibble with DIP response metadata.
Examples
## Not run:
dip_bundestag_drucksache_text_list()
## End(Not run)
Get a DIP Person
Description
Get a DIP Person
Usage
dip_bundestag_person(person_id, params = list(), safe = TRUE, refresh = FALSE)
Arguments
person_id |
Person id. |
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with person metadata.
Examples
## Not run:
dip_bundestag_person(1728)
## End(Not run)
List DIP Personen
Description
List DIP Personen
Usage
dip_bundestag_person_list(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Value
A tibble with DIP response metadata.
Examples
## Not run:
dip_bundestag_person_list()
## End(Not run)
Get a DIP Plenarprotokoll
Description
Get a DIP Plenarprotokoll
Usage
dip_bundestag_plenarprotokoll(
plenarprotokoll_id,
params = list(),
safe = TRUE,
refresh = FALSE
)
Arguments
plenarprotokoll_id |
Plenarprotokoll id. |
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with Plenarprotokoll metadata.
Examples
## Not run:
dip_bundestag_plenarprotokoll(908)
## End(Not run)
List DIP Plenarprotokolle
Description
List DIP Plenarprotokolle
Usage
dip_bundestag_plenarprotokoll_list(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Value
A tibble with DIP response metadata.
Examples
## Not run:
dip_bundestag_plenarprotokoll_list()
## End(Not run)
Get a DIP Plenarprotokoll text
Description
Get a DIP Plenarprotokoll text
Usage
dip_bundestag_plenarprotokoll_text(
plenarprotokoll_id,
params = list(),
safe = TRUE,
refresh = FALSE
)
Arguments
plenarprotokoll_id |
Plenarprotokoll id. |
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with Plenarprotokoll text metadata.
Examples
## Not run:
dip_bundestag_plenarprotokoll_text(908)
## End(Not run)
List DIP Plenarprotokoll texts
Description
List DIP Plenarprotokoll texts
Usage
dip_bundestag_plenarprotokoll_text_list(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Value
A tibble with DIP response metadata.
Examples
## Not run:
dip_bundestag_plenarprotokoll_text_list()
## End(Not run)
Get a DIP Vorgang
Description
Get a DIP Vorgang
Usage
dip_bundestag_vorgang(
vorgang_id,
params = list(),
safe = TRUE,
refresh = FALSE
)
Arguments
vorgang_id |
Vorgang id. |
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns metadata for a single Vorgang.
Value
A tibble with Vorgang metadata.
Examples
## Not run:
dip_bundestag_vorgang(84343)
## End(Not run)
List DIP Vorgang entries
Description
List DIP Vorgang entries
Usage
dip_bundestag_vorgang_list(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns metadata for DIP Vorgang entries. Requires an API key. Obtain a key from https://dip.bundestag.de/über-dip/hilfe/api.
Configure authentication via bunddev_auth_set() or set the
DIP_BUNDESTAG_API_KEY environment variable directly.
Value
A tibble with DIP response metadata.
See Also
bunddev_auth_set() to configure authentication.
Examples
## Not run:
# Recommended: use bunddev_auth_set
Sys.setenv(DIP_BUNDESTAG_API_KEY = "<api-key>")
bunddev_auth_set(
"dip_bundestag",
type = "api_key",
env_var = "DIP_BUNDESTAG_API_KEY",
scheme = "ApiKey"
)
dip_bundestag_vorgang_list()
## End(Not run)
Get a DIP Vorgangsposition
Description
Get a DIP Vorgangsposition
Usage
dip_bundestag_vorgangsposition(
vorgangsposition_id,
params = list(),
safe = TRUE,
refresh = FALSE
)
Arguments
vorgangsposition_id |
Vorgangsposition id. |
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with Vorgangsposition metadata.
Examples
## Not run:
dip_bundestag_vorgangsposition(173376)
## End(Not run)
List DIP Vorgangsposition entries
Description
List DIP Vorgangsposition entries
Usage
dip_bundestag_vorgangsposition_list(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns metadata for Vorgangsposition entries.
Value
A tibble with DIP response metadata.
Examples
## Not run:
dip_bundestag_vorgangsposition_list()
## End(Not run)
Fetch DWD alpine forecast text
Description
Fetch DWD alpine forecast text
Usage
dwd_alpine_forecast_text(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Retrieves alpine forecast text from the DWD App API. Official docs: https://dwd.api.bund.dev.
Value
A tibble with the forecast text.
See Also
dwd_sea_warning_text() and dwd_avalanche_warnings().
Examples
## Not run:
dwd_alpine_forecast_text()
## End(Not run)
Fetch DWD avalanche warnings
Description
Fetch DWD avalanche warnings
Usage
dwd_avalanche_warnings(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Retrieves avalanche warnings from the DWD App API. Official docs: https://dwd.api.bund.dev.
Value
A tibble with avalanche data.
See Also
dwd_alpine_forecast_text() and dwd_sea_warning_text().
Examples
## Not run:
dwd_avalanche_warnings()
## End(Not run)
Fetch DWD coastal warnings
Description
Fetch DWD coastal warnings
Usage
dwd_coast_warnings(
language = c("de", "en"),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
language |
Language code ("de" or "en"). |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Retrieves coastal warnings from the DWD App API. Official docs: https://dwd.api.bund.dev.
Value
A tibble with coastal warnings.
See Also
dwd_warnings_nowcast() and dwd_municipality_warnings().
Examples
## Not run:
dwd_coast_warnings(language = "de", flatten = TRUE)
## End(Not run)
Fetch DWD crowd reports
Description
Fetch DWD crowd reports
Usage
dwd_crowd_reports(
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Retrieves crowd-sourced weather reports from the DWD App API. Official docs: https://dwd.api.bund.dev.
Value
A tibble with crowd reports.
Includes timestamp_time as POSIXct in Europe/Berlin.
See Also
dwd_station_overview() and dwd_warnings_nowcast().
Examples
## Not run:
dwd_crowd_reports(flatten = TRUE)
## End(Not run)
Fetch DWD municipality warnings
Description
Fetch DWD municipality warnings
Usage
dwd_municipality_warnings(
language = c("de", "en"),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
language |
Language code ("de" or "en"). |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Retrieves municipality warnings from the DWD App API. Official docs: https://dwd.api.bund.dev.
Value
A tibble with municipality warnings.
Includes start_time and end_time as POSIXct in Europe/Berlin.
See Also
dwd_warnings_nowcast() and dwd_coast_warnings().
Examples
## Not run:
dwd_municipality_warnings(language = "de", flatten = TRUE)
## End(Not run)
Fetch DWD sea warning text
Description
Fetch DWD sea warning text
Usage
dwd_sea_warning_text(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Retrieves sea warning text from the DWD App API. Official docs: https://dwd.api.bund.dev.
Value
A tibble with the warning text.
See Also
dwd_alpine_forecast_text() and dwd_avalanche_warnings().
Examples
## Not run:
dwd_sea_warning_text()
## End(Not run)
Fetch DWD station overview data
Description
Fetch DWD station overview data
Usage
dwd_station_overview(
station_ids,
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
station_ids |
Station identifiers. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Retrieves station overview data from the DWD App API. Official docs: https://dwd.api.bund.dev. Station IDs can be looked up via DWD opendata resources or the API documentation.
Value
A tibble with station data.
Includes forecast time columns (forecast_start_time, forecast1_start_time,
forecast2_start_time) as POSIXct in Europe/Berlin.
See Also
dwd_crowd_reports() and dwd_warnings_nowcast().
Examples
## Not run:
dwd_station_overview(c("10865", "G005"), flatten = TRUE)
## End(Not run)
Fetch DWD nowcast warnings
Description
Fetch DWD nowcast warnings
Usage
dwd_warnings_nowcast(
language = c("de", "en"),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
language |
Language code ("de" or "en"). |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Retrieves nowcast weather warnings from the DWD App API. Official docs: https://dwd.api.bund.dev.
Value
A tibble with nowcast warnings.
Includes start_time and end_time as POSIXct in Europe/Berlin.
See Also
dwd_municipality_warnings() and dwd_coast_warnings().
Examples
## Not run:
dwd_warnings_nowcast(language = "de", flatten = TRUE)
## End(Not run)
List Eco-Visio counters for an organization
Description
List Eco-Visio counters for an organization
Usage
eco_visio_counters(id_organisme, safe = TRUE, refresh = FALSE)
Arguments
id_organisme |
Organization ID (e.g., 4586 for Bike Count Display). |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
The Eco-Visio API provides access to bicycle and pedestrian counter data. This function returns all counters registered for a specific organization. Official docs: https://github.com/bundesAPI/eco-visio-api.
Value
A tibble with counter metadata.
See Also
eco_visio_data() to retrieve measurement data for a counter.
Examples
## Not run:
eco_visio_counters(4586)
## End(Not run)
Get Eco-Visio counter measurement data
Description
Get Eco-Visio counter measurement data
Usage
eco_visio_data(
id_organisme,
id_pdc,
interval,
flow_ids,
begin = NULL,
end = NULL,
safe = TRUE,
refresh = FALSE
)
Arguments
id_organisme |
Organization ID. |
id_pdc |
Counter ID. |
interval |
Aggregation interval (1-6: 1=15min, 2=hours, 3=days, 4=weeks, 5=months, 6=years). |
flow_ids |
Practice IDs (semicolon-separated string or character vector). |
begin |
Optional start date (Date or "YYYY-MM-DD" string). |
end |
Optional end date (Date or "YYYY-MM-DD" string). |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns measurement data for a specific counter. The flow_ids parameter
specifies which traffic types to include (e.g., pedestrians, cyclists).
Use eco_visio_counters() to discover available counters and their flow IDs.
Value
A tibble with measurement data.
Includes date_time as POSIXct in Europe/Berlin.
See Also
eco_visio_counters() to list available counters.
Examples
## Not run:
# Get daily data for a counter
eco_visio_data(
id_organisme = 4586,
id_pdc = 100125331,
interval = 4,
flow_ids = "101125331"
)
## End(Not run)
Query Entgeltatlas data by KldB key
Description
Query Entgeltatlas data by KldB key
Usage
entgeltatlas_entgelte(
kldb,
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
kldb |
KldB 2010 key (3-5 digits). |
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
The Entgeltatlas API provides wage statistics for occupational categories identified by KldB keys. The API accepts optional filters for region, gender, age, sector, and performance level. Official docs: https://bundesapi.github.io/entgeltatlas-api/.
Recommended: Configure OAuth2 via bunddev_auth_set() with type "oauth2".
If you provide a client secret, it fetches an OAuth token; otherwise it falls
back to sending the client ID as X-API-Key.
Value
A tibble with entgelt entries.
Examples
## Not run:
# Recommended: OAuth2 configuration
Sys.setenv(
ENTGELTATLAS_API_KEY = "c4f0d292-9d0f-4763-87dd-d3f9e78fb006",
ENTGELTATLAS_CLIENT_SECRET = "<client-secret>"
)
bunddev_auth_set("entgeltatlas",
type = "oauth2",
oauth_url = "https://rest.arbeitsagentur.de/oauth/gettoken_cc",
env_var = "ENTGELTATLAS_API_KEY",
oauth_secret_env = "ENTGELTATLAS_CLIENT_SECRET",
oauth_default_id = "c4f0d292-9d0f-4763-87dd-d3f9e78fb006")
entgeltatlas_entgelte("84304", params = list(r = 1, g = 1))
## End(Not run)
List German public holidays
Description
List German public holidays
Usage
feiertage_list(
jahr = NULL,
nur_land = NULL,
nur_daten = NULL,
safe = TRUE,
refresh = FALSE
)
Arguments
jahr |
Year to query (defaults to current year on the API). |
nur_land |
Optional Bundesland code to filter. |
nur_daten |
Logical; return only date values (1) or include names (0). |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
The Feiertage API returns German public holidays from a Wikipedia-based dataset. The endpoint supports filtering by year and Bundesland. Official docs: https://github.com/bundesAPI/feiertage-api.
Value
A tibble with holiday names and dates.
Region-level results include a region column and a note column for
holiday-specific hints.
Includes date_time as POSIXct in Europe/Berlin.
See Also
bunddev_parameters() for available query parameters.
Examples
## Not run:
feiertage_list(jahr = 2024)
feiertage_list(jahr = 2024, nur_land = "BY")
## End(Not run)
Search the Handelsregister portal
Description
This adapter scrapes the public Handelsregister search form because no official OpenAPI specification is available for this service.
Usage
handelsregister_search(
schlagwoerter,
schlagwort_optionen = c("all", "min", "exact"),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
schlagwoerter |
Search terms. |
schlagwort_optionen |
Keyword options. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
The Handelsregister search is provided via a public web form. This helper automates the form flow and parses the result table into a tidy tibble. Official docs: https://github.com/bundesAPI/handelsregister.
The registry notes that more than 60 requests per hour may violate the terms
of use. Use safe = TRUE to respect the built-in rate limiting.
Value
A tibble with search results.
See Also
bunddev_rate_limit_get() to inspect the configured limit.
Examples
## Not run:
handelsregister_search("Deutsche Bahn", schlagwort_optionen = "all")
## End(Not run)
Get Hilfsmittel verification schema details
Description
Get Hilfsmittel verification schema details
Usage
hilfsmittel_nachweisschema(
id,
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
id |
Nachweisschema id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns detail information for a Nachweisschema. Official docs: https://github.com/bundesAPI/hilfsmittel-api.
Value
A tibble with Nachweisschema details.
Examples
## Not run:
hilfsmittel_nachweisschema("a3d37017-2c91-4d6d-bbbe-4002d2868044")
## End(Not run)
Get Hilfsmittel product details
Description
Get Hilfsmittel product details
Usage
hilfsmittel_produkt(
id,
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
id |
Produkt id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns detail information for a single product. Official docs: https://github.com/bundesAPI/hilfsmittel-api.
Value
A tibble with product details.
Examples
## Not run:
hilfsmittel_produkt("f41f52a6-5d2d-4dd3-9d0e-39675ceca7f3")
## End(Not run)
Get Hilfsmittel product type details
Description
Get Hilfsmittel product type details
Usage
hilfsmittel_produktart(
id,
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
id |
Produktart id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns details for a product type (Produktart). Official docs: https://github.com/bundesAPI/hilfsmittel-api.
Value
A tibble with product type details.
Examples
## Not run:
hilfsmittel_produktart("e6b913ef-cf21-4c5f-826d-f866516c3c65")
## End(Not run)
List Hilfsmittel products
Description
List Hilfsmittel products
Usage
hilfsmittel_produkte(
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns the full product list (large payload). Official docs: https://github.com/bundesAPI/hilfsmittel-api.
Value
A tibble with products.
Examples
## Not run:
hilfsmittel_produkte()
## End(Not run)
Get Hilfsmittel product group details
Description
Get Hilfsmittel product group details
Usage
hilfsmittel_produktgruppe(
id,
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
id |
Produktgruppe id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns details for a product group (Produktgruppe). Official docs: https://github.com/bundesAPI/hilfsmittel-api.
Value
A tibble with product group details.
Examples
## Not run:
tree <- hilfsmittel_tree(level = 1)
hilfsmittel_produktgruppe(tree$id[[1]])
## End(Not run)
List Hilfsmittel tree nodes
Description
List Hilfsmittel tree nodes
Usage
hilfsmittel_tree(level, safe = TRUE, refresh = FALSE)
Arguments
level |
Tree level to retrieve (1-4). |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns nodes from the Hilfsmittel product tree up to the selected level. Official docs: https://github.com/bundesAPI/hilfsmittel-api.
Value
A tibble with tree nodes.
Examples
## Not run:
hilfsmittel_tree(level = 1)
## End(Not run)
Get Hilfsmittel subgroup details
Description
Get Hilfsmittel subgroup details
Usage
hilfsmittel_untergruppe(
id,
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
id |
Untergruppe id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns details for a subgroup (Untergruppe). Official docs: https://github.com/bundesAPI/hilfsmittel-api.
Value
A tibble with subgroup details.
Examples
## Not run:
hilfsmittel_untergruppe("c92d1976-d3cb-4b9f-bcdf-805272a9ea86")
## End(Not run)
List flood portal states and connected regions
Description
List flood portal states and connected regions
Usage
hochwasserzentralen_bundeslaender(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns metadata for all Bundeslaender and connected regions in the hochwasserzentralen.de portal. Official docs: https://bundesapi.github.io/hochwasserzentralen-api/.
Value
A tibble with Bundesland metadata.
Examples
## Not run:
hochwasserzentralen_bundeslaender()
## End(Not run)
Get Bundesland GeoJSON boundaries
Description
Get Bundesland GeoJSON boundaries
Usage
hochwasserzentralen_bundesland_geojson(
version,
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
version |
GeoJSON version identifier (e.g., "20211130"). |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns GeoJSON boundaries for Bundeslaender and connected regions from the hochwasserzentralen.de portal. Official docs: https://bundesapi.github.io/hochwasserzentralen-api/.
Value
A tibble with GeoJSON metadata and feature list-columns.
Examples
## Not run:
hochwasserzentralen_bundesland_geojson("20211130", flatten = TRUE)
## End(Not run)
Get flood portal metadata for a Bundesland
Description
Get flood portal metadata for a Bundesland
Usage
hochwasserzentralen_bundesland_info(
bundesland_id,
safe = TRUE,
refresh = FALSE
)
Arguments
bundesland_id |
Bundesland id (e.g., "HE"). |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns metadata for a single Bundesland or region in the hochwasserzentralen.de portal. Official docs: https://bundesapi.github.io/hochwasserzentralen-api/.
Value
A tibble with Bundesland metadata.
Examples
## Not run:
hochwasserzentralen_bundesland_info("HE")
## End(Not run)
List flood gauge locations
Description
List flood gauge locations
Usage
hochwasserzentralen_lagepegel(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns latitude/longitude coordinates for all pegel identifiers available in the hochwasserzentralen.de portal. Official docs: https://bundesapi.github.io/hochwasserzentralen-api/.
Value
A tibble with pegel coordinates.
Examples
## Not run:
hochwasserzentralen_lagepegel()
## End(Not run)
Get flood gauge information
Description
Get flood gauge information
Usage
hochwasserzentralen_pegel_info(pegelnummer, safe = TRUE, refresh = FALSE)
Arguments
pegelnummer |
Pegelnummer identifier (e.g., "HE_24820206"). |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns metadata for a single flood gauge (pegel) from hochwasserzentralen.de. Official docs: https://bundesapi.github.io/hochwasserzentralen-api/.
Value
A tibble with pegel metadata.
Examples
## Not run:
hochwasserzentralen_pegel_info("HE_24820206")
## End(Not run)
Get an Interpol red notice
Description
Get an Interpol red notice
Usage
interpol_red_notice(
notice_id,
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
notice_id |
Notice ID. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns detailed data for a red notice. Official docs: https://interpol.api.bund.dev.
Value
A tibble with notice details.
Examples
## Not run:
interpol_red_notice("1993-27493")
## End(Not run)
List Interpol red notice images
Description
List Interpol red notice images
Usage
interpol_red_notice_images(
notice_id,
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
notice_id |
Notice ID. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns images metadata for a red notice. Official docs: https://interpol.api.bund.dev.
Value
A tibble with image metadata.
Examples
## Not run:
interpol_red_notice_images("1993-27493")
## End(Not run)
List Interpol red notices
Description
List Interpol red notices
Usage
interpol_red_notices(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns Interpol red notices. Official docs: https://interpol.api.bund.dev.
Value
A tibble with notices metadata.
Examples
## Not run:
interpol_red_notices(params = list(resultPerPage = 10, page = 1))
## End(Not run)
Get an Interpol UN notice
Description
Get an Interpol UN notice
Usage
interpol_un_notice(
notice_type,
notice_id,
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
notice_type |
Notice type: "persons" or "entities". |
notice_id |
Notice ID. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns detailed data for a UN notice. Official docs: https://interpol.api.bund.dev.
Value
A tibble with notice details.
Examples
## Not run:
interpol_un_notice("persons", "2021-84506")
## End(Not run)
List Interpol UN notice images
Description
List Interpol UN notice images
Usage
interpol_un_notice_images(
notice_type,
notice_id,
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
notice_type |
Notice type: "persons" or "entities". |
notice_id |
Notice ID. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns images metadata for a UN notice. Official docs: https://interpol.api.bund.dev.
Value
A tibble with image metadata.
Examples
## Not run:
interpol_un_notice_images("persons", "2021-84506")
## End(Not run)
List Interpol UN notices
Description
List Interpol UN notices
Usage
interpol_un_notices(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns UN notices from Interpol. Official docs: https://interpol.api.bund.dev.
Value
A tibble with notices metadata.
Examples
## Not run:
interpol_un_notices(params = list(resultPerPage = 10, page = 1))
## End(Not run)
Get an Interpol yellow notice
Description
Get an Interpol yellow notice
Usage
interpol_yellow_notice(
notice_id,
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
notice_id |
Notice ID. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns detailed data for a yellow notice. Official docs: https://interpol.api.bund.dev.
Value
A tibble with notice details.
Examples
## Not run:
interpol_yellow_notice("2014-5590")
## End(Not run)
List Interpol yellow notice images
Description
List Interpol yellow notice images
Usage
interpol_yellow_notice_images(
notice_id,
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
notice_id |
Notice ID. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns images metadata for a yellow notice. Official docs: https://interpol.api.bund.dev.
Value
A tibble with image metadata.
Examples
## Not run:
interpol_yellow_notice_images("2014-5590")
## End(Not run)
List Interpol yellow notices
Description
List Interpol yellow notices
Usage
interpol_yellow_notices(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns Interpol yellow notices. Official docs: https://interpol.api.bund.dev.
Value
A tibble with notices metadata.
Examples
## Not run:
interpol_yellow_notices(params = list(resultPerPage = 10, page = 1))
## End(Not run)
Fetch Jobsuche employer logo
Description
Fetch Jobsuche employer logo
Usage
jobsuche_logo(hash_id, safe = TRUE, refresh = FALSE)
Arguments
hash_id |
Logo hash id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns the raw logo bytes for a given employer hash id. Use this together
with listings returned by jobsuche_search() or jobsuche_search_app().
See https://jobsuche.api.bund.dev for API documentation.
Value
A tibble with raw logo bytes.
See Also
jobsuche_search() for listings and bunddev_auth_set() for auth setup.
Examples
## Not run:
Sys.setenv(JOBBOERSE_API_KEY = "jobboerse-jobsuche")
bunddev_auth_set("jobsuche", type = "api_key", env_var = "JOBBOERSE_API_KEY")
logo <- jobsuche_logo("abc123")
## End(Not run)
Search Jobsuche listings
Description
Search Jobsuche listings
Usage
jobsuche_search(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
The Jobsuche API provides access to job listings from the Bundesagentur fuer
Arbeit. Authentication is required via an API key passed as X-API-Key.
See https://jobsuche.api.bund.dev for the official API documentation.
Use bunddev_auth_set() to configure the key and bunddev_parameters() to
discover supported query parameters.
Value
A tibble with job listings.
Includes parsed POSIXct columns (suffix _time) in Europe/Berlin.
See Also
jobsuche_search_app() for the app endpoint, jobsuche_logo() to fetch
employer logos, and bunddev_auth_set() for authentication.
Examples
## Not run:
Sys.setenv(JOBBOERSE_API_KEY = "jobboerse-jobsuche")
bunddev_auth_set("jobsuche", type = "api_key", env_var = "JOBBOERSE_API_KEY")
jobsuche_search(params = list(was = "data", size = 5), flatten = TRUE)
## End(Not run)
Search Jobsuche listings (app endpoint)
Description
Search Jobsuche listings (app endpoint)
Usage
jobsuche_search_app(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
This uses the mobile app endpoint of the Jobsuche API. It shares the same
authentication mechanism and parameters as jobsuche_search().
See https://jobsuche.api.bund.dev for API documentation.
Value
A tibble with job listings.
Includes parsed POSIXct columns (suffix _time) in Europe/Berlin.
See Also
jobsuche_search() for the standard endpoint and bunddev_parameters() for
parameter discovery.
Examples
## Not run:
Sys.setenv(JOBBOERSE_API_KEY = "jobboerse-jobsuche")
bunddev_auth_set("jobsuche", type = "api_key", env_var = "JOBBOERSE_API_KEY")
jobsuche_search_app(params = list(was = "data", size = 5), flatten = TRUE)
## End(Not run)
Query charging stations
Description
Query charging stations
Usage
ladestationen_query(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters for the ArcGIS service. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
The Ladesaeulenregister API is backed by an ArcGIS feature service. You must
supply a geometry filter and outFields. The ArcGIS service may require a
token query parameter even though the API docs describe the service as
public. Official docs:
https://ladestationen.api.bund.dev.
Value
A tibble with charging station records.
See Also
bunddev_parameters() to inspect available query parameters.
Examples
## Not run:
geometry <- jsonlite::toJSON(
list(
xmin = 13.3, ymin = 52.4, xmax = 13.5, ymax = 52.6,
spatialReference = list(wkid = 4326)
),
auto_unbox = TRUE
)
ladestationen_query(params = list(
geometry = geometry,
geometryType = "esriGeometryEnvelope",
where = "1=1",
outFields = "*",
outSR = 4326,
f = "json",
returnGeometry = "false",
resultRecordCount = 5
))
## End(Not run)
List food and product warnings
Description
List food and product warnings
Usage
lebensmittelwarnung_warnings(
food = list(),
products = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
food |
Optional request options for food warnings (rows, start, sort, fq). |
products |
Optional request options for product warnings (rows, start, sort, fq). |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
The Lebensmittelwarnungen API returns German food and product safety warnings.
Requests are sent as JSON to the warnings/merged endpoint. Official docs:
https://lebensmittelwarnung.api.bund.dev and
https://github.com/bundesAPI/lebensmittelwarnung-api.
The API expects an Authorization header. By default the adapter uses the
public key documented in the OpenAPI spec. Override it with
bunddev_auth_set() if needed.
Value
A tibble with warning entries.
Includes published_date_time as POSIXct in Europe/Berlin.
See Also
bunddev_auth_set() to configure the authorization header.
Examples
## Not run:
lebensmittelwarnung_warnings(food = list(rows = 10), products = list(rows = 0))
## End(Not run)
List air quality measurements
Description
List air quality measurements
Usage
luftqualitaet_airquality(params = list(), safe = TRUE, refresh = FALSE)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
The Luftqualitaet API provides air quality data and metadata from the Umweltbundesamt. Use query parameters to filter by date/time and station. Official docs: https://luftqualitaet.api.bund.dev.
Value
A tibble with air quality data.
See Also
luftqualitaet_measures() for measurement metadata and
luftqualitaet_components() for pollutant components.
Examples
## Not run:
luftqualitaet_airquality(params = list(
date_from = "2024-01-01",
date_to = "2024-01-02"
))
## End(Not run)
Get air quality date limits
Description
Get air quality date limits
Usage
luftqualitaet_airquality_limits(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns date limits for air quality measurements. Official docs: https://luftqualitaet.api.bund.dev.
Value
A tibble with date limits.
List annual balances
Description
List annual balances
Usage
luftqualitaet_annualbalances(params = list(), safe = TRUE, refresh = FALSE)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns annual balance data for a component and year. Official docs: https://luftqualitaet.api.bund.dev.
Value
A tibble with annual balance data.
List components
Description
List components
Usage
luftqualitaet_components(params = list(), safe = TRUE, refresh = FALSE)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns available pollutant components. Official docs: https://luftqualitaet.api.bund.dev.
Value
A tibble with component metadata.
List measurements metadata
Description
List measurements metadata
Usage
luftqualitaet_measures(params = list(), safe = TRUE, refresh = FALSE)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns measurement metadata for stations, components, and scopes. Official docs: https://luftqualitaet.api.bund.dev.
Value
A tibble with measurement metadata.
Get measurement date limits
Description
Get measurement date limits
Usage
luftqualitaet_measures_limits(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns date limits for measurement metadata. Official docs: https://luftqualitaet.api.bund.dev.
Value
A tibble with date limits.
List combined metadata
Description
List combined metadata
Usage
luftqualitaet_meta(params = list(), safe = TRUE, refresh = FALSE)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns combined metadata for a given use case. Official docs: https://luftqualitaet.api.bund.dev.
Value
A tibble with combined metadata.
List networks
Description
List networks
Usage
luftqualitaet_networks(params = list(), safe = TRUE, refresh = FALSE)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns networks used by the Luftqualitaet API. Official docs: https://luftqualitaet.api.bund.dev.
Value
A tibble with network metadata.
List scopes
Description
List scopes
Usage
luftqualitaet_scopes(params = list(), safe = TRUE, refresh = FALSE)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns scopes used by the Luftqualitaet API. Official docs: https://luftqualitaet.api.bund.dev.
Value
A tibble with scope metadata.
List station settings
Description
List station settings
Usage
luftqualitaet_stationsettings(params = list(), safe = TRUE, refresh = FALSE)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns station settings metadata. Official docs: https://luftqualitaet.api.bund.dev.
Value
A tibble with station settings metadata.
List station types
Description
List station types
Usage
luftqualitaet_stationtypes(params = list(), safe = TRUE, refresh = FALSE)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns station types metadata. Official docs: https://luftqualitaet.api.bund.dev.
Value
A tibble with station types metadata.
List thresholds
Description
List thresholds
Usage
luftqualitaet_thresholds(params = list(), safe = TRUE, refresh = FALSE)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns threshold metadata for components and scopes. Official docs: https://luftqualitaet.api.bund.dev.
Value
A tibble with threshold metadata.
List transgressions
Description
List transgressions
Usage
luftqualitaet_transgressions(params = list(), safe = TRUE, refresh = FALSE)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns exceedances (transgressions) data. Official docs: https://luftqualitaet.api.bund.dev.
Value
A tibble with transgressions data.
List transgression types
Description
List transgression types
Usage
luftqualitaet_transgressiontypes(params = list(), safe = TRUE, refresh = FALSE)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns available transgression types. Official docs: https://luftqualitaet.api.bund.dev.
Value
A tibble with transgression type metadata.
List MaStR filter options for gas generation
Description
List MaStR filter options for gas generation
Usage
marktstammdaten_filters_gaserzeugung(
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns filter definitions for public gas generation data. Official docs: https://github.com/bundesAPI/marktstammdaten-api.
Value
A tibble with filter metadata.
Examples
## Not run:
marktstammdaten_filters_gaserzeugung()
## End(Not run)
List MaStR filter options for gas consumption
Description
List MaStR filter options for gas consumption
Usage
marktstammdaten_filters_gasverbrauch(
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns filter definitions for public gas consumption data. Official docs: https://github.com/bundesAPI/marktstammdaten-api.
Value
A tibble with filter metadata.
Examples
## Not run:
marktstammdaten_filters_gasverbrauch()
## End(Not run)
List MaStR filter options for electricity generation
Description
List MaStR filter options for electricity generation
Usage
marktstammdaten_filters_stromerzeugung(
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns filter definitions for public electricity generation data. Official docs: https://github.com/bundesAPI/marktstammdaten-api.
Value
A tibble with filter metadata.
Examples
## Not run:
marktstammdaten_filters_stromerzeugung()
## End(Not run)
List MaStR filter options for electricity consumption
Description
List MaStR filter options for electricity consumption
Usage
marktstammdaten_filters_stromverbrauch(
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns filter definitions for public electricity consumption data. Official docs: https://github.com/bundesAPI/marktstammdaten-api.
Value
A tibble with filter metadata.
Examples
## Not run:
marktstammdaten_filters_stromverbrauch()
## End(Not run)
List MaStR gas generation data
Description
List MaStR gas generation data
Usage
marktstammdaten_gaserzeugung(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns public gas generation data from the MaStR. Official docs: https://github.com/bundesAPI/marktstammdaten-api.
Value
A tibble with MaStR entries.
Examples
## Not run:
marktstammdaten_gaserzeugung(params = list(page = 1, pageSize = 5))
## End(Not run)
List MaStR gas consumption data
Description
List MaStR gas consumption data
Usage
marktstammdaten_gasverbrauch(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns public gas consumption data from the MaStR. Official docs: https://github.com/bundesAPI/marktstammdaten-api.
Value
A tibble with MaStR entries.
Examples
## Not run:
marktstammdaten_gasverbrauch(params = list(page = 1, pageSize = 5))
## End(Not run)
List MaStR electricity generation data
Description
List MaStR electricity generation data
Usage
marktstammdaten_stromerzeugung(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns public electricity generation data from the MaStR. Official docs: https://github.com/bundesAPI/marktstammdaten-api.
Value
A tibble with MaStR entries.
Examples
## Not run:
marktstammdaten_stromerzeugung(params = list(page = 1, pageSize = 5))
## End(Not run)
List MaStR electricity consumption data
Description
List MaStR electricity consumption data
Usage
marktstammdaten_stromverbrauch(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns public electricity consumption data from the MaStR. Official docs: https://github.com/bundesAPI/marktstammdaten-api.
Value
A tibble with MaStR entries.
Examples
## Not run:
marktstammdaten_stromverbrauch(params = list(page = 1, pageSize = 5))
## End(Not run)
List MUDAB parameter values
Description
List MUDAB parameter values
Usage
mudab_parameter_values(
filter = NULL,
range = NULL,
orderby = NULL,
safe = TRUE,
refresh = FALSE
)
Arguments
filter |
Optional filter definition. |
range |
Optional range specification. |
orderby |
Optional ordering specification. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns measurement values for parameters from the MUDAB database. Official docs: https://mudab.api.bund.dev.
Value
A tibble with parameter values.
Includes datetime_time as POSIXct in Europe/Berlin when date/time fields are
present.
Examples
## Not run:
mudab_parameter_values(range = list(from = 0, count = 5))
## End(Not run)
List MUDAB parameters
Description
List MUDAB parameters
Usage
mudab_parameters(
filter = NULL,
range = NULL,
orderby = NULL,
safe = TRUE,
refresh = FALSE
)
Arguments
filter |
Optional filter definition. |
range |
Optional range specification. |
orderby |
Optional ordering specification. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns measurement parameters from the MUDAB database. Official docs: https://mudab.api.bund.dev.
Value
A tibble with parameters.
Examples
## Not run:
mudab_parameters(range = list(from = 0, count = 5))
## End(Not run)
List MUDAB parameters (Biologie)
Description
List MUDAB parameters (Biologie)
Usage
mudab_parameters_biologie(
filter = NULL,
range = NULL,
orderby = NULL,
safe = TRUE,
refresh = FALSE
)
Arguments
filter |
Optional filter definition. |
range |
Optional range specification. |
orderby |
Optional ordering specification. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns parameter entries for the Biologie compartment. Official docs: https://mudab.api.bund.dev.
Value
A tibble with parameters.
Examples
## Not run:
mudab_parameters_biologie(range = list(from = 0, count = 5))
## End(Not run)
List MUDAB parameters (Biota)
Description
List MUDAB parameters (Biota)
Usage
mudab_parameters_biota(
filter = NULL,
range = NULL,
orderby = NULL,
safe = TRUE,
refresh = FALSE
)
Arguments
filter |
Optional filter definition. |
range |
Optional range specification. |
orderby |
Optional ordering specification. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns parameter entries for the Biota compartment. Official docs: https://mudab.api.bund.dev.
Value
A tibble with parameters.
Examples
## Not run:
mudab_parameters_biota(range = list(from = 0, count = 5))
## End(Not run)
List MUDAB parameters (Sediment)
Description
List MUDAB parameters (Sediment)
Usage
mudab_parameters_sediment(
filter = NULL,
range = NULL,
orderby = NULL,
safe = TRUE,
refresh = FALSE
)
Arguments
filter |
Optional filter definition. |
range |
Optional range specification. |
orderby |
Optional ordering specification. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns parameter entries for the Sediment compartment. Official docs: https://mudab.api.bund.dev.
Value
A tibble with parameters.
Examples
## Not run:
mudab_parameters_sediment(range = list(from = 0, count = 5))
## End(Not run)
List MUDAB parameters (Wasser)
Description
List MUDAB parameters (Wasser)
Usage
mudab_parameters_wasser(
filter = NULL,
range = NULL,
orderby = NULL,
safe = TRUE,
refresh = FALSE
)
Arguments
filter |
Optional filter definition. |
range |
Optional range specification. |
orderby |
Optional ordering specification. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns parameter entries for the Wasser compartment. Official docs: https://mudab.api.bund.dev.
Value
A tibble with parameters.
Examples
## Not run:
mudab_parameters_wasser(range = list(from = 0, count = 5))
## End(Not run)
List MUDAB PLC measurement values
Description
List MUDAB PLC measurement values
Usage
mudab_plc_measurements(
filter = NULL,
range = NULL,
orderby = NULL,
safe = TRUE,
refresh = FALSE
)
Arguments
filter |
Optional filter definition. |
range |
Optional range specification. |
orderby |
Optional ordering specification. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns PLC station measurement values. Official docs: https://mudab.api.bund.dev.
Value
A tibble with PLC measurements.
Examples
## Not run:
mudab_plc_measurements(range = list(from = 0, count = 5))
## End(Not run)
List MUDAB PLC parameters
Description
List MUDAB PLC parameters
Usage
mudab_plc_parameters(
filter = NULL,
range = NULL,
orderby = NULL,
safe = TRUE,
refresh = FALSE
)
Arguments
filter |
Optional filter definition. |
range |
Optional range specification. |
orderby |
Optional ordering specification. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns parameters measured at PLC stations. Official docs: https://mudab.api.bund.dev.
Value
A tibble with PLC parameters.
Examples
## Not run:
mudab_plc_parameters(range = list(from = 0, count = 5))
## End(Not run)
List MUDAB PLC stations
Description
List MUDAB PLC stations
Usage
mudab_plc_stations(
filter = NULL,
range = NULL,
orderby = NULL,
safe = TRUE,
refresh = FALSE
)
Arguments
filter |
Optional filter definition. |
range |
Optional range specification. |
orderby |
Optional ordering specification. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns HELCOM PLC stations. Official docs: https://mudab.api.bund.dev.
Value
A tibble with PLC stations.
Examples
## Not run:
mudab_plc_stations(range = list(from = 0, count = 5))
## End(Not run)
List MUDAB project stations
Description
List MUDAB project stations
Usage
mudab_project_stations(
filter = NULL,
range = NULL,
orderby = NULL,
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
filter |
Optional filter definition. |
range |
Optional range specification. |
orderby |
Optional ordering specification. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns project stations from the MUDAB database. Official docs: https://mudab.api.bund.dev.
Value
A tibble with project stations.
Examples
## Not run:
mudab_project_stations(range = list(from = 0, count = 5))
## End(Not run)
List MUDAB stations
Description
List MUDAB stations
Usage
mudab_stations(
filter = NULL,
range = NULL,
orderby = NULL,
safe = TRUE,
refresh = FALSE
)
Arguments
filter |
Optional filter definition. |
range |
Optional range specification. |
orderby |
Optional ordering specification. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns measurement stations from the MUDAB database. Official docs: https://mudab.api.bund.dev.
Value
A tibble with stations.
Examples
## Not run:
mudab_stations(range = list(from = 0, count = 5))
## End(Not run)
Get MOWAS archive entry
Description
Get MOWAS archive entry
Usage
nina_archive_mowas(identifier, safe = TRUE, refresh = FALSE)
Arguments
identifier |
Warning identifier. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with archive entry data.
Get MOWAS archive mapping
Description
Get MOWAS archive mapping
Usage
nina_archive_mowas_mapping(identifier, safe = TRUE, refresh = FALSE)
Arguments
identifier |
Warning identifier. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with archive mapping data.
Get COVID info data
Description
Get COVID info data
Usage
nina_covid_infos(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with COVID info data.
Get COVID map data
Description
Get COVID map data
Usage
nina_covid_map(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with COVID map data.
Get COVID rules for an ARS
Description
Get COVID rules for an ARS
Usage
nina_covid_rules(ars, safe = TRUE, refresh = FALSE)
Arguments
ars |
ARS code. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with COVID rules data.
Get COVID ticker
Description
Get COVID ticker
Usage
nina_covid_ticker(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with COVID ticker data.
Get COVID ticker message
Description
Get COVID ticker message
Usage
nina_covid_ticker_message(id, safe = TRUE, refresh = FALSE)
Arguments
id |
Ticker message id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with ticker message data.
Get NINA dashboard data
Description
Get NINA dashboard data
Usage
nina_dashboard(ars, safe = TRUE, refresh = FALSE)
Arguments
ars |
ARS code. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns dashboard data for the given ARS code. Official docs: https://nina.api.bund.dev.
Value
A tibble with dashboard payload.
Get an event code file
Description
Get an event code file
Usage
nina_event_code(filename, safe = TRUE, refresh = FALSE)
Arguments
filename |
Event code filename. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with raw event code bytes.
List NINA event codes
Description
List NINA event codes
Usage
nina_event_codes(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with event codes.
Includes last_modification_time as POSIXct in Europe/Berlin.
List FAQs
Description
List FAQs
Usage
nina_faqs(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with FAQs.
Includes last_modification_time as POSIXct in Europe/Berlin.
Get a logo file
Description
Get a logo file
Usage
nina_logo(filename, safe = TRUE, refresh = FALSE)
Arguments
filename |
Logo file name. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with raw logo bytes.
List NINA logos
Description
List NINA logos
Usage
nina_logos(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with logo metadata.
Includes last_modification_time as POSIXct in Europe/Berlin.
List map data
Description
List map data
Usage
nina_mapdata(
source = c("katwarn", "biwapp", "mowas", "dwd", "lhp", "police"),
safe = TRUE,
refresh = FALSE
)
Arguments
source |
Map data source. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Valid sources are: katwarn, biwapp, mowas, dwd, lhp, police.
Value
A tibble with map data entries.
Includes start_date_time as POSIXct in Europe/Berlin.
Get MOWAS RSS feed
Description
Get MOWAS RSS feed
Usage
nina_mowas_rss(ars, safe = TRUE, refresh = FALSE)
Arguments
ars |
ARS code. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with RSS XML text.
List emergency tips
Description
List emergency tips
Usage
nina_notfalltipps(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with emergency tips.
Includes last_modification_time as POSIXct in Europe/Berlin.
Get data version info
Description
Get data version info
Usage
nina_version(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Value
A tibble with version data.
Includes last_modification_time as POSIXct in Europe/Berlin.
Get a NINA travel warning by content id
Description
Get a NINA travel warning by content id
Usage
nina_warning(content_id, safe = TRUE, refresh = FALSE)
Arguments
content_id |
Travel warning content id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns full travel warning content, including HTML blocks.
Value
A tibble with warning details.
Includes last_modified_time and effective_time as POSIXct in Europe/Berlin.
See Also
nina_warnings() for ids.
Examples
## Not run:
warnings <- nina_warnings()
nina_warning(warnings$content_id[[1]])
## End(Not run)
Get a NINA warning (GeoJSON)
Description
Get a NINA warning (GeoJSON)
Usage
nina_warning_geojson(identifier, safe = TRUE, refresh = FALSE)
Arguments
identifier |
Warning identifier. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns a warning in GeoJSON format.
Value
A tibble with geojson payload.
Get a NINA warning (JSON)
Description
Get a NINA warning (JSON)
Usage
nina_warning_json(identifier, safe = TRUE, refresh = FALSE)
Arguments
identifier |
Warning identifier. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns a warning in JSON format.
Value
A tibble with warning details.
Includes sent_time as POSIXct in Europe/Berlin.
See Also
nina_mapdata() to discover identifiers.
Examples
## Not run:
map <- nina_mapdata("mowas")
nina_warning_json(map$id[[1]])
## End(Not run)
List NINA travel warnings
Description
List NINA travel warnings
Usage
nina_warnings(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
The NINA API provides warnings and app data from the Bundesamt fuer Bevoelkerungsschutz. This endpoint returns a list of travel warnings with metadata. Official docs: https://nina.api.bund.dev.
Value
A tibble with warning metadata.
Includes last_modified_time and effective_time as POSIXct in Europe/Berlin.
See Also
nina_warning() for a single warning and nina_mapdata() for
map-based alerts.
Examples
## Not run:
nina_warnings()
## End(Not run)
Get Pegel-Online measurements
Description
Get Pegel-Online measurements
Usage
pegel_online_measurements(
station,
timeseries,
start = NULL,
end = NULL,
safe = TRUE,
refresh = FALSE
)
Arguments
station |
Station UUID, name, or number. |
timeseries |
Timeseries shortname. |
start |
Start timestamp in ISO 8601. |
end |
End timestamp in ISO 8601. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns measurement values for a station timeseries. Timestamps must be ISO 8601 strings. Official docs: https://pegel-online.api.bund.dev.
Value
A tibble with measurements.
Includes timestamp_time as POSIXct in Europe/Berlin.
See Also
pegel_online_timeseries() for metadata and
pegel_online_measurements_plot() for PNG plots.
Examples
## Not run:
stations <- pegel_online_stations(params = list(limit = 1))
pegel_online_measurements(stations$uuid[[1]], "W",
start = "2024-01-01T00:00:00Z",
end = "2024-01-02T00:00:00Z"
)
## End(Not run)
Get Pegel-Online measurements plot
Description
Get Pegel-Online measurements plot
Usage
pegel_online_measurements_plot(
station,
timeseries,
start = NULL,
end = NULL,
safe = TRUE,
refresh = FALSE
)
Arguments
station |
Station UUID, name, or number. |
timeseries |
Timeseries shortname. |
start |
Start timestamp in ISO 8601. |
end |
End timestamp in ISO 8601. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns a PNG plot for the measurements endpoint. Official docs: https://pegel-online.api.bund.dev.
Value
A tibble with raw PNG bytes.
See Also
pegel_online_measurements() for numeric values.
Examples
## Not run:
stations <- pegel_online_stations(params = list(limit = 1))
pegel_online_measurements_plot(stations$uuid[[1]], "W",
start = "2024-01-01T00:00:00Z",
end = "2024-01-02T00:00:00Z"
)
## End(Not run)
Get a Pegel-Online station
Description
Get a Pegel-Online station
Usage
pegel_online_station(
station,
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
station |
Station UUID, name, or number. |
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Fetches a single station record. Official docs: https://pegel-online.api.bund.dev.
Value
A tibble with station metadata.
See Also
pegel_online_stations() and pegel_online_timeseries().
Examples
## Not run:
stations <- pegel_online_stations(params = list(limit = 1))
pegel_online_station(stations$uuid[[1]])
## End(Not run)
List Pegel-Online stations
Description
List Pegel-Online stations
Usage
pegel_online_stations(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
The Pegel-Online API provides water level station metadata. Use query parameters to filter stations by water, ids, or location. Official docs: https://pegel-online.api.bund.dev.
Value
A tibble with station metadata.
See Also
pegel_online_station() for a single station and
pegel_online_measurements() for time series values.
Examples
## Not run:
pegel_online_stations(params = list(limit = 5))
## End(Not run)
Get Pegel-Online timeseries metadata
Description
Get Pegel-Online timeseries metadata
Usage
pegel_online_timeseries(
station,
timeseries,
params = list(),
safe = TRUE,
refresh = FALSE
)
Arguments
station |
Station UUID, name, or number. |
timeseries |
Timeseries shortname. |
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns metadata for a timeseries, including unit and gauge zero. Official docs: https://pegel-online.api.bund.dev.
Value
A tibble with timeseries metadata.
See Also
pegel_online_measurements() for measurement values.
Examples
## Not run:
stations <- pegel_online_stations(params = list(limit = 1))
pegel_online_timeseries(stations$uuid[[1]], "W")
## End(Not run)
List Pegel-Online waters
Description
List Pegel-Online waters
Usage
pegel_online_waters(
params = list(),
safe = TRUE,
refresh = FALSE,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
params |
Query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Lists waters available in Pegel-Online. Official docs: https://pegel-online.api.bund.dev.
Value
A tibble with water metadata.
See Also
pegel_online_stations() for station metadata.
Examples
## Not run:
pegel_online_waters(params = list(limit = 5))
## End(Not run)
List approved applications
Description
List approved applications
Usage
psm_anwendungen(
kennr = NULL,
awg_id = NULL,
params = list(),
safe = TRUE,
refresh = FALSE
)
Arguments
kennr |
Optional product identification number. |
awg_id |
Optional application identifier (16 characters). |
params |
Additional query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns approved applications (Anwendungsgebiete) which define the combinations of products, crops, and pests for which use is permitted.
Value
A tibble with application data.
See Also
psm_mittel() to list products.
Examples
## Not run:
psm_anwendungen(kennr = "024780-00")
## End(Not run)
List crop groups
Description
List crop groups
Usage
psm_kultur_gruppen(params = list(), safe = TRUE, refresh = FALSE)
Arguments
params |
Additional query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns hierarchical crop group classifications.
Value
A tibble with crop group data.
Examples
## Not run:
psm_kultur_gruppen()
## End(Not run)
List approved plant protection products
Description
List approved plant protection products
Usage
psm_mittel(kennr = NULL, params = list(), safe = TRUE, refresh = FALSE)
Arguments
kennr |
Optional product identification number (9 characters). |
params |
Additional query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
The Pflanzenschutzmittelzulassung API provides access to Germany's plant protection product database from the Bundesamt fuer Verbraucherschutz und Lebensmittelsicherheit (BVL). This function returns approved pesticides. Official docs: https://github.com/bundesAPI/pflanzenschutzmittelzulassung-api.
Value
A tibble with plant protection product data.
See Also
psm_wirkstoffe() to list active ingredients,
psm_stand() for data version.
Examples
## Not run:
psm_mittel()
psm_mittel(kennr = "024780-00")
## End(Not run)
List pest groups
Description
List pest groups
Usage
psm_schadorg_gruppen(params = list(), safe = TRUE, refresh = FALSE)
Arguments
params |
Additional query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns hierarchical pest/pathogen group classifications.
Value
A tibble with pest group data.
Examples
## Not run:
psm_schadorg_gruppen()
## End(Not run)
Get data version
Description
Get data version
Usage
psm_stand(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns the release date/version of the plant protection product database.
Value
A tibble with version information.
Examples
## Not run:
psm_stand()
## End(Not run)
List active ingredients
Description
List active ingredients
Usage
psm_wirkstoffe(
wirkstoffId = NULL,
params = list(),
safe = TRUE,
refresh = FALSE
)
Arguments
wirkstoffId |
Optional active ingredient ID. |
params |
Additional query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns active ingredients (Wirkstoffe) from the plant protection product database.
Value
A tibble with active ingredient data.
See Also
psm_mittel() to list products.
Examples
## Not run:
psm_wirkstoffe()
## End(Not run)
Query Regionalatlas data
Description
Query Regionalatlas data
Usage
regionalatlas_query(
table,
where = "1=1",
out_fields = "*",
return_geometry = FALSE,
params = list(),
safe = TRUE,
refresh = FALSE
)
Arguments
table |
Table name containing indicators (e.g., "ai002_1_5" for population density). See Details for common tables. |
where |
Optional SQL WHERE clause for filtering. |
out_fields |
Fields to return (default "*" for all). |
return_geometry |
Logical; include geometry in response. |
params |
Additional query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
The Regionalatlas API provides access to over 160 regional indicators from the German statistical offices. Data is available at various administrative levels (Bundeslaender, Regierungsbezirke, Kreise, Gemeinden). Official docs: https://github.com/bundesAPI/regionalatlas-api.
Common tables and their indicators:
-
ai002_1_5: Population (ai0201=density, ai0202=change, ai0208=foreigners %) -
ai002_4_5: Age (ai0218=average age, ai0219=mother age at 1st child) -
ai008_1_5: Employment (ai0801=unemployment rate) -
ai_s_01: Disposable income per capita -
ai_s_04: SGB-II quota -
ai017_1: GDP per employee -
ai005: Federal election results
Regional levels in data: typ 1=Bundeslaender, 2=Regierungsbezirke, 3=Kreise,
5=Gemeinden. Filter using WHERE clause, e.g., where = "typ = 1".
Value
A tibble with regional indicator data.
See Also
bunddev_parameters() for available query parameters.
Examples
## Not run:
# Population density indicators
regionalatlas_query("ai002_1_5")
# Filter for Bundeslaender only
regionalatlas_query("ai002_1_5", where = "typ = 1")
# Age data for Kreise
regionalatlas_query("ai002_4_5", where = "typ = 3")
## End(Not run)
List available SMARD timestamps
Description
List available SMARD timestamps
Usage
smard_indices(
filter,
region = "DE",
resolution = "hour",
safe = TRUE,
refresh = FALSE
)
Arguments
filter |
Filter id. |
region |
Region code. |
resolution |
Data resolution. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
The SMARD API provides power market data published by the Bundesnetzagentur. Use this helper to retrieve available timestamps for a given filter/region and resolution. Official docs: https://smard.api.bund.dev.
Note: The registry rate limit states that more than 60 requests per hour are
not permitted. Use safe = TRUE to respect the limit.
Value
A tibble of timestamps.
See Also
smard_timeseries() and smard_table() for data retrieval, and
bunddev_parameters() for parameter discovery.
Examples
## Not run:
smard_indices(410, region = "DE", resolution = "hour")
## End(Not run)
Fetch SMARD table data
Description
Fetch SMARD table data
Usage
smard_table(filter, region = "DE", timestamp, safe = TRUE, refresh = FALSE)
Arguments
filter |
Filter id. |
region |
Region code. |
timestamp |
Timestamp from indices (ms), POSIXct, or Date. Timestamps are interpreted in the Europe/Berlin timezone. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns table-style SMARD data for a single timestamp. Use
smard_indices() to obtain a valid timestamp. Official docs:
https://smard.api.bund.dev.
Value
A tibble of table values.
Includes a time column with POSIXct timestamps in Europe/Berlin.
See Also
smard_indices() for timestamps and smard_timeseries() for time series.
Examples
## Not run:
indices <- smard_indices(410, region = "DE", resolution = "hour")
smard_table(410, region = "DE", timestamp = indices$timestamp[[1]])
## End(Not run)
Fetch SMARD timeseries data
Description
Fetch SMARD timeseries data
Usage
smard_timeseries(
filter,
region = "DE",
resolution = "hour",
timestamp,
safe = TRUE,
refresh = FALSE
)
Arguments
filter |
Filter id. |
region |
Region code. |
resolution |
Data resolution. |
timestamp |
Timestamp from indices (ms), POSIXct, or Date. Timestamps are interpreted in the Europe/Berlin timezone. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns a tidy time series for a single filter/region. Use
smard_indices() to obtain a valid timestamp. Official docs:
https://smard.api.bund.dev.
Value
A tibble of time series values.
Includes a time column with POSIXct timestamps in Europe/Berlin.
See Also
smard_indices() for timestamps and smard_table() for table output.
Examples
## Not run:
indices <- smard_indices(410, region = "DE", resolution = "hour")
smard_timeseries(410, region = "DE", resolution = "hour", timestamp = indices$timestamp[[1]])
## End(Not run)
Fetch Tagesschau channels
Description
Fetch Tagesschau channels
Usage
tagesschau_channels(flatten = FALSE, flatten_mode = "json")
Arguments
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Lists the Tagesschau channels endpoint. Official docs: https://bundesapi.github.io/tagesschau-api/.
Value
A tibble with channels.
Includes date_time as POSIXct in Europe/Berlin.
See Also
tagesschau_news() and tagesschau_homepage().
Examples
## Not run:
tagesschau_channels(flatten = TRUE)
## End(Not run)
Fetch Tagesschau homepage items
Description
Fetch Tagesschau homepage items
Usage
tagesschau_homepage(flatten = FALSE, flatten_mode = "json")
Arguments
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Fetches the Tagesschau homepage feed as provided by the ARD Tagesschau API. Official docs: https://bundesapi.github.io/tagesschau-api/.
Note: The registry rate limit allows up to 60 requests per hour. Usage of content is restricted to private, non-commercial use unless otherwise stated by the source (see Tagesschau CC license notes).
Value
A tibble with homepage items.
Includes date_time as POSIXct in Europe/Berlin.
See Also
tagesschau_news(), tagesschau_search(), and tagesschau_channels().
Examples
## Not run:
tagesschau_homepage(flatten = TRUE)
## End(Not run)
Fetch Tagesschau news items
Description
Fetch Tagesschau news items
Usage
tagesschau_news(
regions = NULL,
ressort = NULL,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
regions |
Optional region ids. |
ressort |
Optional ressort filter. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Returns current news items with optional filters for region or ressort. Official docs: https://bundesapi.github.io/tagesschau-api/.
Value
A tibble with news items.
Includes date_time as POSIXct in Europe/Berlin.
See Also
tagesschau_homepage() and tagesschau_search().
Examples
## Not run:
tagesschau_news(ressort = "inland", flatten = TRUE)
## End(Not run)
Search Tagesschau content
Description
Search Tagesschau content
Usage
tagesschau_search(
search_text = NULL,
page_size = NULL,
result_page = NULL,
flatten = FALSE,
flatten_mode = "json"
)
Arguments
search_text |
Query string. |
page_size |
Results per page. |
result_page |
Result page index. |
flatten |
Logical; drop nested list columns. |
flatten_mode |
Flatten strategy for list columns. Use "unnest" to expand list-columns into multiple rows. |
Details
Searches Tagesschau content by free-text query. Official docs: https://bundesapi.github.io/tagesschau-api/.
Value
A tibble with search results.
Includes date_time as POSIXct in Europe/Berlin.
See Also
tagesschau_news() and tagesschau_homepage().
Examples
## Not run:
tagesschau_search(search_text = "energie", page_size = 10, flatten = TRUE)
## End(Not run)
List healthcare documents
Description
List healthcare documents
Usage
travelwarning_healthcare(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns healthcare documents provided by the Auswaertiges Amt. Official docs: https://travelwarning.api.bund.dev.
Value
A tibble with healthcare entries.
Includes last_modified_time as POSIXct in Europe/Berlin.
Examples
## Not run:
travelwarning_healthcare()
## End(Not run)
List German representatives in foreign countries
Description
List German representatives in foreign countries
Usage
travelwarning_representatives_country(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns a list of German representatives in foreign countries. Official docs: https://travelwarning.api.bund.dev.
Value
A tibble with representatives.
Includes last_modified_time as POSIXct in Europe/Berlin.
Examples
## Not run:
travelwarning_representatives_country()
## End(Not run)
List foreign representatives in Germany
Description
List foreign representatives in Germany
Usage
travelwarning_representatives_germany(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns a list of foreign representatives in Germany. Official docs: https://travelwarning.api.bund.dev.
Value
A tibble with representatives.
Includes last_modified_time as POSIXct in Europe/Berlin.
Examples
## Not run:
travelwarning_representatives_germany()
## End(Not run)
List state names documents
Description
List state names documents
Usage
travelwarning_state_names(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns documents with state name information. Official docs: https://travelwarning.api.bund.dev.
Value
A tibble with state name entries.
Includes last_modified_time as POSIXct in Europe/Berlin.
Examples
## Not run:
travelwarning_state_names()
## End(Not run)
Get a travel warning by content id
Description
Get a travel warning by content id
Usage
travelwarning_warning(content_id, safe = TRUE, refresh = FALSE)
Arguments
content_id |
Travel warning content id. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns the full travel warning content, including HTML blocks. Official docs: https://travelwarning.api.bund.dev.
Value
A tibble with travel warning details.
Includes last_modified_time and effective_time as POSIXct in Europe/Berlin.
See Also
travelwarning_warnings() to list available ids.
Examples
## Not run:
warnings <- travelwarning_warnings()
travelwarning_warning(warnings$content_id[[1]])
## End(Not run)
List travel warnings
Description
List travel warnings
Usage
travelwarning_warnings(safe = TRUE, refresh = FALSE)
Arguments
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
The travelwarning API provides travel and safety information from the Auswaertiges Amt. This endpoint returns a list of all travel warnings with metadata. Official docs: https://travelwarning.api.bund.dev.
Value
A tibble with travel warnings.
Includes last_modified_time and effective_time as POSIXct in Europe/Berlin.
See Also
travelwarning_warning() for full details of a single warning.
Examples
## Not run:
travelwarning_warnings()
## End(Not run)
Get faceted overview of courses
Description
Get faceted overview of courses
Usage
weiterbildungssuche_facetten(
sw = NULL,
params = list(),
safe = TRUE,
refresh = FALSE
)
Arguments
sw |
Search keyword. |
params |
Additional query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns a faceted overview of available training offerings with counts by category.
Value
A tibble with facet data.
See Also
weiterbildungssuche_search() for full course search.
Examples
## Not run:
weiterbildungssuche_facetten(sw = "BWL")
## End(Not run)
Search continuing education courses
Description
Search continuing education courses
Usage
weiterbildungssuche_search(
sw = NULL,
orte = NULL,
uk = NULL,
page = NULL,
params = list(),
safe = TRUE,
refresh = FALSE
)
Arguments
sw |
Search keyword. |
orte |
Location with coordinates (format: "City_lat_lon"). |
uk |
Search radius in km (25, 50, 100, 150, 200, or "bundesweit"). |
page |
Result page number. |
params |
Additional query parameters. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
The Weiterbildungssuche API provides access to one of Germany's largest
continuing education databases from the Bundesagentur fuer Arbeit.
Authentication uses the public client id infosysbub-wbsuche as X-API-Key.
Official docs: https://bundesapi.github.io/weiterbildungssuche-api/.
Common parameters include:
-
sys: C = vocational, FW = advanced, empty = both -
uz: 1 = full-time, 2 = part-time -
uf: 1 = in-person, 2 = online, 3 = blended, 4 = distance -
bg: 1 = education voucher eligible
Value
A tibble with course offerings.
See Also
weiterbildungssuche_facetten() for faceted search overview.
Examples
## Not run:
weiterbildungssuche_search(sw = "Projektmanagement")
weiterbildungssuche_search(sw = "IT", orte = "Berlin_52.52_13.405", uk = 50)
## End(Not run)
Get product categories
Description
Get product categories
Usage
zoll_kategorien(last_modified_date = NULL, safe = TRUE, refresh = FALSE)
Arguments
last_modified_date |
Optional datetime to retrieve only changes after this date. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns product category database.
Value
A tibble with category data.
Examples
## Not run:
zoll_kategorien()
## End(Not run)
Get exchange rates for customs calculations
Description
Get exchange rates for customs calculations
Usage
zoll_kurse(last_modified_date = NULL, safe = TRUE, refresh = FALSE)
Arguments
last_modified_date |
Optional datetime to retrieve only changes after this date (format: "YYYY-MM-DD" or "YYYY-MM-DDTHH:MM:SS"). |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
The Zoll API provides import tariff and exchange rate data from the German Federal Ministry of Finance. This function returns currency exchange rates used for customs calculations. Official docs: https://zoll.api.bund.dev.
Value
A tibble with exchange rate data.
See Also
zoll_produkte() for product tariffs,
zoll_laender() for country data.
Examples
## Not run:
zoll_kurse()
## End(Not run)
Get country data for customs
Description
Get country data for customs
Usage
zoll_laender(last_modified_date = NULL, safe = TRUE, refresh = FALSE)
Arguments
last_modified_date |
Optional datetime to retrieve only changes after this date. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns country information and classifications for customs purposes.
Value
A tibble with country data.
See Also
zoll_produkte() for products.
Examples
## Not run:
zoll_laender()
## End(Not run)
Get product tariff data
Description
Get product tariff data
Usage
zoll_produkte(last_modified_date = NULL, safe = TRUE, refresh = FALSE)
Arguments
last_modified_date |
Optional datetime to retrieve only changes after this date. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns product database with import tariff rates.
Value
A tibble with product tariff data.
See Also
zoll_kurse() for exchange rates,
zoll_produktgruppen() for product groups.
Examples
## Not run:
zoll_produkte()
## End(Not run)
Get product groups
Description
Get product groups
Usage
zoll_produktgruppen(last_modified_date = NULL, safe = TRUE, refresh = FALSE)
Arguments
last_modified_date |
Optional datetime to retrieve only changes after this date. |
safe |
Logical; apply throttling and caching. |
refresh |
Logical; refresh cached responses. |
Details
Returns product group classifications.
Value
A tibble with product group data.
Examples
## Not run:
zoll_produktgruppen()
## End(Not run)