R/data.R

In giscoR: Download 'Eurostat' 'GISCO' Spatial Data

#' Cached GISCO database
#'
#' Database with the list of files in the GISCO geodata distribution as of
#' `r unique(giscoR::gisco_db$last_updated)`.
#'
#' @name gisco_db
#' @docType data
#' @family datasets
#' @family database
#' @keywords datasets
#' @format
#' A [tibble][tibble::tbl_df] with
#' `r prettyNum(nrow(giscoR::gisco_db), big.mark = ",")` rows.
#'
#' @details
#' This database is used to redirect the corresponding functions to the
#' correct API endpoints.
#'
#' This version of the database is used if an update fails.
#' Please use [gisco_get_cached_db()] with `update_cache = TRUE` to update the
#' corresponding API endpoints.
#'
#' @source GISCO geodata distribution `datasets.json`.
#'
#' @seealso [gisco_get_metadata()] and [gisco_get_cached_db()].
#' @encoding UTF-8
#'
#' @examplesIf requireNamespace("dplyr", quietly = TRUE)
#' data("gisco_db")
#' gisco_db |>
#'   dplyr::glimpse()
NULL

#' Countries 2024 [`sf`][sf::st_sf] object
#'
#' @description
#' This object contains world administrative boundaries at the country level.
#'
#' @name gisco_countries_2024
#' @docType data
#' @family datasets
#' @keywords datasets
#' @format
#' An [`sf`][sf::st_sf] object with `MULTIPOLYGON` geometries, resolution:
#' 1:20 million and [EPSG:4326](https://epsg.io/4326). It has
#' `r nrow(giscoR::gisco_countries_2024)` rows and 12 variables:
#' \describe{
#'   \item{`CNTR_ID`}{Country ID from Eurostat.}
#'   \item{`CNTR_NAME`}{Official country name in the local language.}
#'   \item{`NAME_ENGL`}{Country name in English.}
#'   \item{`NAME_FREN`}{Country name in French.}
#'   \item{`ISO3_CODE`}{ISO 3166-1 alpha-3 code of each country from
#'   GISCO.}
#'   \item{`SVRG_UN`}{Sovereign status according to the United Nations.}
#'   \item{`CAPT`}{Capital city.}
#'   \item{`EU_STAT`}{European Union member.}
#'   \item{`EFTA_STAT`}{EFTA member.}
#'   \item{`CC_STAT`}{EU candidate member.}
#'   \item{`NAME_GERM`}{Country name in German.}
#'   \item{`geometry`}{Geometry field.}
#' }
#'
#' @inheritSection gisco_get_countries Copyright
#' @inheritSection gisco_get_countries Note
#' @source
#'
#' ```{r, echo=FALSE, results='asis'}
#'
#' cat(paste0("[CNTR_RG_20M_2024_4326.gpkg]",
#'       "(https://gisco-services.ec.europa.eu/distribution/v2/",
#'       "countries/gpkg/) file."))
#'
#' ```
#' @seealso [gisco_get_countries()]
#'
#' @encoding UTF-8
#'
#' @examples
#'
#' data("gisco_countries_2024")
#' head(gisco_countries_2024)
#'
NULL

#' Database with different country code schemes and world regions
#'
#' @description
#' A [tibble][tibble::tbl_df] containing conversions between country code
#' schemes (Eurostat, ISO 3166-1 alpha-2 and ISO 3166-1 alpha-3) and
#' geographic regions from the World Bank and the UN
#' ([M49 Standard](https://unstats.un.org/unsd/methodology/m49/)). This
#' database was extracted from the \CRANpkg{countrycode} package.
#'
#' @name gisco_countrycode
#' @docType data
#' @family datasets
#' @keywords datasets
#' @format
#' A data frame with
#' `r prettyNum(nrow(giscoR::gisco_countrycode), big.mark = ",")` rows and 13
#' variables:
#' \describe{
#'   \item{`ISO3_CODE`}{ISO 3166-1 alpha-3 code of each country.}
#'   \item{`CNTR_CODE`}{Eurostat country code.}
#'   \item{`iso2c`}{ISO 3166-1 alpha-2 code of each country.}
#'   \item{`iso.name.en`}{ISO English short name.}
#'   \item{`cldr.short.en`}{English short name as provided by the Unicode
#'     Common Locale Data Repository.}
#'   \item{`continent`}{Continent from the World Bank.}
#'   \item{`un.region.code`}{UN M49 numeric region code.}
#'   \item{`un.region.name`}{UN M49 region name.}
#'   \item{`un.regionintermediate.code`}{UN M49 numeric intermediate region
#'   code.}
#'   \item{`un.regionintermediate.name`}{UN M49 intermediate region name.}
#'   \item{`un.regionsub.code`}{UN M49 numeric subregion code.}
#'   \item{`un.regionsub.name`}{UN M49 subregion name.}
#'   \item{`eu`}{Logical value indicating whether the country belongs to the
#'     European Union.}
#' }
#'
#' @inheritSection gisco_get_countries World regions
#'
#' @source [countrycode::codelist] **v1.6.1**.
#'
#' @seealso
#' [gisco_get_countries()], [countrycode::codelist].
#'
#' See also
#' ```{r, echo=FALSE, results='asis'}
#' cat(paste0(" [Unicode Common Locale Data Repository]",
#'       "(https://cldr.unicode.org/translation/displaynames/",
#'       "countryregion-territory-names)."))
#'
#' ```
#'
#' @encoding UTF-8
#'
#' @examplesIf requireNamespace("dplyr", quietly = TRUE)
#' data("gisco_countrycode")
#' dplyr::glimpse(gisco_countrycode)
NULL

