catr_get_code_from_coords: Get the cadastral municipality code from coordinates

In CatastRo: Interface to the API 'Sede Electronica Del Catastro'

Get the cadastral municipality code from coordinates

Description

Get the municipality code for coordinates using a sf object or a pair of coordinates via catr_ovc_get_cod_munic().

Usage

catr_get_code_from_coords(
  x,
  srs = NULL,
  verbose = FALSE,
  cache_dir = NULL,
  ...
)

Arguments

x	It may be: A pair of coordinates c(x,y). In this case the srs of the coordinates must be provided. A sf object. If the object has several geometries, only the first geometry is used. The function extracts coordinates using sf::st_centroid(x, of_largest_polygon = TRUE).
srs	SRS/CRS to use on the query. To see allowed values, use catr_srs_values, specifically the ovc_service column.
verbose	Logical. If TRUE, displays informational messages.
cache_dir	Path to a cache directory. On NULL, the function stores cached files in a temporary directory (see base::tempdir()).
...	Arguments passed on to mapSpain::esp_get_munic_siane year character string or number. Release year, it must be in formats YYYY (assuming end of year) or YYYY-MM-DD. Historical information starts as of 2005. resolution character string or number. Resolution of the geospatial data. One of: "10": 1:10 million. "6.5": 1:6.5 million. "3": 1:3 million. region Optional. A vector of region names, NUTS or ISO codes (see esp_dict_region_code()). munic character string. A name or regex expression with the names of the required municipalities. NULL will return all municipalities.

Details

On a successful query, the function returns a tibble with one row including the following columns:

• munic: Name of the municipality as per the Cadastre.

• catr_to: Cadastral territorial office code.

• catr_munic: Municipality code as recorded on the Cadastre.

• catrcode: Full Cadastral code for the municipality.

• cpro: Province code as per the INE.

• cmun: Municipality code as per the INE.

• inecode: Full INE code for the municipality.

• Rest of fields: Check the API Docs.

Value

A tibble. See Details

See Also

mapSpain::esp_get_munic_siane(), catr_ovc_get_cod_munic(), sf::st_centroid().

Other search: catr_atom_search_munic(), catr_ovc_get_cod_munic(), catr_ovc_get_cod_provinces()

Examples

# Use with coords
catr_get_code_from_coords(c(-16.25462, 28.46824), srs = 4326)

# Use with sf
prov <- mapSpain::esp_get_prov("Caceres")
catr_get_code_from_coords(prov)

CatastRo documentation built on April 27, 2026, 5:07 p.m.