Skip to contents

NUTS regions

bkg_nuts.Rd

Retrieve polygons of NUTS regions.

This function interfaces the nuts* products of the BKG.

Usage

bkg_nuts(
  level = c("1", "2", "3"),
  scale = c("250", "1000", "2500", "5000"),
  key_date = c("0101", "1231"),
  year = "latest",
  timeout = 120,
  update_cache = FALSE
)

Arguments

level

NUTS level to download. Can be "1" (federal states), "2" (inconsistent, something between states and government regions), or "3" (districts). Defaults to federal states.

scale

Scale of the geometries. Can be "250" (1:250,000), "1000" (1:1,000,000), "2500" (1:2,500,000) or "5000" (1:5,000,000). If "250", population data is included in the output. Defaults to "250".

key_date

For resolution %in% c("250", "5000"), specifies the key date from which to download administrative data. Can be either "0101" (January 1) or "1231" (December 31). The latter is able to georeference statistical data while the first integrates changes made in the new year. If "1231", population data is attached, otherwise not. Note that population data is not available at all scales (usually 250 and 1000). Defaults to "0101".

year

Version year of the dataset. You can use latest to retrieve the latest dataset version available on the BKG's geodata center. Older versions can be browsed using the archive.

timeout

Timeout value for the data download passed to req_timeout. Adjust this if your internet connection is slow or you are downloading larger datasets.

update_cache

By default, downloaded files are cached in the tempdir() directory of R. When downloading the same data again, the data is not downloaded but instead taken from the cache. Sometimes this can be not the desired behavior. If you want to overwrite the cache, pass TRUE. Defaults to FALSE, i.e. always adopt the cache if possible.

Value

An sf dataframe with multipolygon geometries and the following columns:

  • GF: Integer representing the geofactor; whether an area is "structured" or not. Land is structured if it is part of a state or other administrative unit but is not further divided into administrative units. Can be one of

    • 1: Unstructured, waterbody

    • 2: Structured, waterbody

    • 3: Unstructured, land

    • 4: Structured, land

  • NUTS_LEVEL: NUTS level. Can be one of

    • 1: NUTS-1; federal states

    • 2: NUTS-2; inconsistent, somewhere between government regions and federal states

    • 3: NUTS-3; districts

  • NUTS_CODE: Hierarchical key of the NUTS region. Can have a different number of characters depending on the NUTS level:

    • NUTS-1: three digits

    • NUTS-2: four digits

    • NUTS-3: five digits

  • NUTS_NAME: Geographical name of the NUTS region

Note

This function does not query a WFS so you are only able to download entire datasets without the ability to filter beforehand.

Examples

if (FALSE) { # getFromNamespace("ffm_run_examples", ns = "ffm")()
# Download NUTS state data from 2020
bkg_nuts(scale = "5000", year = 2020)

# Download the latest NUTS district data
bkg_nuts(level = "3")
}