README.Rmd

---
output: github_document
---

<!-- README.md is generated from README.Rmd. Please edit that file -->

```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  message = FALSE,
  warning = FALSE,
  dev = "ragg_png",
  dpi = 300,
  tidy = "styler",
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = "100%"
)
library(CatastRoNav)
```

# CatastRoNav <img src="man/figures/logo.png" align="right" height="139"/>

<!-- badges: start -->

[![rOS-badge](https://ropenspain.github.io/rostemplate/reference/figures/ropenspain-badge.svg)](https://ropenspain.es/)
[![CatastRoNav status
badge](https://ropenspain.r-universe.dev/badges/CatastRoNav)](https://ropenspain.r-universe.dev/CatastRoNav)
[![R-CMD-check](https://github.com/rOpenSpain/CatastRoNav/actions/workflows/roscron-check-standard.yaml/badge.svg)](https://github.com/rOpenSpain/CatastRoNav/actions/workflows/roscron-check-standard.yaml)
[![codecov](https://codecov.io/gh/rOpenSpain/CatastroNav/branch/main/graph/badge.svg)](https://app.codecov.io/gh/rOpenSpain/CatastroNav)
[![DOI](https://img.shields.io/badge/DOI-10.5281/zenodo.6366407-blue)](https://doi.org/10.5281/zenodo.6366407)
[![Project-Status:Active](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)

<!-- badges: end -->

**CatastRoNav** is a package that provide access to different API services of
the [Cadastre of Navarre](https://geoportal.navarra.es/es/idena). With
**CatastRoNav** it is possible to download spatial objects as buildings or
cadastral parcels.

## Installation

You can install the developing version of **CatastRoNav** using the
[r-universe](https://ropenspain.r-universe.dev/CatastRoNav):

```{r, eval = FALSE}
# Install CatastRoNav in R:
install.packages("CatastRoNav",
  repos = c(
    "https://ropenspain.r-universe.dev",
    "https://cloud.r-project.org"
  )
)
```

Alternatively, you can install the developing version of **CatastRoNav** with:

```{r, eval = FALSE}
remotes::install_github("rOpenSpain/CatastRoNav", dependencies = TRUE)
```

## Usage

The WFS service allows to download vector objects of specific cadastral
elements. The result is provided as `sf` objects (See [**sf**
package](https://r-spatial.github.io/sf/)).

```{r wfs}
library(CatastRoNav)
library(ggplot2)

wfs_get_buildings <- catrnav_wfs_get_buildings_bbox(
  c(-1.652563, 42.478016, -1.646919, 42.483333),
  srs = 4326
)
# Map
ggplot(wfs_get_buildings) +
  geom_sf() +
  ggtitle("Olite, Navarra")
```

## Citation

```{r echo=FALSE, results='asis'}
print(citation("CatastRoNav"), style = "html")
```

A BibTeX entry for LaTeX users is:

```{r echo=FALSE, comment=''}
toBibtex(citation("CatastRoNav"))
```

## See also

The package [CatastRo](https://CRAN.R-project.org/package=CatastRo) provides
similar functionalities for Spain excluding the Basque Country and Navarre.

## Terms and conditions of use

Data provided by the Government of Navarre under [Creative Commons Attribution
(CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/). The service is
provided "as is", and without guarantee of any kind, implicit or explicit.

Data source: [SITNA -- Government of
Navarre](https://geoportal.navarra.es/es/inspire)