Package 'CatastRo'

ATOM INSPIRE: download all addresses for a municipality

Description

Retrieve spatial data for all addresses in a municipality using the ATOM INSPIRE service. The result also contains corresponding street information in fields prefixed with ⁠tfname_*⁠.

Usage

catr_atom_get_address(
  munic,
  to = NULL,
  cache = deprecated(),
  update_cache = FALSE,
  cache_dir = NULL,
  verbose = FALSE
)

Arguments

munic	Municipality name, partial name or cadastral code. Use catr_atom_search_munic() to find cadastral codes.
to	Optional territorial office containing munic. Use this argument to narrow the search.
cache	This argument is no longer supported because results are always cached.
update_cache	Logical. Whether to refresh the cached file. Defaults to FALSE.
cache_dir	Path to a cache directory. If NULL or FALSE, the function stores cached files in a temporary directory. See base::tempdir().
verbose	Logical. If TRUE, displays informational messages.

Value

An sf object. Returns NULL if the data cannot be retrieved.

References

API documentation.

INSPIRE services for cadastral cartography.

See Also

Download data from ATOM INSPIRE services: catr_atom_get_address_db_all(), catr_atom_get_buildings(), catr_atom_get_buildings_db_all(), catr_atom_get_parcels(), catr_atom_get_parcels_db_all(), catr_atom_search_munic()

Work with cadastral addresses: catr_atom_get_address_db_all(), catr_wfs_get_address_bbox()

Examples

s <- catr_atom_get_address("Melque", to = "Segovia")

library(ggplot2)

ggplot(s) +
  geom_sf(aes(color = specification)) +
  coord_sf(
    xlim = c(376200, 376850),
    ylim = c(4545000, 4546000)
  ) +
  labs(
    title = "Addresses",
    subtitle = "Melque de Cercos, Segovia"
  )

---

ATOM INSPIRE: list address download URLs

Description

Create a table of URLs provided by the Spanish Cadastre ATOM INSPIRE service for downloading addresses.

catr_atom_get_address_db_all() provides a summary table with all territorial offices, except the Basque Country and Navarre and the municipalities included in each office. catr_atom_get_address_db_to() provides a table for one territorial office and its municipalities.

Usage

catr_atom_get_address_db_all(
  cache = deprecated(),
  update_cache = FALSE,
  cache_dir = NULL,
  verbose = FALSE
)

catr_atom_get_address_db_to(
  to,
  cache = deprecated(),
  update_cache = FALSE,
  cache_dir = NULL,
  verbose = FALSE
)

Arguments

cache	This argument is no longer supported because results are always cached.
update_cache	Logical. Whether to refresh the cached file. Defaults to FALSE.
cache_dir	Path to a cache directory. If NULL or FALSE, the function stores cached files in a temporary directory. See base::tempdir().
verbose	Logical. If TRUE, displays informational messages.
to	Character string. Territorial office to match using base::grep().

Value

A tibble with the requested information in the following columns:

• territorial_office: Territorial office, corresponding to each province of Spain except the Basque Country and Navarre.

• url: ATOM URL for the corresponding territorial office.

• munic: Name of the municipality.

• date: Reference date of the data. The information from this service is updated twice a year.

Source

https://www.catastro.hacienda.gob.es/INSPIRE/Addresses/ES.SDGC.AD.atom.xml

See Also

Download data from ATOM INSPIRE services: catr_atom_get_address(), catr_atom_get_buildings(), catr_atom_get_buildings_db_all(), catr_atom_get_parcels(), catr_atom_get_parcels_db_all(), catr_atom_search_munic()

Work with cadastral addresses: catr_atom_get_address(), catr_wfs_get_address_bbox()

Examples

catr_atom_get_address_db_all()

---

ATOM INSPIRE: download all buildings for a municipality

Description

Retrieve spatial data for all buildings in a municipality using the ATOM INSPIRE service.

Usage

catr_atom_get_buildings(
  munic,
  to = NULL,
  what = c("building", "buildingpart", "other"),
  cache = deprecated(),
  update_cache = FALSE,
  cache_dir = NULL,
  verbose = FALSE
)

Arguments

munic	Municipality name, partial name or cadastral code. Use catr_atom_search_munic() to find cadastral codes.
to	Optional territorial office containing munic. Use this argument to narrow the search.
what	Information to load. Options are: "building" for buildings. "buildingpart" for parts of a building. "other" for other elements such as swimming pools.
cache	This argument is no longer supported because results are always cached.
update_cache	Logical. Whether to refresh the cached file. Defaults to FALSE.
cache_dir	Path to a cache directory. If NULL or FALSE, the function stores cached files in a temporary directory. See base::tempdir().
verbose	Logical. If TRUE, displays informational messages.

