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] , Patricio Del Boca [aut], Juan Gabriel Juara [aut]
Maintainer: Juan Pablo Ruiz Nicolini <[email protected]>
License: MIT + file LICENSE
Version: 1.0.0
Built: 2024-10-30 03:00:27 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,
  orden = NULL,
  aplanar = TRUE,
  campos = NULL,
  max = 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
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.
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()

## 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(
  id = NULL,
  nombre = NULL,
  tipo = NULL,
  provincia = NULL,
  departamento = NULL,
  aplanar = TRUE,
  campos = NULL,
  max = NULL,
  exacto = NULL
)

Arguments

id

text Filtrar por ID.
nombre

text Filtrar por Nombre.
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.
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.
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()

## 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,
  orden = NULL,
  aplanar = TRUE,
  campos = NULL,
  max = NULL,
  exacto = NULL
)

Arguments

id

text Filtrar por ID.
nombre

text Filtrar por Nombre.
provincia

text Filtrar por nombre o ID de Provincia.
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.
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()

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

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,
  orden = NULL,
  aplanar = TRUE,
  campos = NULL,
  max = 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.
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.
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()

## 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,
  orden = NULL,
  aplanar = TRUE,
  campos = NULL,
  max = 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.
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.
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()

## 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,
  orden = NULL,
  aplanar = TRUE,
  campos = NULL,
  max = 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.
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.
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()

## 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,
  orden = NULL,
  aplanar = TRUE,
  campos = NULL,
  max = NULL,
  exacto = NULL
)

Arguments

id

text Filtrar por ID.
nombre

text Filtrar por Nombre.
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.
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,
  tipo = NULL,
  provincia = NULL,
  departamento = NULL,
  aplanar = TRUE,
  campos = NULL,
  max = NULL,
  exacto = NULL
)

Arguments

direccion

text Requerido. Direccion a normalizar, debe contener altura separada por espacio. (Ej: Colon 127)
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.
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.
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()

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