geoar

🌎 🇦🇷 spatial toolbox for R

https://github.com/politicaargentina/geoar

Keywords

Repository

🌎 🇦🇷 spatial toolbox for R

README.Rmd

---
output: github_document
---

## `geo`grafía `Ar`rgentina usando `R` 



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



`r badger::badge_cran_release(pkg = "geoAr", color = "blue")`
`r badger::badge_cran_download(pkg = "geoAr", color = "blue", type = "last-month")``r badger::badge_cran_download(pkg = "geoAr", color = "blue", type = "last-week")``r badger::badge_cran_download(pkg = "geoAr", color = "blue", type = "last-month")``r badger::badge_cran_download(pkg = "geoAr", color = "blue", type = "grand-total")`
`r badger::badge_github_actions()`



`{geoAr}` brinda herramientas que facilitan el acceso y el trabajo con datos espaciales de Argentina desde `R`.

------------------------------------------------------------------------

## INSTALACIÓN (*Install*)

### Desde `CRAN` (versión estable)

``` r

# Install geoAr in R:

install.packages('geoAr')
```

### Versión en desarrollo (*Development version*)

#### Desde *GitHub*

``` r
# install.packages('devtools') si no tiene instalado devtools

devtools::install_github("politicaargentina/geoAr")
```

#### `r-universe`

Se puede agregar el repositorio de [`r-universe`](https://politicaargentina.r-universe.dev/builds) como parámetro a la función base `install.packages`:

``` r

# Install geoAr in R:
install.packages('geoAr', repos = c('https://politicaargentina.r-universe.dev')
```

## Ejemplo de uso básico (*Basic Usage*)

```{r}

library(geoAr)


show_arg_codes() # Preview avialable data 


(tucuman <- get_geo(geo = "TUCUMAN")) # geo id parameter from show_arg_codes() function

```

## Información Disponible (*Available Data*)

### Geometrías

#### **Polígonos**

**Las funciones básicas para obtener polígonos de Argentina corresponden a la última información censal disponible (CENSO 2010)**

-   ARGENTINA (niveles PROVINCIA, DEPARTAMENTO y RADIO CENSAL)

-   24 provincias (niveles DEPARTAMENTO y RADIO CENSAL)

**CENSOS históricos**

-   Se facilita el acceso a la reconstrucción de los polígonos utilizados para los censos desde 1869 hasta 2010. Recuperado del proyecto *Base cartográfica de departamentos para los censos nacionales de la República Argentina desde 1869 a 2010* de [Gonzalo Rodriguez y Pablo De Grande](https://ri.conicet.gov.ar/handle/11336/149867).

**Encuesta Permanente de Hogares (EPH)**

-   Geometrías (entidades, envolventes y radios censales) correspondientes a la EPH del INDEC.

#### **Puntos (coordenadas)**

-   Base de Asentamientos Humanos de la República Argentina (BAHRA) 

### Grillas `geofacet`

-   Grillas para usar con [geofacet](https://politicaargentina.github.io/geoAr/articles/geoAr_geofacet.html) para ARGENTINA, 24 provincias y AGLOMERADOS URBANOS (para usar con {eph}

-   Libro de códigos (país, provincia, departamento) y función para re-codificar grillas según diccionario (ISO, INDEC, INDRA).

### `georef-ar` API

-   Interfaz en R para usar la [API del Servicio de Normalización de Datos Geográficos](https://georef-ar-api.readthedocs.io/es/latest/), que 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. La versión original de estas funciones fueron desarrolladas en el paquete `georefar` desarrollado por [Patricio del Boca](https://github.com/pdelboca/georefar).
-   Incluye funciones para realizar consultas individuales (e.g., `get_provincias()`, `normalizar_direccion()`) y consultas masivas (bulk) para la mayoría de los endpoints (e.g., `post_provincias_bulk()`, `post_direcciones_bulk()`).
-   Permite la descarga de datasets completos en diversos formatos (CSV, GeoJSON, etc.) mediante la función `get_geodata_dump()`.

## Paquetes similares para otros países (*Similar packages*)

-   `{geoUy}` - 
-   `{geoBr}` - 
-   `{chilemapas}` - 

## Citation

To cite package 'geoAr' in publications use:

*Ruiz Nicolini J, Del Boca P, Juara J (2024). geoAr: Argentina's Spatial Data Toolbox. R package version 1.1.0, .*

A BibTeX entry for LaTeX users is

```         

  
  @Manual{,
    title = {geoAr: Argentina's Spatial Data Toolbox},
    author = {Juan Pablo {Ruiz Nicolini} and Patricio {Del Boca} and Juan Gabriel Juara},
    year = {2024},
    note = {R package version 1.1.0},
    url = {https://github.com/PoliticaArgentina/geoAr},
  }
  
```

## `{geoAr}` es parte del [universo de paquetes **polAr**](https://github.com/PoliticaArgentina/polArverse)

```{r, echo=FALSE}

knitr::include_graphics("https://github.com/PoliticaArgentina/data_warehouse/raw/master/hex/collage.png")

```

Owner

GitHub Events

Issues and Pull Requests

Last synced: 6 months ago

Packages