Package 'geoAr'

Title: Argentina's Spatial Data Toolbox
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.
Authors: Juan Pablo Ruiz Nicolini [aut, cre, cph] (ORCID: <https://orcid.org/0000-0002-3138-6343>), Patricio Del Boca [aut], Juan Gabriel Juara [aut]
Maintainer: Juan Pablo Ruiz Nicolini <[email protected]>
License: MIT + file LICENSE
Version: 1.2.2
Built: 2026-05-08 15:26:19 UTC
Source: https://github.com/PoliticaArgentina/geoAr

Help Index

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

data

data.frame obtenido con get_geo. Los mapas disponibles se pueden chequear con show_arg_codes.

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()

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

data

debe ser un objeto con class "leaflet" "htmlwidget".

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()

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

...

geoAr package

Description

Caja de Herramientas GEO de Argentina See the README on Github

Author(s)

Maintainer: Juan Pablo Ruiz Nicolini [email protected] (ORCID) [copyright holder]

Authors:

See Also

Useful links:

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

id

text Filtrar por ID.
nombre

text Filtrar por Nombre.
provincia

text Filtrar por nombre o ID de Provincia.
departamento

text Filtrar por nombre o ID de Departamento.
municipio

text Filtrar por nombre o ID de Municipio.
localidad_censal

text Filtrar por nombre o ID de localidad censal. Se pueden especificar varios IDs separados por comas
interseccion

text Geometría GeoJSON utilizada para filtrar resultados por intersección espacial. Sólo se soportan polígonos y multipolígonos. Ejemplo: polygon((-58.431,-34.592),(-58.430,-34.590),(-58.428,-34.593),(-58.431,-34.592)).
orden

text Campo por el cual ordenar los resultados (por ID o nombre)
aplanar

boolean Cuando está presente, muestra el resultado JSON con una estructura plana.
campos

text Campos a incluir en la respuesta separados por comas, sin espacios. Algunos campos siempre serán incluidos, incluso si no se agregaron en la lista. Para incluir campos de sub-entidades, separar los nombres con un punto, por ejemplo: provincia.id.
max

integer Cantidad máxima de resultados a devolver. La API limita a un máximo de 5000 para este endpoint.
inicio

integer Cantidad de resultados a omitir desde el principio.
exacto

boolean Cuando está presente, se activa el modo de búsqueda por texto exacto. Sólo tiene efecto cuando se usan campos de búsqueda por texto (por ejemplo, nombre).

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

geo

un character con el nombre del distrito que se quiere descargar (por defecto toda ARGENTINA) Se puede chequear el id con show_arg_codes.

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

nombre

text Filtrar por Nombre.
id

text Filtrar por ID.
tipo

text Tipo de calle. (Valores disponibles: calle, avenida, pasaje.)
provincia

text Filtrar por nombre o ID de provincia.
departamento

text Filtrar por nombre o ID de departamento.
municipio

text Filtrar por nombre o ID de municipio.
localidad_censal

text Filtrar por nombre o ID de localidad censal.
categoria

text Filtrar por categoría de calle.
interseccion

text Geometría GeoJSON utilizada para filtrar resultados por intersección espacial. Sólo se soportan polígonos y multipolígonos. Ejemplo: polygon((-58.431,-34.592),(-58.430,-34.590),(-58.428,-34.593),(-58.431,-34.592)).
orden

text Campo por el cual ordenar los resultados. (Por ID o nombre)
max

integer Cantidad máxima de resultados a devolver. Debe ser menor o igual a 5000.
inicio

integer Cantidad de resultados a omitir desde el principio. La suma de 'max' e 'inicio' no debe superar 10000.
aplanar

boolean Cuando está presente, muestra el resultado JSON con una estructura plana.
campos

text Campos a incluir en la respuesta separados por comas, sin espacios. Algunos campos siempre serán incluidos, incluso si no se agregaron en la lista. Para incluir campos de sub-entidades, separar los nombres con un punto, por ejemplo: provincia.id.
exacto

boolean Cuando está presente, se activa el modo de búsqueda por texto exacto. Sólo tiene efecto cuando se usan campos de búsqueda por texto (por ejemplo, nombre).

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

censo

un character con el id del año del censo del district que se quiere descargar. Se pueden chequear el id con show_available_censos.
simplified

por defecto es TRUE y determina la descarga de una versión simplificada de las geometrias. Con FALSE descarga la versión original de INDEC

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

id

text Filtrar por ID.
nombre

text Filtrar por Nombre.
provincia

text Filtrar por nombre o ID de Provincia.
interseccion

text Geometría GeoJSON utilizada para filtrar resultados por intersección espacial. Sólo se soportan polígonos y multipolígonos. Ejemplo: polygon((-58.431,-34.592),(-58.430,-34.590),(-58.428,-34.593),(-58.431,-34.592)).
orden

text Campo por el cual ordenar los resultados. (Por ID o nombre)
aplanar

boolean Cuando está presente, muestra el resultado JSON con una estructura plana.
campos

text Campos a incluir en la respuesta separados por comas, sin espacios. Algunos campos siempre serán incluidos, incluso si no se agregaron en la lista. Para incluir campos de sub-entidades, separar los nombres con un punto, por ejemplo: provincia.id.
max

integer Cantidad máxima de resultados a devolver. La API limita a un máximo de 529 para este endpoint.
inicio

integer Cantidad de resultados a omitir desde el principio.
exacto

boolean Cuando está presente, se activa el modo de búsqueda por texto exacto. Sólo tiene efecto cuando se usan campos de búsqueda por texto (por ejemplo, nombre).

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

geo

un character con el nombre del distrito que se quiere descargar. Se puede chequear el id con show_arg_codes.
simplified

por defecto es TRUE y determina la descarga de una versión simplificada de las geometrias. Con FALSE descarga la versión original de INDEC
centroid

por defecto devuelve poligonos como geometry pero pueden descargarse puntos (centroides correspondientes al level especificado)
level

por defecto devuelve a nivel envolvente pero puede descargarse a nivel radios y entidades

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

geo

un character con el nombre del district que se quiere descargar. Se pueden chequear el id con show_arg_codes.
level

parametro opcional para descargar geometrías a nivel 'departamento' o 'censal' cuando se solicita mapa nacional get_geo(geo = "ARGNTINA", level = "departamento").
simplified

por defecto es TRUE y determina la descarga de una versión simplificada de las geometrias. Con FALSE descarga la versión original de INDEC

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

entidad

Cadena de texto. La entidad geográfica a descargar. Valores posibles: "provincias", "departamentos", "municipios", "localidades", "localidades-censales", "asentamientos", "calles", "cuadras".
formato

Cadena de texto. El formato deseado para el archivo. Valores posibles: "csv", "json", "geojson", "ndjson".
path_to_save

Cadena de texto opcional. Ruta completa (incluyendo nombre de archivo y extensión) donde guardar el archivo descargado. Si es NULL (por defecto), la función devolverá el contenido parseado (para json/geojson/ndjson) o un data frame (para csv). Si se especifica una ruta, la función guardará el archivo y devolverá la ruta del archivo guardado.

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

district

un character con el nombre del district que se quiere descargar. Disponibles grillas para Argentina y para las 24 provincias. Se pueden chequear los parametros con show_arg_codes.

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

id

text Filtrar por ID.
nombre

text Filtrar por Nombre.
provincia

text Filtrar por nombre o ID de Provincia.
departamento

text Filtrar por nombre o ID de Departamento.
municipio

text Filtrar por nombre o ID de Municipio.
interseccion

text Geometría GeoJSON utilizada para filtrar resultados por intersección espacial. Sólo se soportan polígonos y multipolígonos. Ejemplo: polygon((-58.431,-34.592),(-58.430,-34.590),(-58.428,-34.593),(-58.431,-34.592)).
orden

text Campo por el cual ordenar los resultados (por ID o nombre)
aplanar

boolean Cuando está presente, muestra el resultado JSON con una estructura plana.
campos

text Campos a incluir en la respuesta separados por comas, sin espacios. Algunos campos siempre serán incluidos, incluso si no se agregaron en la lista. Para incluir campos de sub-entidades, separar los nombres con un punto, por ejemplo: provincia.id.
max

integer Cantidad máxima de resultados a devolver. La API limita a un máximo de 2000 para este endpoint.
inicio

integer Cantidad de resultados a omitir desde el principio.
exacto

boolean Cuando está presente, se activa el modo de búsqueda por texto exacto. Sólo tiene efecto cuando se usan campos de búsqueda por texto (por ejemplo, nombre).

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

id

text Filtrar por ID.
nombre

text Filtrar por Nombre.
provincia

text Filtrar por nombre o ID de Provincia.
departamento

text Filtrar por nombre o ID de Departamento.
municipio

text Filtrar por nombre o ID de Municipio.
interseccion

text Geometría GeoJSON utilizada para filtrar resultados por intersección espacial. Sólo se soportan polígonos y multipolígonos. Ejemplo: polygon((-58.431,-34.592),(-58.430,-34.590),(-58.428,-34.593),(-58.431,-34.592)).
orden

text Campo por el cual ordenar los resultados (por ID o nombre)
aplanar

boolean Cuando está presente, muestra el resultado JSON con una estructura plana.
campos

text Campos a incluir en la respuesta separados por comas, sin espacios. Algunos campos siempre serán incluidos, incluso si no se agregaron en la lista. Para incluir campos de sub-entidades, separar los nombres con un punto, por ejemplo: provincia.id.
max

integer Cantidad máxima de resultados a devolver. La API limita a un máximo de 5000 para este endpoint.
inicio

integer Cantidad de resultados a omitir desde el principio.
exacto

boolean Cuando está presente, se activa el modo de búsqueda por texto exacto. Sólo tiene efecto cuando se usan campos de búsqueda por texto (por ejemplo, nombre).

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

id

text Filtrar por ID.
nombre

text Filtrar por Nombre.
provincia

text Filtrar por nombre o ID de Provincia.
departamento

text Filtrar por nombre o ID de Departamento.
interseccion

text Geometría GeoJSON utilizada para filtrar resultados por intersección espacial. Sólo se soportan polígonos y multipolígonos. Ejemplo: polygon((-58.431,-34.592),(-58.430,-34.590),(-58.428,-34.593),(-58.431,-34.592)).
orden

text Campo por el cual ordenar los resultados. (Por ID o nombre)
aplanar

boolean Cuando está presente, muestra el resultado JSON con una estructura plana.
campos

text Campos a incluir en la respuesta separados por comas, sin espacios. Algunos campos siempre serán incluidos, incluso si no se agregaron en la lista. Para incluir campos de sub-entidades, separar los nombres con un punto, por ejemplo: provincia.id.
max

integer Cantidad máxima de resultados a devolver. La API limita a un máximo de 2000 para este endpoint.
inicio

integer Cantidad de resultados a omitir desde el principio.
exacto

boolean Cuando está presente, se activa el modo de búsqueda por texto exacto. Sólo tiene efecto cuando se usan campos de búsqueda por texto (por ejemplo, nombre).

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

id

text Filtrar por ID.
nombre

text Filtrar por Nombre.
interseccion

text Geometría GeoJSON utilizada para filtrar resultados por intersección espacial. Sólo se soportan polígonos y multipolígonos. Ejemplo: polygon((-58.431,-34.592),(-58.430,-34.590),(-58.428,-34.593),(-58.431,-34.592)).
orden

text Campo por el cual ordenar los resultados. (Por ID o nombre)
aplanar

boolean Cuando está presente, muestra el resultado JSON con una estructura plana.
campos

text Campos a incluir en la respuesta separados por comas, sin espacios. Algunos campos siempre serán incluidos, incluso si no se agregaron en la lista. Para incluir campos de sub-entidades, separar los nombres con un punto, por ejemplo: provincia.id.
max

integer Cantidad máxima de resultados a devolver. La API limita a un máximo de 24 para este endpoint.
inicio

integer Cantidad de resultados a omitir desde el principio.
exacto

boolean Cuando está presente, se activa el modo de búsqueda por texto exacto. Sólo tiene efecto cuando se usan campos de búsqueda por texto (por ejemplo, nombre).

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

lat

numeric Latitud del punto, en forma de número real con grados decimales.
lon

numeric Longitud del punto, en forma de número real con grados decimales.
aplanar

boolean Cuando está presente, muestra el resultado JSON con una estructura plana.
campos

text Campos a incluir en la respuesta separados por comas, sin espacios. Algunos campos siempre serán incluidos, incluso si no se agregaron en la lista. Para incluir campos de sub-entidades, separar los nombres con un punto, por ejemplo: provincia.id.

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

direccion

text Requerido. Direccion a normalizar, debe contener altura separada por espacio. (Ej: Colon 127)
provincia

text Filtrar por nombre o ID de provincia.
departamento

text Filtrar por nombre o ID de departamento.
localidad_censal

text Filtrar por nombre o ID de localidad censal.
localidad

text Filtrar por nombre o ID de localidad.
orden

text Campo por el cual ordenar los resultados. (Por ID o nombre)
aplanar

boolean Cuando está presente, muestra el resultado JSON con una estructura plana.
campos

text Campos a incluir en la respuesta separados por comas, sin espacios. Algunos campos siempre serán incluidos, incluso si no se agregaron en la lista. Para incluir campos de sub-entidades, separar los nombres con un punto, por ejemplo: provincia.id.
max

integer Cantidad máxima de resultados a devolver. La API limita a un máximo de 10 para este endpoint.
inicio

integer Cantidad de resultados a omitir desde el principio.
exacto

boolean Cuando está presente, se activa el modo de búsqueda por texto exacto. Sólo tiene efecto cuando se usan campos de búsqueda por texto (por ejemplo, nombre).

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

queries_list

Lista de listas. Cada lista interna debe contener los parámetros para una consulta de asentamiento individual. Parámetros válidos por consulta: id, nombre, provincia, departamento, municipio, localidad_censal, orden, aplanar, campos, max, exacto.

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

queries_list

Lista de listas. Cada lista interna debe contener los parámetros para una consulta de calle individual. Parámetros válidos por consulta: nombre, id, tipo, provincia, departamento, municipio, localidad_censal, categoria, max, inicio, aplanar, campos, exacto.

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

queries_list

Lista de listas. Cada lista interna debe contener los parámetros para una consulta de departamento individual (e.g., list(nombre = "Rosario"), list(provincia = "02")). Parámetros válidos por consulta: id, nombre, provincia, orden, aplanar, campos, max, exacto.

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

queries_list

Lista de listas. Cada lista interna debe contener los parámetros para una consulta de normalización de dirección individual. Parámetro requerido por consulta: 'direccion' (e.g., "AV SAN MARTIN 123"). Otros parámetros válidos: tipo, provincia, departamento, aplanar, campos, max, exacto.

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

queries_list

Lista de listas. Cada lista interna debe contener los parámetros para una consulta de localidad individual. Parámetros válidos por consulta: id, nombre, provincia, departamento, municipio, orden, aplanar, campos, max, exacto.

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

queries_list

Lista de listas. Cada lista interna debe contener los parámetros para una consulta de localidad censal individual. Parámetros válidos por consulta: id, nombre, provincia, departamento, municipio, orden, aplanar, campos, max, exacto.

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

queries_list

Lista de listas. Cada lista interna debe contener los parámetros para una consulta de municipio individual. Parámetros válidos por consulta: id, nombre, provincia, departamento, orden, aplanar, campos, max, exacto.

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

queries_list

Lista de listas. Cada lista interna debe contener los parámetros para una consulta de provincia individual (e.g., list(nombre = "Tucuman"), list(id = "06")). Parámetros válidos por consulta: id, nombre, orden, aplanar, campos, max, exacto.

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

queries_list

Lista de listas. Cada lista interna debe contener los parámetros 'lat' y 'lon' para un punto. Otros parámetros válidos por consulta: aplanar, campos.

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

data

data.frame obtenido con get_grid. Las grillas disponibles se pueden chequear con show_arg_codes.
type

la variante del código que se quiere definir para la grilla. Las opciones son 'indra', 'indec' o 'iso'.

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")

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

viewer

Por default es TRUE y muestra una tabla formateada en el Viewer de RStudio. Cuando FALSE imprime en consola.
nivel

Un character que permite elegir opción para ver diccionario a nivel de "provincias" o de "departamentos".

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()