README.Rmd

---
output: github_document
---

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

```{r setup, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = "100%"
)
```
# georefar

[![lifecycle](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://www.tidyverse.org/lifecycle/#experimental)

georefar es un paquete de R que implementa un wrapper para la API [georef-ar](https://georef-ar-api.readthedocs.io/es/latest/).


La API del Servicio de Normalización de Datos Geográficos, permite normalizar y codificar los nombres de unidades territoriales de la Argentina (provincias, departamentos, municipios y localidades) y de sus calles, así como ubicar coordenadas dentro de ellas.

## Instalación

Se puede instalar la version en desarrollo del paquete desde github:

``` r
# install.packages("devtools")
devtools::install_github("pdelboca/georefar")
```

## Ejemplo de Usos

Para cargar la librería:
```{r}
library(georefar)
```

Para obtener un listado de provincias:
```{r}
get_provincias(orden = "id", max = 5)
```

Para obtener un listado de departamentos:
```{r}
get_departamentos(provincia = "Corrientes", orden = "id", max = 5)
```

Para obtener un listado de municipios:
```{r}
get_municipios(provincia = "Santa Fe", max = 5)
```

Para obtener un listado de localidades:
```{r}
get_localidades(provincia = "Chubut", max = 5)
```

Para obtener la ubicacion de un punto (reverse-geocoding):
```{r}
get_ubicacion(-31.6515236,-64.4358794)
```

Para obtener detalles de una calle:
```{r}
get_calles(max = 5)
```

Para normalizar una Direccion:
```{r}
normalizar_direccion("Colon 127")
```