Package {geoAr}

Title:	Argentina's Spatial Data Toolbox
Version:	1.2.2
Description:	Collection of tools that facilitates data access and workflow for spatial analysis of Argentina. Includes historical information from censuses, administrative limits at different levels of aggregation, location of human settlements, among others. Since it is expected that the majority of users will be Spanish-speaking, the documentation of the package prioritizes this language, although an effort is made to also offer annotations in English.
License:	MIT + file LICENSE
Language:	es, en
Encoding:	UTF-8
LazyData:	true
RoxygenNote:	7.3.2
Suggests:	testthat, gt, knitr, rmarkdown, geofacet, ggplot2, tibble
Depends:	R (≥ 4.1.0)
Imports:	dplyr, sf, httr2 (≥ 1.0.0), promises (≥ 1.2.0), assertthat, attempt, tidyr, stringr, magrittr, curl, glue, leaflet, jsonlite, purrr
URL:	https://politicaargentina.github.io/geoAr/, https://github.com/PoliticaArgentina/geoAr
BugReports:	https://github.com/PoliticaArgentina/geoAr/issues
VignetteBuilder:	knitr
NeedsCompilation:	no
Packaged:	2026-05-07 15:01:36 UTC; UsuarioFundar
Author:	Juan Pablo Ruiz Nicolini [aut, cre, cph], Patricio Del Boca [aut], Juan Gabriel Juara [aut]
Maintainer:	Juan Pablo Ruiz Nicolini <juanpabloruiznicolini@gmail.com>
Repository:	CRAN
Date/Publication:	2026-05-08 08:20:03 UTC

geoAr package

Description

Caja de Herramientas GEO de Argentina See the README on Github

Author(s)

Maintainer: Juan Pablo Ruiz Nicolini juanpabloruiznicolini@gmail.com (ORCID) [copyright holder]

Authors:

• Patricio Del Boca patriciodelboca@gmail.com

• Juan Gabriel Juara jg.juara@gmail.com

See Also

Useful links:

• https://politicaargentina.github.io/geoAr/

• https://github.com/PoliticaArgentina/geoAr

• Report bugs at https://github.com/PoliticaArgentina/geoAr/issues

Pipe operator

Description

See magrittr::%>% for details.

Usage

lhs %>% rhs

Value

internal

Agrega capa de Argentina para mapa interactivo (Load Argentina Tiles Template)

Description

Función que descarga capa base de Argentina para mapa interactivo creado con la libreria leaflet.

Usage

addArgTiles(data)

Arguments

Details

El objetivo es agregar referencias de la base sobre la que se visualizan geometrías de Argentina. Se pueden agregar capas como polígonos descargandolos con get_geo. Los geometrías disponibles se pueden chequear con show_arg_codes.

Value

Capa base para mapas interactivos

Examples

 get_geo("TUCUMAN") %>%
 leaflet::leaflet() %>%
 leaflet::addPolygons() %>%
 addArgTiles()