Value

An sf object. Returns NULL if the data cannot be retrieved.

References

API documentation.

INSPIRE services for cadastral cartography.

See Also

Download data from ATOM INSPIRE services: catr_atom_get_address(), catr_atom_get_address_db_all(), catr_atom_get_buildings_db_all(), catr_atom_get_parcels(), catr_atom_get_parcels_db_all(), catr_atom_search_munic()

Work with cadastral buildings: catr_atom_get_buildings_db_all(), catr_wfs_get_buildings_bbox()

Examples

s <- catr_atom_get_buildings("Nava de la Asuncion", to = "Segovia")

library(ggplot2)
ggplot(s) +
  geom_sf() +
  coord_sf(
    xlim = c(374500, 375500),
    ylim = c(4556500, 4557500)
  ) +
  labs(
    title = "Buildings",
    subtitle = "Nava de la Asuncion, Segovia"
  )

---

ATOM INSPIRE: list building download URLs

Description

Create a table of URLs provided by the Spanish Cadastre ATOM INSPIRE service for downloading buildings.

catr_atom_get_buildings_db_all() provides a summary table with all territorial offices, except the Basque Country and Navarre and the municipalities included in each office. catr_atom_get_buildings_db_to() provides a table for one territorial office and its municipalities.

Usage

catr_atom_get_buildings_db_all(
  cache = deprecated(),
  update_cache = FALSE,
  cache_dir = NULL,
  verbose = FALSE
)

catr_atom_get_buildings_db_to(
  to,
  cache = deprecated(),
  update_cache = FALSE,
  cache_dir = NULL,
  verbose = FALSE
)

Arguments

cache	This argument is no longer supported because results are always cached.
update_cache	Logical. Whether to refresh the cached file. Defaults to FALSE.
cache_dir	Path to a cache directory. If NULL or FALSE, the function stores cached files in a temporary directory. See base::tempdir().
verbose	Logical. If TRUE, displays informational messages.
to	Character string. Territorial office to match using base::grep().

Value

A tibble with the requested information in the following columns:

• territorial_office: Territorial office, corresponding to each province of Spain except the Basque Country and Navarre.

• url: ATOM URL for the corresponding territorial office.

• munic: Name of the municipality.

• date: Reference date of the data. The information from this service is updated twice a year.

Source

https://www.catastro.hacienda.gob.es/INSPIRE/buildings/ES.SDGC.BU.atom.xml

See Also

Download data from ATOM INSPIRE services: catr_atom_get_address(), catr_atom_get_address_db_all(), catr_atom_get_buildings(), catr_atom_get_parcels(), catr_atom_get_parcels_db_all(), catr_atom_search_munic()

Work with cadastral buildings: catr_atom_get_buildings(), catr_wfs_get_buildings_bbox()

Examples

catr_atom_get_buildings_db_all()

---

ATOM INSPIRE: download all cadastral parcels for a municipality

Description

Retrieve spatial data for all cadastral parcels in a municipality using the ATOM INSPIRE service.

Usage

catr_atom_get_parcels(
  munic,
  to = NULL,
  what = c("parcel", "zoning"),
  cache = deprecated(),
  update_cache = FALSE,
  cache_dir = NULL,
  verbose = FALSE
)

Arguments

munic	Municipality name, partial name or cadastral code. Use catr_atom_search_munic() to find cadastral codes.
to	Optional territorial office containing munic. Use this argument to narrow the search.
what	Information to load. Options are: "parcel" for cadastral parcels. "zoning" for cadastral zoning.
cache	This argument is no longer supported because results are always cached.
update_cache	Logical. Whether to refresh the cached file. Defaults to FALSE.
cache_dir	Path to a cache directory. If NULL or FALSE, the function stores cached files in a temporary directory. See base::tempdir().
verbose	Logical. If TRUE, displays informational messages.

Value

An sf object. Returns NULL if the data cannot be retrieved.

References

API documentation.

INSPIRE services for cadastral cartography.

See Also

Download data from ATOM INSPIRE services: catr_atom_get_address(), catr_atom_get_address_db_all(), catr_atom_get_buildings(), catr_atom_get_buildings_db_all(), catr_atom_get_parcels_db_all(), catr_atom_search_munic()

Work with cadastral parcels: catr_atom_get_parcels_db_all(), catr_wfs_get_parcels_bbox()

Examples

s <- catr_atom_get_parcels("Melque", to = "Segovia", what = "parcel")

library(ggplot2)

ggplot(s) +
  geom_sf() +
  labs(
    title = "Cadastral parcels",
    subtitle = "Melque de Cercos, Segovia"
  )

---

ATOM INSPIRE: list cadastral parcel download URLs

Description

