catr_ovc_get_cpmrc: OVCCoordenadas: Geocode a cadastral reference

View source: R/ovc-cpmrc.R

catr_ovc_get_cpmrcR Documentation

OVCCoordenadas: Geocode a cadastral reference

Description

Query the OVCCoordenadas Consulta CPMRC service to retrieve coordinates for a parcel reference. The returned coordinates locate the parcel centroid.

Usage

catr_ovc_get_cpmrc(
  rc,
  srs = 4326,
  province = NULL,
  municipality = NULL,
  verbose = FALSE
)

Arguments

rc

A 14-character cadastral parcel reference to geocode.

srs

SRS/CRS to use in the query. To see allowed values, use catr_srs_values, specifically the ovc_service column.

province, municipality

Optional character strings used to narrow the search. province is required when municipality is provided.

verbose

Logical. Whether to display informational messages.

Details

If the API returns no results or reports an error, the result is a tibble containing only query information.

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

  • xcoord, ycoord: X and Y coordinates in the specified SRS.

  • refcat: Cadastral reference.

  • address: Address as recorded in the Spanish Cadastre.

  • Remaining fields: See the API documentation.

Value

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

References

Consulta CPMRC.

See Also

  • catr_srs_values lists supported SRS values.

  • vignette("ovcservice", package = "CatastRo") describes the OVC services.

Work with cadastral references: catr_ovc_get_rccoor(), catr_ovc_get_rccoor_distancia()

Query OVC web services: catr_ovc_get_cod_munic(), catr_ovc_get_cod_provinces(), catr_ovc_get_rccoor(), catr_ovc_get_rccoor_distancia()

Examples




# Using all arguments
catr_ovc_get_cpmrc("13077A01800039",
  4230,
  province = "CIUDAD REAL",
  municipality = "SANTA CRUZ DE MUDELA"
)

# Only the cadastral reference
catr_ovc_get_cpmrc("9872023VH5797S")



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