Agrega columnas con id geográficos asignados a poligonos de provincias o departamentos de Argentina (Augment Argentina's districts polygons id)

Description

Función que permite agregar columnas con ids geográficos para utilización de mapas de Argentina y de departamentos para los 24 distritos sub nacionales para una más sencilla la vinculación con bases de datos de diversas fuentes.

Usage

add_geo_codes(data)

Arguments

Details

Respecto el origen de los datos se puede consultar la documentación de ISO 3166-2 - International Organization for Standardization y del INDEC.

codprov y coddepto son las codificaciones de las bases de datos de INDRA, empresa encargada por muchos años de la tarea del escrutinio provisorio y utilizados en polAr.

Value

Los valores por defecto en get_geo son codprov_censo para provincia y coddepto_censo para departamentos, respectivamente. Estos corresponden a la codificación de INDEC. Con el agregado usando add_geo_codes se puede optar por las nomenclaturas de 'indra' - correspondiente a los escrutinios provisorios de elecciones nacionales, con las variantes codprov y coddepto, o la de 'iso' con \*_iso , estas últimas hasta el nivel provincial.

Examples

get_geo("TUCUMAN")


get_geo("TUCUMAN") %>%
   add_geo_codes()

Un archivo de datos que contiene el listado de las geometrías para los censos disponibles

Description

Un archivo de datos que contiene el listado de las geometrías para los censos disponibles

Usage

censos

Format

Un tibble con 10 filas filas y 1 variables (censo)que funciona como id para usar con get_geo

censo

ID correspondiente al año del censo de Argentina para descargar poligonos disponibles (1869 - 2010)

Un archivo de datos que contiene identificadores geográficos para los departamentos de Argentina y sus provincias (A data file containing geographic identifiers for the departments of Argentina and their provinces)

Description

Un archivo de datos que contiene identificadores geográficos para los departamentos de Argentina y sus provincias (A data file containing geographic identifiers for the departments of Argentina and their provinces)

Usage

geo_metadata

Format

Un tibble con 526 filas y 8 variables:

codprov, coddepto

identificadores utilizados por INDRA para escrutinios provisorios de elecciones nacionales

x_censo

identificadores de unidades geográficas del INDEC

x_iso

identificadores de International Organization for Standardization

...

Obtener Asentamientos de BAHRA

Description

Permite realizar búsquedas sobre el listado de asentamientos BAHRA. Realiza la consulta GET al endpoint /asentamientos de georef-ar-api. Si existe GEOREFAR_TOKEN en el Renviron lo usará para hacer la consulta.

Usage

get_asentamientos(
  id = NULL,
  nombre = NULL,
  provincia = NULL,
  departamento = NULL,
  municipio = NULL,
  localidad_censal = NULL,
  interseccion = NULL,
  orden = NULL,
  aplanar = TRUE,
  campos = NULL,
  max = NULL,
  inicio = NULL,
  exacto = NULL
)

Arguments

Value

Un Data Frame con el listado de Asentamientos BAHRA.

References

georef-ar-api/asentamientos

Examples

## Not run: 
get_asentamientos(provincia = "22", departamento = "007")

## End(Not run)

Descarga 'base total' de Asentamientos Humanos de la República Argentina (BAHRA)

Description

Descarga 'base total' de Asentamientos Humanos de la República Argentina (BAHRA)

Usage

get_bahra(geo = "ARGENTINA")

Arguments

Value

tibble con datos de BAHRA

Examples

get_bahra()

Obtener Calles

Description

Permite realizar búsquedas sobre el listado de vías de circulación. Realiza la consulta GET al endpoint /calles de georef-ar-api. Si existe GEOREFAR_TOKEN en el Renviron lo usará para hacer la consulta.

Usage

get_calles(
  nombre = NULL,
  id = NULL,
  tipo = NULL,
  provincia = NULL,
  departamento = NULL,
  municipio = NULL,
  localidad_censal = NULL,
  categoria = NULL,
  interseccion = NULL,
  orden = NULL,
  max = NULL,
  inicio = NULL,
  aplanar = TRUE,
  campos = NULL,
  exacto = NULL
)

Arguments

Value

Un Data Frame con el listado de Calles

References

georef-ar-api/calles

Examples

## Not run: 
get_calles(nombre = "Corrientes", provincia = "CIUDAD AUTONOMA DE BUENOS AIRES", max = 10)

## End(Not run)

Carga poligonos de Censos de Población Históricos de Argentina

Description

Carga poligonos de Censos de Población Históricos de Argentina

Usage

get_censo(censo = NULL, simplified = FALSE)

Arguments

Value

tibble con capa geografica correspondiente a geometrías de un censo histórico

Examples

get_censo(censo = "1947", simplified = TRUE)

Obtener Departamentos

Description

Permite realizar búsquedas sobre el listado de departamentos. Realiza la consulta GET al endpoint /departamentos de georef-ar-api. Si existe GEOREFAR_TOKEN en el Renviron lo usará para hacer la consulta.

Usage

get_departamentos(
  id = NULL,
  nombre = NULL,
  provincia = NULL,
  interseccion = NULL,
  orden = NULL,
  aplanar = TRUE,
  campos = NULL,
  max = NULL,
  inicio = NULL,
  exacto = NULL
)

Arguments

Value

Un Data Frame con el listado de Departamentos

References

georef-ar-api/departamentos

Examples

## Not run: 
get_departamentos(provincia = "06", max = 5)

## End(Not run)

Carga poligonos de los Aglomerados Urbanos correspondientes a la Encuesta Permanente de Hogares (INDEC)

Description

Carga poligonos de los Aglomerados Urbanos correspondientes a la Encuesta Permanente de Hogares (INDEC)

Usage

get_eph(
  geo = "ARGENTINA",
  simplified = TRUE,
  centroid = FALSE,
  level = "envolventes"
)

Arguments

Value

tibble con capa geografica correspondiente a alguna versión de geometrías utilizadas en la Encuesta Permanente de Hogares (EPH)

Examples

get_eph(geo = "TUCUMAN")

Carga poligonos geográficos de distritos de Argentina (Load Argentina's districts geometries)

Description

Función que descarga (geometry) para graficar con mapas

Usage

get_geo(geo = NULL, level = "departamento", simplified = TRUE)

Arguments

Value

tibble con capa geografica de Argentina o distrito seleccionado (a diferentes niveles de agregación) correspondientes al CENSO 2010 - INDEC

Examples

get_geo("TUCUMAN")

Descargar Datos Geográficos Completos

Description

Permite descargar listados completos de entidades geográficas en diversos formatos. Accede al endpoint de la georef-ar-api. Si existe GEOREFAR_TOKEN en el Renviron lo usará para hacer la consulta (aunque generalmente no es necesario para estos endpoints públicos).

Usage

get_geodata_dump(entidad, formato, path_to_save = NULL)

Arguments

Value

Dependiendo de 'path_to_save' y 'formato': - Si 'path_to_save' se especifica: la ruta al archivo guardado (invisiblemente). - Si 'path_to_save' es NULL: - Para "csv": un data.frame. - Para "json", "geojson", "ndjson": una lista o estructura de R parseada desde JSON. - Si la descarga o parseo falla, genera un error.

References

georef-ar-api/descargas

Examples

## Not run: 
  # Obtener provincias en formato GeoJSON como objeto R
  provincias_geojson <- get_geodata_dump(entidad = "provincias", formato = "geojson")

  # Guardar departamentos en formato CSV
  get_geodata_dump(entidad = "departamentos", formato = "csv", path_to_save = "deptos.csv")

## End(Not run)

Carga grillas de districts de Argentina (Load grids of districts of Argentina)

Description

Función que descarga grillas (facet) para acomodarlas como si fueran mapas de provincias y deparamentos de Argentina.

Usage

get_grid(district = NULL)

Arguments

Value

tibble con datos correspondientes a diseño de grillas para utilizar con libreria geofacet

Examples

get_grid("TUCUMAN")

Obtener Localidades

Description

Permite realizar búsquedas sobre el listado de localidades. Realiza la consulta GET al endpoint /localidades de georef-ar-api. Si existe GEOREFAR_TOKEN en el Renviron lo usará para hacer la consulta.

Usage

get_localidades(
  id = NULL,
  nombre = NULL,
  provincia = NULL,
  departamento = NULL,
  municipio = NULL,
  interseccion = NULL,
  orden = NULL,
  aplanar = TRUE,
  campos = NULL,
  max = NULL,
  inicio = NULL,
  exacto = NULL
)

Arguments

Value

Un Data Frame con el listado de Localidades

References

georef-ar-api/localidades

Examples

## Not run: 
get_localidades(nombre = "PALERMO", provincia = "CIUDAD AUTONOMA DE BUENOS AIRES")

## End(Not run)

Obtener Localidades Censales

Description

Permite realizar búsquedas sobre el listado de localidades censales. Realiza la consulta GET al endpoint /localidades-censales de georef-ar-api. Si existe GEOREFAR_TOKEN en el Renviron lo usará para hacer la consulta.

Usage

get_localidades_censales(
  id = NULL,
  nombre = NULL,
  provincia = NULL,
  departamento = NULL,
  municipio = NULL,
  interseccion = NULL,
  orden = NULL,
  aplanar = TRUE,
  campos = NULL,
  max = NULL,
  inicio = NULL,
  exacto = NULL
)

Arguments

Value

Un Data Frame con el listado de Localidades Censales.

References

georef-ar-api/localidades-censales

Examples

## Not run: 
get_localidades_censales(nombre = "VILLA GENERAL BELGRANO")

## End(Not run)

Obtener Municipios

Description

Permite realizar búsquedas sobre el listado de municipios. Realiza la consulta GET al endpoint /municipios de georef-ar-api. Si existe GEOREFAR_TOKEN en el Renviron lo usará para hacer la consulta.

Usage

get_municipios(
  id = NULL,
  nombre = NULL,
  provincia = NULL,
  departamento = NULL,
  interseccion = NULL,
  orden = NULL,
  aplanar = TRUE,
  campos = NULL,
  max = NULL,
  inicio = NULL,
  exacto = NULL
)

Arguments

Value

Un Data Frame con el listado de Municipios

References

georef-ar-api/municipios

Examples

## Not run: 
get_municipios(provincia = "cordoba", max = 10)

## End(Not run)

Obtener Provincias

Description

Permite realizar búsquedas sobre el listado de provincias. Realiza la consulta GET al endpoint /provincias de georef-ar-api. Si existe GEOREFAR_TOKEN en el Renviron lo usará para hacer la consulta.

Usage

get_provincias(
  id = NULL,
  nombre = NULL,
  interseccion = NULL,
  orden = NULL,
  aplanar = TRUE,
  campos = NULL,
  max = NULL,
  inicio = NULL,
  exacto = NULL
)

Arguments

Value

Un Data Frame con el listado de Provincias

References

georef-ar-api/provincias

Examples

## Not run: 
get_provincias(nombre = "Cordoba")

## End(Not run)

Obtener Ubicacion

Description

Permite realizar una georreferenciación inversa para un punto, informando cuales unidades territoriales lo contienen. Realiza la consulta GET al endpoint /ubicacion de georef-ar-api. Si existe GEOREFAR_TOKEN en el Renviron lo usará para hacer la consulta.

Usage

get_ubicacion(lat, lon, aplanar = TRUE, campos = NULL)

Arguments

Value

Un Data Frame con las unidades territoriales que contienen el punto.

References

georef-ar-api/ubicacion

Examples

## Not run: 
get_ubicacion()

## End(Not run)

Base de datos de grillas

Description

Grillas de Argentina para usar con facet_geo()

Usage

grillas_geofacet

Format

Una lista que contiene 25 data.frames con 5 variables:

code_provincia

identificación del distrito al que pertenece la grilla

col

LONGITUD relativa de los distritos de segundo nivel en la grilla asemejando la geografía

row

LATITUD relativa de los distritos de segundo nivel en la grilla asemejando la geografía

code

código de identificación de cada uno de los distritos que componen la grilla

name

nombre de cada uno de los distritos que componen la grilla

...

Normalizacion de direcciones

Description

Permite normalizar una dirección utilizando el listado de vías de circulación. Realiza la consulta GET al endpoint /direcciones de georef-ar-api. Si existe GEOREFAR_TOKEN en el Renviron lo usará para hacer la consulta.

Usage

normalizar_direccion(
  direccion,
  provincia = NULL,
  departamento = NULL,
  localidad_censal = NULL,
  localidad = NULL,
  orden = NULL,
  aplanar = TRUE,
  campos = NULL,
  max = NULL,
  inicio = NULL,
  exacto = NULL
)

Arguments

Value

Un Data Frame con el listado normalizado de de direcciones

References

georef-ar-api/direcciones

Examples

## Not run: 
normalizar_direccion(direccion = "Corrientes 1200, Rosario")
normalizar_direccion(direccion = "SAN MARTIN 100", provincia = "02", max = 5)

## End(Not run)

Enviar Lote de Consultas de Asentamientos (POST)

Description

Permite realizar múltiples búsquedas sobre el listado de asentamientos BAHRA en una sola llamada POST. Realiza la consulta POST al endpoint /asentamientos de georef-ar-api.

Usage

post_asentamientos_bulk(queries_list)

Arguments

Value

Un Data Frame (tibble) con los resultados combinados de todas las consultas.

References

georef-ar-api/asentamientos POST

Examples

## Not run: 
consultas_asent <- list(
  list(provincia = "CHUBUT", nombre = "COSTA")
)
resultados_asent <- post_asentamientos_bulk(queries_list = consultas_asent)
print(resultados_asent)

## End(Not run)

Enviar Lote de Consultas de Calles (POST)

Description

Permite realizar múltiples búsquedas sobre el listado de vías de circulación en una sola llamada POST. Realiza la consulta POST al endpoint /calles de georef-ar-api.

Usage

post_calles_bulk(queries_list)

Arguments

Value

Un Data Frame (tibble) con los resultados combinados de todas las consultas.

References

georef-ar-api/calles POST

Examples

## Not run: 
consultas_calles <- list(
  list(nombre = "SAN MARTIN", provincia = "BUENOS AIRES", max = 2),
  list(nombre = "SARMIENTO", provincia = "CORDOBA", max = 2)
)
resultados_calles <- post_calles_bulk(queries_list = consultas_calles)
print(resultados_calles)

## End(Not run)

Enviar Lote de Consultas de Departamentos (POST)

Description

Permite realizar múltiples búsquedas sobre el listado de departamentos en una sola llamada POST. Realiza la consulta POST al endpoint /departamentos de georef-ar-api.

Usage

post_departamentos_bulk(queries_list)

Arguments

Value

Un Data Frame (tibble) con los resultados combinados de todas las consultas.

References

georef-ar-api/departamentos POST

Examples

## Not run: 
consultas_deptos <- list(
  list(provincia = "22", nombre = "Ledesma"),
  list(id = "14028")
)
resultados_deptos <- post_departamentos_bulk(queries_list = consultas_deptos)
print(resultados_deptos)

## End(Not run)

Normalizar un Lote de Direcciones (POST)

Description

Permite normalizar múltiples direcciones en una sola llamada POST. Realiza la consulta POST al endpoint /direcciones de georef-ar-api.

Usage

post_direcciones_bulk(queries_list)

Arguments

Value

Un Data Frame (tibble) con los resultados combinados de todas las normalizaciones.

References

georef-ar-api/direcciones POST

Examples

## Not run: 
consultas_dir <- list(
  list(direccion = "MAIPU 100", provincia = "BUENOS AIRES"),
  list(direccion = "SANTA FE 2000, ROSARIO")
)
resultados_dir <- post_direcciones_bulk(queries_list = consultas_dir)
print(resultados_dir)

## End(Not run)

Enviar Lote de Consultas de Localidades (POST)

Description

Permite realizar múltiples búsquedas sobre el listado de localidades en una sola llamada POST. Realiza la consulta POST al endpoint /localidades de georef-ar-api.

Usage

post_localidades_bulk(queries_list)

Arguments

Value

Un Data Frame (tibble) con los resultados combinados de todas las consultas.

References

georef-ar-api/localidades POST

Examples

## Not run: 
consultas_loc <- list(
  list(provincia = "Tucuman", departamento = "Capital"),
  list(id = "22056140000")
)
resultados_loc <- post_localidades_bulk(queries_list = consultas_loc)
print(resultados_loc)

## End(Not run)

Enviar Lote de Consultas de Localidades Censales (POST)

Description

Permite realizar múltiples búsquedas sobre el listado de localidades censales en una sola llamada POST. Realiza la consulta POST al endpoint /localidades-censales de georef-ar-api.

Usage

post_localidades_censales_bulk(queries_list)

Arguments

Value

Un Data Frame (tibble) con los resultados combinados de todas las consultas.

References

georef-ar-api/localidades-censales POST

Examples

## Not run: 
consultas_loc_cen <- list(
  list(nombre = "AGUA DE ORO", provincia = "CÓRDOBA")
)
resultados_loc_cen <- post_localidades_censales_bulk(queries_list = consultas_loc_cen)
print(resultados_loc_cen)

## End(Not run)

Enviar Lote de Consultas de Municipios (POST)

Description

Permite realizar múltiples búsquedas sobre el listado de municipios en una sola llamada POST. Realiza la consulta POST al endpoint /municipios de georef-ar-api.

Usage

post_municipios_bulk(queries_list)

Arguments

Value

Un Data Frame (tibble) con los resultados combinados de todas las consultas.

References

georef-ar-api/municipios POST

Examples

## Not run: 
consultas_muni <- list(
  list(provincia = "06", nombre = "La Plata"),
  list(id = "540098")
)
resultados_muni <- post_municipios_bulk(queries_list = consultas_muni)
print(resultados_muni)

## End(Not run)

Enviar Lote de Consultas de Provincias (POST)

Description

Permite realizar múltiples búsquedas sobre el listado de provincias en una sola llamada POST. Realiza la consulta POST al endpoint /provincias de georef-ar-api. Si existe GEOREFAR_TOKEN en el Renviron lo usará para hacer la consulta.

Usage

post_provincias_bulk(queries_list)

Arguments

Value

Un Data Frame (tibble) con los resultados combinados de todas las consultas. Las respuestas de la API para cada consulta en el lote se apilan.

References

georef-ar-api/provincias POST

Examples

## Not run: 
consultitas <- list(
  list(nombre = "santiago del estero"),
  list(id = "82", campos = "id,nombre,centroide.lat,centroide.lon"),
  list(nombre = "tierra del fuego", campos = "completo")
)
resultados_provincias <- post_provincias_bulk(queries_list = consultitas)
print(resultados_provincias)

## End(Not run)

Georreferenciación Inversa para un Lote de Puntos (POST)

Description

Permite realizar georreferenciación inversa para múltiples puntos (lat, lon) en una sola llamada POST. Realiza la consulta POST al endpoint /ubicacion de georef-ar-api.

Usage

post_ubicacion_bulk(queries_list)

Arguments

Value

Un Data Frame (tibble) con los resultados combinados de todas las georreferenciaciones.

References

georef-ar-api/ubicacion POST

Examples

## Not run: 
consultas_ubic <- list(
  list(lat = -34.6037, lon = -58.3816), # Buenos Aires
  list(lat = -32.9587, lon = -60.6393)  # Rosario
)
resultados_ubic <- post_ubicacion_bulk(queries_list = consultas_ubic)
print(resultados_ubic)

## End(Not run)

Recodifica id de grillas asignados a provincias o departamentos de Argentina (Recode Argentina's districs id in grids)

Description

Función que permite re codificar etiquetas para utilización de grillas de Argentina y de departamentos para los 24 distritos sub nacionales. Ello permite hacer mas sencilla la vinculación con bases de datos de diversas fuentes.

Usage

recode_grid(data, type = NULL)

Arguments

Details

Respecto el origen de los datos se puede consultar la documentación de ISO 3166-2 - International Organization for Standardization y del INDEC.

codprov y coddepto son las codificaciones de las bases de datos de INDRA, empresa encargada por muchos años de la tarea del escrutinio provisorio y utilizados en polAr.

Value

Los valores por defecto en get_grid son codprov para provincia y coddepto para departamentos, respectivamente. Estos corresponden a la codificación de los escrutinios provisorios de elecciones nacionales y se etiquetaron como 'indra' . Se puede optar por la nomenclatura de 'indec', con la familia \*_censo, para ambos niveles, o la de 'iso' con \*_iso , para el nivel provincial.

Examples

get_grid("ARGENTINA")


get_grid("ARGENTINA") %>%
   recode_grid(type = "iso")

Replace NULL Values with NA

Description

Recursively replaces NULL values with NA in a list or vector. This function is useful for handling NULL values in API responses before converting them to data frames.

Usage

replace_null_with_na(x)

Arguments

Value

The input with all NULL values replaced by NA

Diccionario de códigos identificadores de distritos (geo ID's dictoniary)

Description

Función que devuelve un data.frame con códigos y equivalencias de identificación de unidades geográficas

Usage

show_arg_codes(viewer = FALSE, nivel = "provincias")

Arguments

Value

tibble con códigos geográficos correspondientes a distritos de Argentina descargados con get_geo

Examples

show_arg_codes(viewer = FALSE)

Geometrías de CENSOS (geo ID's dictoniary)

Description

Función que devuelve un data.frame con listado de las geometrías de los CENSOS disponible

Usage

show_available_censos()

Value

tibble con información auxiliar para descarga de CENSOS históricos con get_censo

Examples

show_available_censos()