Create a table of URLs provided by the Spanish Cadastre ATOM INSPIRE service for downloading cadastral parcels.

catr_atom_get_parcels_db_all() provides a summary table with all territorial offices, except the Basque Country and Navarre and the municipalities included in each office. catr_atom_get_parcels_db_to() provides a table for one territorial office and its municipalities.

Usage

catr_atom_get_parcels_db_all(
  cache = deprecated(),
  update_cache = FALSE,
  cache_dir = NULL,
  verbose = FALSE
)

catr_atom_get_parcels_db_to(
  to,
  cache = deprecated(),
  update_cache = FALSE,
  cache_dir = NULL,
  verbose = FALSE
)

Arguments

cache	This argument is no longer supported because results are always cached.
update_cache	Logical. Whether to refresh the cached file. Defaults to FALSE.
cache_dir	Path to a cache directory. If NULL or FALSE, the function stores cached files in a temporary directory. See base::tempdir().
verbose	Logical. If TRUE, displays informational messages.
to	Character string. Territorial office to match using base::grep().

Value

A tibble with the requested information in the following columns:

• territorial_office: Territorial office, corresponding to each province of Spain except the Basque Country and Navarre.

• url: ATOM URL for the corresponding territorial office.

• munic: Name of the municipality.

• date: Reference date of the data. The information from this service is updated twice a year.

Source

https://www.catastro.hacienda.gob.es/INSPIRE/CadastralParcels/ES.SDGC.CP.atom.xml

See Also

Download data from ATOM INSPIRE services: catr_atom_get_address(), catr_atom_get_address_db_all(), catr_atom_get_buildings(), catr_atom_get_buildings_db_all(), catr_atom_get_parcels(), catr_atom_search_munic()

Work with cadastral parcels: catr_atom_get_parcels(), catr_wfs_get_parcels_bbox()

Examples

catr_atom_get_parcels_db_all()

---

ATOM INSPIRE: search for municipality codes

Description

Search for a municipality by name or code and return matching Spanish Cadastre municipality codes.

Usage

catr_atom_search_munic(
  munic,
  to = NULL,
  cache = deprecated(),
  update_cache = FALSE,
  cache_dir = NULL,
  verbose = FALSE
)

Arguments

munic	Municipality name, partial name or cadastral code. Use catr_atom_search_munic() to find cadastral codes.
to	Optional territorial office containing munic. Use this argument to narrow the search.
cache	This argument is no longer supported because results are always cached.
update_cache	Logical. Whether to refresh the cached file. Defaults to FALSE.
cache_dir	Path to a cache directory. If NULL or FALSE, the function stores cached files in a temporary directory. See base::tempdir().
verbose	Logical. If TRUE, displays informational messages.

Value

A tibble with the territorial office, municipality name and cadastral code. Returns NULL if no match is found.

See Also

Download data from ATOM INSPIRE services: catr_atom_get_address(), catr_atom_get_address_db_all(), catr_atom_get_buildings(), catr_atom_get_buildings_db_all(), catr_atom_get_parcels(), catr_atom_get_parcels_db_all()

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

Examples

catr_atom_search_munic("Mad")

---

Clear your CatastRo cache directory

Description

Use this function with caution. Depending on its arguments, this function:

• Deletes the CatastRo configuration directory when config = TRUE (tools::R_user_dir("CatastRo", "config")).

• Deletes the cache_dir directory and its contents when cached_data = TRUE.

• Always clears the CATASTROESP_CACHE_DIR environment variable.

Usage

catr_clear_cache(config = FALSE, cached_data = TRUE, verbose = FALSE)

Arguments

config	If TRUE, deletes the configuration directory of CatastRo.
cached_data	If TRUE, deletes your cache_dir and all its contents.
verbose	Logical. If TRUE, displays informational messages.

Details

With config = TRUE and cached_data = TRUE, this function resets the cache state as if you had never used CatastRo.

Value

Invisibly returns NULL. This function is called for its side effects.

See Also

tools::R_user_dir() defines platform-specific user directories.

Manage the local cache: catr_set_cache_dir()

Examples

# Don't run this! It modifies your current state
## Not run: 
my_cache <- catr_detect_cache_dir()

# Set an example cache
ex <- file.path(tempdir(), "example", "cache")
catr_set_cache_dir(ex, verbose = FALSE)

# Restore initial cache
catr_clear_cache(verbose = TRUE)

catr_set_cache_dir(my_cache)
identical(my_cache, catr_detect_cache_dir())

## End(Not run)

---

Get the 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. A 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. If TRUE, displays 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 tibble with one row including 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)

---

OVCCallejero: get municipality codes

Description

Query the OVCCallejero ConsultaMunicipioCodigos service to retrieve municipality names and codes from the Spanish Cadastre and the National Statistics Institute (INE).

