catr_get_code_from_coords: Get a cadastral municipality code from coordinates

In CatastRo: Interface to the Spanish 'Catastro' Web Services

Get a cadastral municipality code from coordinates

Description

Retrieve the municipality code associated with an sf object or a coordinate pair.

Usage

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

Arguments

x	Coordinate input. It can be: A pair of coordinates c(x, y). In this case the srs of the coordinates must be provided. An sf object. If the object has several geometries, only the first geometry is used. This function extracts coordinates using sf::st_centroid(x, of_largest_polygon = TRUE).
srs	SRS/CRS to use in the query. To see allowed values, use catr_srs_values, specifically the ovc_service column.
verbose	Logical. Whether to display informational messages.
cache_dir	Path to a cache directory. If NULL or FALSE, 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 use format 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. Use NULL to return all municipalities.

Details

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

• munic: Municipality name used by the Spanish Cadastre.

• catr_to: Cadastral territorial office code.

• catr_munic: Municipality code as recorded by the Cadastre.

• catrcode: Full cadastral code for the municipality.

• cpro: Province code according to the INE.

• cmun: Municipality code according to the INE.

• inecode: Full INE code for the municipality.

• Remaining fields: See the API documentation.

Value

A tibble as described in Details. Returns NULL if the request fails.

See Also

• mapSpain::esp_get_munic_siane() retrieves municipality geometries.

• catr_ovc_get_cod_munic() retrieves municipality codes.

• sf::st_centroid() computes geometry centroids.

Search for cadastral identifiers: catr_atom_search_munic(), catr_ovc_get_cod_munic(), catr_ovc_get_cod_provinces()

Examples

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

# Use with an `sf` object.
prov <- mapSpain::esp_get_prov("Caceres")
catr_get_code_from_coords(prov)

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