Local Administrative Units are the building blocks of NUTS and other
statistical regions. They comprise municipalities and communes in the
European Statistical System. See gisco_get_communes() for the separate
commune dataset.
Usage
gisco_get_lau(
year = 2024,
epsg = 4326,
cache = deprecated(),
update_cache = FALSE,
cache_dir = NULL,
verbose = FALSE,
country = NULL,
gisco_id = NULL,
ext = "gpkg"
)Source
GISCO Local Administrative Units distribution API: https://gisco-services.ec.europa.eu/distribution/v2/lau/.
Arguments
- year
A character string or numeric value with the release year of the file. One of
"2024","2023","2022","2021","2020","2019","2018","2017","2016","2015","2014","2013","2012","2011".- epsg
A character string or numeric value with the coordinate reference system as a 4-digit EPSG code. One of:
"4326": WGS84."3035": ETRS89 / ETRS-LAEA."3857": Pseudo-Mercator.
- cache
. This function always caches the source file because of its size. See Caching strategies in
gisco_set_cache_dir().- update_cache
A logical value indicating whether to refresh the cached file. Defaults to
FALSE. When set toTRUE, it forces a new download.- cache_dir
A character string with a path to a cache directory. See the Caching strategies section in
gisco_set_cache_dir().- verbose
A logical value indicating whether to display informational messages.
- country
A character vector of country names, ISO 3166-1 alpha-3 codes or Eurostat country codes. See
countrycode::countrycode().- gisco_id
An optional character vector of LAU identifiers from the
GISCO_IDcolumn. If you also supplycountry, the result includes rows matching either filter.- ext
A character string with the extension of the file (default
"gpkg"). One of"shp","gpkg","geojson".
Value
An sf object or NULL if the download fails.
Details
The Nomenclature of Territorial Units for Statistics (NUTS) and the LAU nomenclature are hierarchical classifications of statistical regions that together subdivide the EU economic territory into statistical regions and local units, moving from larger to smaller territorial units: NUTS 1, 2 and 3 and LAU.
The LAU classification is not covered by any legislative act. Geographical extent covers the European Union, EFTA countries and candidate countries. The scale of the dataset is 1:100 000.
The data contain the National Statistical Agency LAU code, which can be
joined to LAU lists. They also contain a GISCO_ID field, which is a
unique identifier consisting of the country code and LAU code.
Total resident population figures (31 December) have also been added in some versions based on the associated LAU lists.
Copyright
See the GISCO statistical unit copyright provisions: https://ec.europa.eu/eurostat/web/gisco/geodata/statistical-units.
Note
Check the download and usage provisions in gisco_attributions().
See also
See gisco_bulk_download() to perform a bulk download of datasets.
See gisco_id_api_lau() to download via the GISCO ID service API.
Statistical unit datasets:
gisco_get_census(),
gisco_get_coastal_lines(),
gisco_get_nuts(),
gisco_get_urban_audit()
Examples
# \dontrun{
lu_lau <- gisco_get_lau(year = 2024, country = "Luxembourg")
#> ! The file to download is "74.6 Mb".
if (!is.null(lu_lau) && requireNamespace("ggplot2", quietly = TRUE)) {
library(ggplot2)
ggplot(lu_lau) +
geom_sf(aes(fill = POP_DENS_2024)) +
labs(
title = "Population density in Luxembourg",
subtitle = "Year 2024",
caption = gisco_attributions()
) +
scale_fill_viridis_b(
option = "cividis",
label = \(x) prettyNum(x, big.mark = ",")
) +
theme_void() +
labs(fill = "pop/km2")
}
# }