Usage

catr_ovc_get_cod_munic(cpro, cmun = NULL, cmun_ine = NULL, verbose = FALSE)

Arguments

cpro	Province code returned by catr_ovc_get_cod_provinces().
cmun, cmun_ine	Municipality code as recorded by the Spanish Cadastre (cmun) or the National Statistics Institute. Either cmun or cmun_ine must be provided.
verbose	Logical. If TRUE, displays informational messages.

Details

On a successful query, this function returns a tibble with one row including 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.

References

ConsultaMunicipioCodigos.

See Also

mapSpain::esp_get_munic_siane() to get shapes of municipalities, including the INE code.

Query OVC province and municipality codes: catr_ovc_get_cod_provinces()

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

Examples

# Get municipality by cadastral code
ab <- catr_ovc_get_cod_munic(cpro = 2, cmun = 900)

ab

# Same query using the INE code

ab2 <- catr_ovc_get_cod_munic(cpro = 2, cmun_ine = 3)

ab2

---

OVCCallejero: get province codes

Description

Query the OVCCallejero ConsultaProvincia service to retrieve provinces and their Spanish Cadastre codes.

Usage

catr_ovc_get_cod_provinces(verbose = FALSE)

Arguments

verbose

Logical. If TRUE, displays informational messages.

Value

A tibble with province names and codes. Returns NULL if the request fails.

References

ConsultaProvincia.

See Also

Query OVC province and municipality codes: catr_ovc_get_cod_munic()

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

Examples

catr_ovc_get_cod_provinces()

---

OVCCoordenadas: geocode a cadastral reference

Description

Query the OVCCoordenadas Consulta CPMRC service to retrieve coordinates for a cadastral reference.

Usage

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

Arguments

rc	The cadastral reference to be geocoded.
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.
verbose	Logical. If TRUE, displays informational messages.

Details

If the API returns no results, this function returns 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.

Convert coordinates and cadastral references: catr_ovc_get_rccoor(), catr_ovc_get_rccoor_distancia()

Work with cadastral references: 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")

---

OVCCoordenadas: reverse geocode coordinates

Description

Query the OVCCoordenadas Consulta RCCOOR service to retrieve the cadastral reference associated with a pair of coordinates.

Usage

catr_ovc_get_rccoor(lat, lon, srs = 4326, verbose = FALSE)

Arguments

lat	Latitude for the query, expressed in the SRS/CRS defined by srs.
lon	Longitude for the query, expressed in the SRS/CRS defined by srs.
srs	SRS/CRS to use in the query. To see allowed values, use catr_srs_values, specifically the ovc_service column.
verbose	Logical. If TRUE, displays informational messages.

Details

If the API returns no results, this function returns 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:

• geo.xcen, geo.ycen, geo.srs: Input arguments of the query.

• 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 RCCOOR.

See Also

Convert coordinates and cadastral references: catr_ovc_get_cpmrc(), catr_ovc_get_rccoor_distancia()

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

Examples

catr_ovc_get_rccoor(
  lat = 38.6196566583596,
  lon = -3.45624183836806,
  srs = 4326
)

---

OVCCoordenadas: find cadastral references near coordinates

Description

Query the OVCCoordenadas Consulta RCCOOR Distancia service to retrieve cadastral references near a pair of coordinates. If no exact match is found, the API searches within 50 square meters of the requested coordinates.

Usage

catr_ovc_get_rccoor_distancia(lat, lon, srs = 4326, verbose = FALSE)

Arguments

lat	Latitude for the query, expressed in the SRS/CRS defined by srs.
lon	Longitude for the query, expressed in the SRS/CRS defined by srs.
srs	SRS/CRS to use in the query. To see allowed values, use catr_srs_values, specifically the ovc_service column.
verbose	Logical. If TRUE, displays informational messages.

Details

If the API returns no results, this function returns 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:

• geo.xcen, geo.ycen, geo.srs: Input arguments of the query.

• refcat: Cadastral reference.

• address: Address as recorded in the Spanish Cadastre.

• cmun_ine: Municipality code as registered on the INE (National Statistics Institute).

• Remaining fields: See the API documentation.

Value

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

References

Consulta RCCOOR Distancia.

See Also

Convert coordinates and cadastral references: catr_ovc_get_cpmrc(), catr_ovc_get_rccoor()

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

Examples

catr_ovc_get_rccoor_distancia(
  lat = 40.963200,
  lon = -5.671420,
  srs = 4326
)

---

Set your CatastRo cache directory

Description

Configure the cache directory used by CatastRo. Use Sys.getenv("CATASTROESP_CACHE_DIR") or catr_detect_cache_dir() to inspect the current path.

Usage

