gisco_bulk_download: GISCO API bulk download

In giscoR: Download Map Data from GISCO API - Eurostat

GISCO API bulk download

Description

Download zipped data from GISCO to the cache_dir and extract the relevant ones.

Usage

gisco_bulk_download(
  id = c("countries", "coastal_lines", "communes", "lau", "nuts", "urban_audit",
    "postal_codes"),
  year = 2016,
  cache_dir = NULL,
  update_cache = FALSE,
  verbose = FALSE,
  resolution = 10,
  ext = c("shp", "geojson", "svg", "json", "gdb"),
  recursive = deprecated(),
  ...
)

Arguments

id	character string or number. Type of dataset to be downloaded, see Details. Values supported are: "countries" "coastal_lines" "communes" "lau" "nuts" "urban_audit" "postal_codes" This argument replaces the previous (deprecated) argument id_giscoR.
year	character string or number. Release year of the file, see Details.
cache_dir	character string. A path to a cache directory. See Caching strategies section in gisco_set_cache_dir().
update_cache	logical. Should the cached file be refreshed?. Default is FALSE. When set to TRUE it would force a new download.
verbose	logical. If TRUE displays informational messages.
resolution	character string or number. Resolution of the geospatial data. One of: "60": 1:60 million. "20": 1:20 million. "10": 1:10 million. "03": 1:3 million. "01": 1:1 million.
ext	Extension of the file(s) to be downloaded. Formats available are "shp", "geojson", "svg", "json", "gdb". See Details.
recursive	recursive is no longer supported; this function will never perform recursive extraction of child .zip files. This is the case of "shp.zip inside the top-level .zip, that won't be unzipped.
...	Ignored. The argument id_giscoR () would be captured via ... and re-directed to id with a warning.

Details

Some arguments only apply to a specific value of "id". For example "resolution" would be ignored for values "communes", "lau", "urban_audit" and "postal_codes".

See years available in the corresponding functions:

• gisco_get_countries().

• gisco_get_coastal_lines().

• gisco_get_communes().

• gisco_get_lau().

• gisco_get_nuts().

• gisco_get_urban_audit().

• gisco_get_postal_codes().

The usual extensions used across giscoR are "gpkg" and "shp", however other formats are already available on GISCO. Note that after performing a bulk download you may need to adjust the default "ext" value in the corresponding function to connect it with the downloaded files (see Examples).

Value

A (invisible) character vector with the full path of the files extracted. See Examples.

Source

https://gisco-services.ec.europa.eu/distribution/v2/.

See Also

Additional utils for downloading datasets: gisco_get_unit

Examples

tmp <- file.path(tempdir(), "testexample")

dest_files <- gisco_bulk_download(
  id = "countries", resolution = 60,
  year = 2024, ext = "geojson",
  cache_dir = tmp
)
# Read one
library(sf)
read_sf(dest_files[1]) |> head()

# Now we can connect the function with the downloaded data like:

connect <- gisco_get_countries(
  resolution = 60,
  year = 2024, ext = "geojson",
  cache_dir = tmp, verbose = TRUE
)

# Message shows that file is already cached ;)

# Clean
unlink(tmp, force = TRUE)

giscoR documentation built on Dec. 10, 2025, 9:08 a.m.