esp_dict: Convert and translate Spanish subdivision names and codes

In mapSpain: Administrative Boundaries and Static Map Tiles for Spain

Convert and translate Spanish subdivision names and codes

Description

Convert Spanish subdivision names or identifiers among coding schemes such as NUTS, ISO2 and province codes. The function can also return human-readable names.

Usage

esp_dict_region_code(sourcevar, origin = "text", destination = "text")

esp_dict_translate(sourcevar, lang = "en", all = FALSE)

Arguments

sourcevar	Character string. Vector that contains the codes or names to be converted.
origin, destination	Character string. Coding scheme of origin and destination. One of "text", "nuts", "iso2", "codauto" or "cpro".
lang	Character string. Target language code. Available values are "es" (Spanish), "en" (English), "ca" (Catalan), "ga" (Galician) and "eu" (Basque).
all	Logical. If TRUE the function returns all possible translations for each input as a named list. When FALSE (default), a single preferred translation per input is returned as a character vector.

Details

This function uses internal dictionaries together with countrycode to map between schemes. When ⁠origin == destination == "text"⁠ the input is returned unchanged. Mixing names from different administrative levels, for example Autonomous Community or City and province, may produce NA values for some entries.

Value

esp_dict_region_code() returns a character vector with converted subdivision identifiers or names. If a value cannot be matched, the corresponding element will be NA and a warning is emitted via cli::cli_warn().

esp_dict_translate() translates a vector of names from one language to another. If all = FALSE, it returns a character vector with the translated name for each element of sourcevar. If all = TRUE, it returns a named list where each element contains all available translations for the corresponding input value.

See Also

• countrycode::countrycode() converts country codes and names.

• esp_codelist documents the supported Spanish subdivision codes.

Examples

vals <- c("Errioxa", "Coruna", "Gerona", "Madrid")

esp_dict_region_code(vals)
esp_dict_region_code(vals, destination = "nuts")
esp_dict_region_code(vals, destination = "cpro")
esp_dict_region_code(vals, destination = "iso2")

# From ISO2 to other codes.

iso2vals <- c("ES-M", "ES-S", "ES-SG")
esp_dict_region_code(iso2vals, origin = "iso2")
esp_dict_region_code(iso2vals,
  origin = "iso2",
  destination = "nuts"
)
esp_dict_region_code(iso2vals,
  origin = "iso2",
  destination = "cpro"
)

# Mixing levels.
valsmix <- c("Centro", "Andalucia", "Seville", "Menorca")
esp_dict_region_code(valsmix, destination = "nuts")

esp_dict_region_code(valsmix, destination = "codauto")
esp_dict_region_code(valsmix, destination = "iso2")

vals <- c("La Rioja", "Sevilla", "Madrid", "Jaen", "Orense", "Baleares")

esp_dict_translate(vals)
esp_dict_translate(vals, lang = "es")
esp_dict_translate(vals, lang = "ca")
esp_dict_translate(vals, lang = "eu")
esp_dict_translate(vals, lang = "ga")

esp_dict_translate(vals, lang = "ga", all = TRUE)

mapSpain documentation built on Aug. 31, 2026, 5:07 p.m.