catr_set_cache_dir(
  cache_dir = NULL,
  overwrite = FALSE,
  install = FALSE,
  verbose = TRUE
)

catr_detect_cache_dir()

Arguments

cache_dir	Path to a cache directory. If NULL or FALSE, the function stores cached files in a temporary directory. See base::tempdir().
overwrite	Logical. If TRUE, overwrites an existing CATASTROESP_CACHE_DIR value already present on your machine.
install	Logical. If TRUE, stores the path locally for use in future sessions. Defaults to FALSE.
verbose	Logical. If TRUE, displays informational messages.

Details

By default, when no cache_dir is set, CatastRo uses a directory inside base::tempdir() (so files are temporary and are removed when the R session ends). To persist a cache across R sessions, use catr_set_cache_dir(cache_dir, install = TRUE) which writes the chosen path to a small configuration file under tools::R_user_dir("CatastRo", "config").

Value

catr_set_cache_dir() invisibly returns a character string containing the cache path. It is primarily called for its side effect.

catr_detect_cache_dir() returns the path to the cache_dir used in this session.

Caching strategies

Source files are cached after download. CatastRo implements the following caching options:

• For occasional use, rely on the default tempdir()-based cache (no install).

• Modify the cache for a single session by setting catr_set_cache_dir(cache_dir = "a/path/here").

• For reproducible workflows, install a persistent cache with catr_set_cache_dir(cache_dir = "a/path/here", install = TRUE). This cache is kept across R sessions.

• For caching specific files, use the cache_dir argument in the corresponding function.

Cached files can occasionally become corrupt. In that case, try downloading the data by setting update_cache = TRUE in the corresponding function.

If a download fails, try another download method and save the file in cache_dir. Use verbose = TRUE to inspect the API query and catr_detect_cache_dir() to identify your cache path.

Note

In CatastRo >= 1.0.0 the location of the configuration file has moved from rappdirs::user_config_dir("CatastRo", "R") to tools::R_user_dir("CatastRo", "config"). We have implemented a function that migrates previous configuration files from one location to another with a message. This message appears only once to inform you of the migration.

See Also

tools::R_user_dir() defines platform-specific user directories.

Manage the local cache: catr_clear_cache()

Examples

# Caution! This modifies your current state
## Not run: 
my_cache <- catr_detect_cache_dir()

# Set an example cache
ex <- file.path(tempdir(), "example", "cachenew")
catr_set_cache_dir(ex)

catr_detect_cache_dir()

# Restore initial cache
catr_set_cache_dir(my_cache)
identical(my_cache, catr_detect_cache_dir())

## End(Not run)


catr_detect_cache_dir()

---

Reference SRS codes for CatastRo services

Description

A tibble containing valid SRS values, also known as CRS values, for each API service. Values are represented as EPSG codes.

Format

A tibble with 16 rows and columns:

SRS

Spatial reference system (SRS) value, also known as a coordinate reference system (CRS), identified by the corresponding EPSG code.

Description

Description of the SRS/EPSG code.

ovc_service

Logical. Whether this code is valid for OVC services.

wfs_service

Logical. Whether this code is valid for WFS INSPIRE services.

Details

Table: Content of catr_srs_values

SRS	Description	ovc_service	wfs_service
3785	⁠Web Mercator⁠	FALSE	TRUE
3857	⁠Web Mercator⁠	FALSE	TRUE
4230	⁠Geográficas en ED 50⁠	TRUE	FALSE
4258	⁠Geográficas en ETRS89⁠	TRUE	TRUE
4326	⁠Geográficas en WGS 80⁠	TRUE	TRUE
23029	⁠UTM huso 29N en ED50⁠	TRUE	FALSE
23030	⁠UTM huso 30N en ED50⁠	TRUE	FALSE
23031	⁠UTM huso 31N en ED50⁠	TRUE	FALSE
25829	⁠UTM huso 29N en ETRS89⁠	TRUE	TRUE
25830	⁠UTM huso 30N en ETRS89⁠	TRUE	TRUE
25831	⁠UTM huso 31N en ETRS89⁠	TRUE	TRUE
32627	⁠UTM huso 27N en WGS 84⁠	TRUE	FALSE
32628	⁠UTM huso 28N en WGS 84⁠	TRUE	FALSE
32629	⁠UTM huso 29N en WGS 84⁠	TRUE	FALSE
32630	⁠UTM huso 30N en WGS 84⁠	TRUE	FALSE
32631	⁠UTM huso 31N en WGS 84⁠	TRUE	FALSE

References

• OVCCoordenadas.

• WFS INSPIRE service.

See Also

sf::st_crs().

Examples

data("catr_srs_values")

# OVC valid codes
library(dplyr)

catr_srs_values |> filter(ovc_service)

