Retrieve Destatis cube data

Retrieve Destatis cube data

Usage

destatis_data_cube(
  name,
  params = list(),
  username = "GAST",
  password = "GAST",
  safe = TRUE,
  refresh = FALSE
)

Arguments

name

Cube id.

params

Named list of Genesis API query parameters. Common keys:

username

Genesis username (added automatically from username if missing).

password

Genesis password (added automatically from password if missing).

name

Table/cube name for data endpoints (also set by name argument).

selection

Selection filter expression (character).

area

Regional scope code (character).

pagelength

Maximum number of returned entries (integer).

language

Response language code (character).

searchcriterion

Catalogue search field (character).

sortcriterion

Catalogue sort field (character).

type

Resource type filter (character).

startyear

Start year filter (integer).

endyear

End year filter (integer).

username

Genesis username (default "GAST").

password

Genesis password (default "GAST").

safe

Logical; if TRUE (default), apply rate-limiting and cache GET responses to tools::R_user_dir("bunddev", "cache").

refresh

Logical; if TRUE, ignore cached responses and re-fetch from the API (default FALSE).

Value

A one-row tibble with:

name

Requested cube id (character).

data

Raw response body (typically CSV/text) (character).

Details

Returns cube data as text (csv by default). API documentation: https://github.com/bundesAPI/destatis-api.

See also

bunddev_parameters() to inspect available query parameters.

Other Destatis: destatis_catalogue_cubes(), destatis_catalogue_tables(), destatis_data_table()

Examples

if (FALSE) { # \dontrun{
destatis_data_cube("21231BJ001")
} # }