#' Coastal lines 2016 [`sf`][sf::st_sf] object
#'
#' @description
#' This object contains the coastal lines of the world.
#'
#' @name gisco_coastal_lines
#' @docType data
#' @family datasets
#' @keywords datasets
#' @format
#' An [`sf`][sf::st_sf] object with `POLYGON` geometries, resolution:
#' 1:20 million and [EPSG:4326](https://epsg.io/4326).
#'
#' @inheritSection gisco_get_coastal_lines Copyright
#' @inheritSection gisco_get_coastal_lines Note
#' @source
#'
#' ```{r, echo=FALSE, results='asis'}
#'
#' cat(paste0("[COAS_RG_20M_2016_4326.gpkg]",
#'       "(https://gisco-services.ec.europa.eu/distribution/v2/",
#'       "coas/gpkg/) file."))
#'
#' ```
#'
#' @seealso [gisco_get_coastal_lines()]
#'
#' @encoding UTF-8
#'
#' @examples
#' library(sf)
#' data("gisco_coastal_lines")
#' gisco_coastal_lines
#'
NULL

#' NUTS 2024 [`sf`][sf::st_sf] object
#'
#' @description
#' This dataset represents the regions for levels 0, 1, 2 and 3 of the
#' Nomenclature of Territorial Units for Statistics (NUTS) for 2024.
#'
#' @name gisco_nuts_2024
#' @docType data
#' @family datasets
#' @keywords datasets
#' @format
#' An [`sf`][sf::st_sf] object with `MULTIPOLYGON` geometries, resolution:
#' 1:20 million and [EPSG:4326](https://epsg.io/4326). It has
#' `r nrow(giscoR::gisco_nuts_2024)` rows and 19 variables:
#' \describe{
#'   \item{`NUTS_ID`}{NUTS identifier.}
#'   \item{`LEVL_CODE`}{NUTS level code `(0,1,2,3)`.}
#'   \item{`CNTR_CODE`}{Eurostat country code.}
#'   \item{`NAME_LATN`}{NUTS name in Latin characters.}
#'   \item{`NUTS_NAME`}{NUTS name in the local alphabet.}
#'   \item{`MOUNT_TYPE`}{Mountain type, see **Details**.}
#'   \item{`URBN_TYPE`}{Urban type, see **Details**.}
#'   \item{`COAST_TYPE`}{Coastal type, see **Details**.}
#'   \item{`NAME_ENGL`}{Country name in English.}
#'   \item{`NAME_FREN`}{Country name in French.}
#'   \item{`ISO3_CODE`}{ISO 3166-1 alpha-3 code of each country from
#'   GISCO.}
#'   \item{`SVRG_UN`}{Sovereign status according to the United Nations.}
#'   \item{`CAPT`}{Capital city.}
#'   \item{`EU_STAT`}{European Union member.}
#'   \item{`EFTA_STAT`}{EFTA member.}
#'   \item{`CC_STAT`}{EU candidate member.}
#'   \item{`NAME_GERM`}{Country name in German.}
#'   \item{`geo`}{Same value as `NUTS_ID`, provided for compatibility with
#'   \CRANpkg{eurostat}.}
#'   \item{`geometry`}{Geometry field.}
#' }
#'
#' @details
#'
#' `MOUNT_TYPE`: Mountain typology:
#' - `1`: More than 50% of the surface is covered by topographic mountain
#'   areas.
#' - `2`: More than 50% of the regional population lives in topographic
#'   mountain areas.
#' - `3`: More than 50% of the surface is covered by topographic mountain
#'   areas and more than 50% of the regional population lives in these
#'   mountain areas.
#' - `4`: Non-mountain region / other regions.
#' - `0`: No classification provided.
#'
#' `URBN_TYPE`: Urban-rural typology:
#' - `1`: Predominantly urban region.
#' - `2`: Intermediate region.
#' - `3`: Predominantly rural region.
#' - `0`: No classification provided.
#'
#' `COAST_TYPE`: Coastal typology:
#' - `1`: Coastal (on coast).
#' - `2`: Coastal (less than 50% of the population lives within 50 km of the
#'   coastline).
#' - `3`: Non-coastal region.
#' - `0`: No classification provided.
#'
#' @inheritSection gisco_get_nuts Copyright
#' @inheritSection gisco_get_nuts Note
#' @source
#'
#' ```{r, echo=FALSE, results='asis'}
#'
#' cat(paste0("[NUTS_RG_20M_2024_4326.gpkg]",
#'       "(https://gisco-services.ec.europa.eu/distribution/v2/",
#'       "nuts/gpkg/) file."))
#'
#' ```
#'
#' @seealso [gisco_get_nuts()]
#'
#' @encoding UTF-8
#'
#' @examples
#' data("gisco_nuts_2024")
#' head(gisco_nuts_2024)
#'
NULL