# WFS valid codes

catr_srs_values |> filter(wfs_service)

# Use with sf::st_crs()

catr_srs_values |>
  filter(wfs_service & ovc_service) |>
  print() |>
  # Select the first value.
  slice_head(n = 1) |>
  pull(SRS) |>
  # Convert to a CRS.
  sf::st_crs(.)

---

WFS INSPIRE: download addresses

Description

Retrieve spatial address data through several types of WFS queries:

• By bounding box: catr_wfs_get_address_bbox() retrieves objects included in the provided bounding box. See Bounding box.

• By street code: catr_wfs_get_address_codvia() retrieves objects for specific addresses.

• By cadastral reference: catr_wfs_get_address_rc() retrieves objects for specific cadastral references.

• By postal codes: catr_wfs_get_address_postalcode() retrieves objects for specific postal codes.

Usage

catr_wfs_get_address_bbox(x, srs = NULL, verbose = FALSE)

catr_wfs_get_address_codvia(codvia, del, mun, srs = NULL, verbose = FALSE)

catr_wfs_get_address_rc(rc, srs = NULL, verbose = FALSE)

catr_wfs_get_address_postalcode(postalcode, srs = NULL, verbose = FALSE)

Arguments

x	Input defining the query area. See Bounding box. It can be: A numeric vector of length 4 with the coordinates that define the bounding box: c(xmin, ymin, xmax, ymax). An sf or sfc object from sf.
srs	SRS/CRS to use in the query. To see allowed values, use catr_srs_values, specifically the wfs_service column. See Bounding box.
verbose	Logical. If TRUE, displays informational messages.
codvia	Cadastral street code.
del	Cadastral office code.
mun	Cadastral municipality code.
rc	Cadastral reference to retrieve.
postalcode	Postal code.

Value

An sf object. Returns NULL if the data cannot be retrieved.

API limits

The API service is limited to a bounding box of 4 km2 and a maximum of 5,000 elements.

Bounding box

When x is a numeric vector, make sure that the srs matches the coordinate values. Additionally, the function queries the bounding box on EPSG:25830, ETRS89 / UTM zone 30N, to work around a potential API issue.

When x is a sf object, the value srs is ignored. In this case, the bounding box of the sf object is used for the query (see sf::st_bbox()).

The result is always provided in the SRS of the sf object provided as input.

References

API documentation.

INSPIRE services for cadastral cartography.

See Also

Query data from WFS INSPIRE services: catr_wfs_get_buildings_bbox(), catr_wfs_get_parcels_bbox(), inspire_wfs_get()

Work with cadastral addresses: catr_atom_get_address(), catr_atom_get_address_db_all()

Examples

ad <- catr_wfs_get_address_bbox(
  c(
    233673, 4015968, 233761, 4016008
  ),
  srs = 25830
)

library(ggplot2)

ggplot(ad) +
  geom_sf()

---

WFS INSPIRE: download buildings

Description

Retrieve spatial building data through two types of WFS queries:

• By bounding box: catr_wfs_get_buildings_bbox() retrieves objects included in the provided bounding box. See Bounding box.

• By cadastral reference: catr_wfs_get_buildings_rc() retrieves objects for specific cadastral references.

Usage

catr_wfs_get_buildings_bbox(
  x,
  what = c("building", "buildingpart", "other"),
  srs = NULL,
  verbose = FALSE
)

catr_wfs_get_buildings_rc(
  rc,
  what = c("building", "buildingpart", "other"),
  srs = NULL,
  verbose = FALSE
)

Arguments

x	Input defining the query area. See Bounding box. It can be: A numeric vector of length 4 with the coordinates that define the bounding box: c(xmin, ymin, xmax, ymax). An sf or sfc object from sf.
what	Information to load. Options are: "building" for buildings. "buildingpart" for parts of a building. "other" for other elements such as swimming pools.
srs	SRS/CRS to use in the query. To see allowed values, use catr_srs_values, specifically the wfs_service column. See Bounding box.
verbose	Logical. If TRUE, displays informational messages.
rc	Cadastral reference to retrieve.

Value

An sf object. Returns NULL if the data cannot be retrieved.

API limits

The API service is limited to a bounding box of 4 km2 and a maximum of 5,000 elements.

Bounding box

When x is a numeric vector, make sure that the srs matches the coordinate values. Additionally, the function queries the bounding box on EPSG:25830, ETRS89 / UTM zone 30N, to work around a potential API issue.

When x is a sf object, the value srs is ignored. In this case, the bounding box of the sf object is used for the query (see sf::st_bbox()).

The result is always provided in the SRS of the sf object provided as input.

References

API documentation.

INSPIRE services for cadastral cartography.

See Also

