esp_get_ccaa: Autonomous Communities of Spain - GISCO

In mapSpain: Administrative Boundaries of Spain

Autonomous Communities of Spain - GISCO

Description

Returns Autonomous Communities of Spain at a specified scale.

Usage

esp_get_ccaa(ccaa = NULL, moveCAN = TRUE, ...)

Arguments

ccaa	character string. A vector of names and/or codes for Autonomous Communities or NULL to get all the autonomous communities. See Details.
moveCAN	A logical TRUE/FALSE or a vector of coordinates c(lat, lon). It places the Canary Islands close to Spain's mainland. Initial position can be adjusted using the vector of coordinates. See Displacing the Canary Islands in esp_move_can().
...	Arguments passed on to esp_get_nuts year year character string or number. Release year of the file. See giscoR::gisco_get_nuts() for valid values. epsg character string or number. Projection of the map: 4-digit EPSG code. One of: "4258": ETRS89 "4326": WGS84. "3035": ETRS89 / ETRS-LAEA. "3857": Pseudo-Mercator. cache logical. Whether to do caching. Default is TRUE. See Caching strategies section in esp_set_cache_dir(). update_cache logical. Should the cached file be refreshed? Default is FALSE. When set to TRUE, it will force a new download. cache_dir character string. A path to a cache directory. See Caching strategies section in esp_set_cache_dir(). spatialtype character string. Type of geometry to be returned. Options available are: "RG": Regions - MULTIPOLYGON/POLYGON object. "LB": Labels - POINT object. ext character. Extension of the file (default "gpkg"). See giscoR::gisco_get_nuts(). 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.

Details

When using ccaa you can use and mix names and NUTS codes (levels 1 or 2), ISO codes (corresponding to level 2) or codauto (see esp_codelist). Ceuta and Melilla are considered as Autonomous Communities in this function.

When calling a NUTS1 level, all the Autonomous Communities of that level will be added.

Value

A sf object.

Note

Please check the download and usage provisions on gisco_attributions().

Source

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

Copyright: https://ec.europa.eu/eurostat/web/gisco/geodata/administrative-units.

See Also

Other datasets representing political borders: esp_get_capimun(), esp_get_ccaa_siane(), esp_get_comarca(), esp_get_countries_siane(), esp_get_gridmap, esp_get_munic(), esp_get_munic_siane(), esp_get_nuts(), esp_get_prov(), esp_get_prov_siane(), esp_get_simpl, esp_get_spain(), esp_get_spain_siane(), esp_siane_bulk_download()

Datasets provided by GISCO: esp_get_munic(), esp_get_nuts(), esp_get_prov(), esp_get_spain()

Examples

ccaa <- esp_get_ccaa()

library(ggplot2)

ggplot(ccaa) +
  geom_sf()

# Random CCAA
random_ccaa <- esp_get_ccaa(ccaa = c(
  "Euskadi",
  "Catalunya",
  "ES-EX",
  "Canarias",
  "ES52",
  "01"
))


ggplot(random_ccaa) +
  geom_sf(aes(fill = codauto), show.legend = FALSE) +
  geom_sf_label(aes(label = codauto), alpha = 0.3) +
  coord_sf(crs = 3857)

# All CCAA of a Zone plus an addition

mixed <- esp_get_ccaa(ccaa = c("La Rioja", "Noroeste"))

ggplot(mixed) +
  geom_sf()

# Combine with giscoR to get countries


library(giscoR)
library(sf)

res <- 20 # Set same resoluion

europe <- gisco_get_countries(resolution = res)
ccaa <- esp_get_ccaa(moveCAN = FALSE, resolution = res)


ggplot(europe) +
  geom_sf(fill = "#DFDFDF", color = "#656565") +
  geom_sf(data = ccaa, fill = "#FDFBEA", color = "#656565") +
  coord_sf(
    xlim = c(23, 74) * 10e4,
    ylim = c(14, 55) * 10e4,
    crs = 3035
  ) +
  theme(panel.background = element_rect(fill = "#C7E7FB"))

mapSpain documentation built on Jan. 17, 2026, 9:07 a.m.