Query data from WFS INSPIRE services: catr_wfs_get_address_bbox(), catr_wfs_get_parcels_bbox(), inspire_wfs_get()

Work with cadastral buildings: catr_atom_get_buildings(), catr_atom_get_buildings_db_all()

Examples

# Using a bounding box
building <- catr_wfs_get_buildings_bbox(
  c(
    376550,
    4545424,
    376600,
    4545474
  ),
  srs = 25830
)
library(ggplot2)
ggplot(building) +
  geom_sf() +
  labs(title = "Search using a bounding box")

# Using a cadastral reference
rc <- catr_wfs_get_buildings_rc("6656601UL7465N")
library(ggplot2)
ggplot(rc) +
  geom_sf() +
  labs(title = "Search using rc")

---

WFS INSPIRE: download cadastral parcels

Description

Retrieve spatial cadastral parcel and zoning data through several types of WFS queries:

• By bounding box: catr_wfs_get_parcels_bbox() retrieves objects included in the provided bounding box. See Bounding box.

• By zoning: catr_wfs_get_parcels_zoning() retrieves objects for a specific cadastral zone.

• By cadastral parcel: catr_wfs_get_parcels_parcel() retrieves cadastral parcels for a specific cadastral reference.

• Neighbor cadastral parcels: catr_wfs_get_parcels_neigh_parcel() retrieves neighboring cadastral parcels for a specific cadastral reference.

• Cadastral parcels by zoning: catr_wfs_get_parcels_parcel_zoning() retrieves cadastral parcels for a specific cadastral zone.

Usage

catr_wfs_get_parcels_bbox(
  x,
  what = c("parcel", "zoning"),
  srs = NULL,
  verbose = FALSE
)

catr_wfs_get_parcels_zoning(cod_zona, srs = NULL, verbose = FALSE)

catr_wfs_get_parcels_parcel(rc, srs = NULL, verbose = FALSE)

catr_wfs_get_parcels_neigh_parcel(rc, srs = NULL, verbose = FALSE)

catr_wfs_get_parcels_parcel_zoning(cod_zona, srs = NULL, verbose = FALSE)

Arguments

x	Input defining the query area. See Bounding box. It can be: A numeric vector of length 4 with the coordinates that define the bounding box: c(xmin, ymin, xmax, ymax). An sf or sfc object from sf.
what	Information to load. Options are: "parcel" for cadastral parcels. "zoning" for cadastral zoning.
srs	SRS/CRS to use in the query. To see allowed values, use catr_srs_values, specifically the wfs_service column. See Bounding box.
verbose	Logical. If TRUE, displays informational messages.
cod_zona	Cadastral zone code.
rc	Cadastral reference to retrieve.

Value

An sf object. Returns NULL if the data cannot be retrieved.

API limits

The API service is limited to the following constraints:

• "parcel": Bounding box of 1 km2 and a maximum of 5,000 elements.

• "zoning": Bounding box of 25 km2 and a maximum of 5,000 elements.

Bounding box

When x is a numeric vector, make sure that the srs matches the coordinate values. Additionally, the function queries the bounding box on EPSG:25830, ETRS89 / UTM zone 30N, to work around a potential API issue.

When x is a sf object, the value srs is ignored. In this case, the bounding box of the sf object is used for the query (see sf::st_bbox()).

The result is always provided in the SRS of the sf object provided as input.

References

API documentation.

INSPIRE services for cadastral cartography.

See Also

Query data from WFS INSPIRE services: catr_wfs_get_address_bbox(), catr_wfs_get_buildings_bbox(), inspire_wfs_get()

Work with cadastral parcels: catr_atom_get_parcels(), catr_atom_get_parcels_db_all()

Examples

cp <- catr_wfs_get_parcels_bbox(
  c(
    233673, 4015968, 233761, 4016008
  ),
  srs = 25830
)

library(ggplot2)

ggplot(cp) +
  geom_sf()

---

WMS INSPIRE: download georeferenced map images

Description

Retrieve georeferenced map images from the Spanish Cadastre WMS service. This function wraps mapSpain::esp_get_tiles().

Usage

catr_wms_get_layer(
  x,
  srs = NULL,
  what = c("building", "buildingpart", "parcel", "zoning", "address", "admboundary",
    "admunit"),
  styles = "default",
  update_cache = FALSE,
  cache_dir = NULL,
  verbose = FALSE,
  crop = FALSE,
  options = NULL,
  ...
)

Arguments

x	Input defining the query area. See Bounding box. It can be: A numeric vector of length 4 with the coordinates that define the bounding box: c(xmin, ymin, xmax, ymax). An sf or sfc object from sf.
srs	SRS/CRS to use in the query. To see allowed values, use catr_srs_values, specifically the wfs_service column. See Bounding box.
what	WMS layer to download. See Layers and styles.
styles	Style to apply to the selected WMS layer. See Layers and styles.
update_cache	Logical. Whether to refresh the cached file. Defaults to FALSE.
cache_dir	Path to a cache directory. If NULL or FALSE, the function stores cached files in a temporary directory. See base::tempdir().
verbose	Logical. If TRUE, displays informational messages.
crop	Logical. If TRUE, crop results to the specified x extent. If x is an sf object with one POINT, crop is set to FALSE. See terra::crop().
options	A named list containing additional options to pass to the query.
...	Arguments passed on to mapSpain::esp_get_tiles res Character string or number. Only valid for WMS providers. Resolution (in pixels) of the final tile. bbox_expand Number. Expansion percentage of the bounding box of x. transparent Logical. Whether to use a transparent background, if supported. mask Logical. TRUE to mask the result to x. See terra::mask().

Value

A SpatRaster with three RGB or four RGBA layers. See terra::RGB().

Bounding box

When x is a numeric vector, make sure that the srs matches the coordinate values. When x is a sf object, the value srs is ignored.

The query uses EPSG:3857 (Web Mercator), then transforms the tile back to the SRS of x. If the tile appears distorted, provide a spatial object as x or set srs to the SRS of the requested tile. See Examples.

Layers and styles

Layers

The what argument selects one of the following API layers:

• "parcel": CP.CadastralParcel.

• "zoning": CP.CadastralZoning.

• "building": BU.Building.

• "buildingpart": BU.BuildingPart.

• "address": AD.Address.

• "admboundary": AU.AdministrativeBoundary.

• "admunit": AU.AdministrativeUnit.

Styles

The WMS service provides different styles for each layer (what argument). Available styles include:

• "parcel": "BoundariesOnly", "ReferencePointOnly" and "ELFCadastre".

• "zoning": "BoundariesOnly" and "ELFCadastre".

• "building" and "buildingpart": "ELFCadastre".

• "address": "Number.ELFCadastre".

• "admboundary" and "admunit": "ELFCadastre".

See the API documentation for complete layer and style information.

See Also

• mapSpain::esp_get_tiles() downloads map tiles.

• terra::RGB() identifies RGB channels.

• terra::plotRGB() and tidyterra::geom_spatraster_rgb() plot RGB rasters.

Examples

# With a bounding box

pict <- catr_wms_get_layer(
  c(222500, 4019500, 223700, 4020700),
  srs = 25830,
  what = "parcel"
)

library(mapSpain)
library(ggplot2)
library(tidyterra)

ggplot() +
  geom_spatraster_rgb(data = pict)

# With a spatial object

parcels <- catr_wfs_get_parcels_neigh_parcel("3662303TF3136B", srs = 25830)

# Use styles

parcels_img <- catr_wms_get_layer(parcels,
  what = "buildingpart",
  srs = 25830, # Same as the parcels object
  bbox_expand = 0.3,
  styles = "ELFCadastre"
)

ggplot() +
  geom_sf(data = parcels, fill = "blue", alpha = 0.5) +
  geom_spatraster_rgb(data = parcels_img)

---

Query WFS INSPIRE services

Description

Build and run a WFS INSPIRE request. This function supports the package's WFS functions and is also available for querying other cadastral or INSPIRE resources.

Usage

inspire_wfs_get(
  scheme = "https",
  hostname = "ovc.catastro.meh.es",
  path = "INSPIRE/wfsCP.aspx",
  query = list(),
  verbose = FALSE
)

Arguments

scheme	Character string specifying the protocol used to access the resource.
hostname	Character string specifying the resource host.
path	Character string specifying the resource path on the host.
query	Named list of query parameters and their values.
verbose	Logical. If TRUE, displays informational messages.

Details

The function constructs a request URL from its components, downloads the result to a temporary cache and reports WFS exceptions. See Examples.

Value

A character string containing the downloaded file path. Returns NULL if the request fails.

See Also

Query data from WFS INSPIRE services: catr_wfs_get_address_bbox(), catr_wfs_get_buildings_bbox(), catr_wfs_get_parcels_bbox()

Examples

# Access the Cadastre of Navarra
# Try also https://ropenspain.github.io/CatastRoNav/

file_local <- inspire_wfs_get(
  hostname = "inspire.navarra.es",
  path = "services/BU/wfs",
  query = list(
    service = "WFS",
    request = "getfeature",
    typenames = "BU:Building",
    bbox = "609800,4740100,611000,4741300",
    SRSNAME = "EPSG:25830"
  )
)

if (!is.null(file_local)) {
  pamp <- sf::read_sf(file_local)

  library(ggplot2)
  ggplot(pamp) +
    geom_sf()
}

---