Package {georefar}

Title: Wrapper for the Argentine 'Georef' Geocoding API
Version: 0.1.0
Description: Query the Argentine national geographic normalization service 'georef' https://apis.datos.gob.ar/georef from R, searching provinces, departments, municipalities, localities, settlements, census units, streets and educational institutions, normalizing addresses and performing reverse geocoding. Results are returned as data frames, and batch queries can be sent in a single request.
License: GPL-3
URL: https://github.com/datosgobar/georefar
BugReports: https://github.com/datosgobar/georefar/issues
Encoding: UTF-8
Depends: R (≥ 4.1.0)
Imports: assertthat, curl, dplyr, httr2, jsonlite, purrr
Suggests: mockery, testthat (≥ 3.0.0), withr
Config/testthat/edition: 3
Config/roxygen2/version: 8.0.0
RoxygenNote: 7.3.3
NeedsCompilation: no
Packaged: 2026-08-26 18:46:41 UTC; Julian
Author: Julián Echandi [aut, cre], Alén Carbajal [aut]
Maintainer: Julián Echandi <jechandi.gobar@gmail.com>
Repository: CRAN
Date/Publication: 2026-09-09 09:20:02 UTC

Obtener aglomerados

Description

Permite realizar búsquedas sobre el listado de aglomerados. Realiza la consulta GET al endpoint /aglomerados de georef-ar-api. Para aumentar la cuota de uso, se puede configurar un token JWT en la variable de entorno GEOREFAR_TOKEN (ver https://datosgobar.github.io/georef-ar-api/jwt-token/).

Usage

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

Arguments

id

text Filtrar por ID. Se pueden especificar varios IDs separados por comas.

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. También se pueden especificar los valores especiales basico, estandar y completo.

max

integer Cantidad máxima de resultados a devolver. Si no se especifica, la API muestra 10 resultados por defecto.

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 Aglomerados

References

georef-ar-api/aglomerados

Examples


# Requiere conexion a internet. Se usa try() para que una caida o un
# rate limit del servicio no haga fallar R CMD check (politica de CRAN
# sobre paquetes que dependen de recursos de internet).
# El endpoint /aglomerados no acepta filtro por provincia.
try(get_aglomerados(nombre = "GRAN ROSARIO"))

Obtener Asentamientos

Description

Permite realizar búsquedas sobre el listado de asentamientos. Realiza la consulta GET al endpoint /asentamientos de georef-ar-api. Para aumentar la cuota de uso, se puede configurar un token JWT en la variable de entorno GEOREFAR_TOKEN (ver https://datosgobar.github.io/georef-ar-api/jwt-token/).

Usage

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

Arguments

id

text Filtrar por ID. Se pueden especificar varios IDs separados por comas.

nombre

text Filtrar por Nombre.

provincia

text Filtrar por nombre o ID de Provincia.

departamento

text Filtrar por nombre o ID de Departamento.

gobierno_local

text Filtrar por nombre o ID de Gobierno Local.

localidad_censal

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

categoria

text Permite filtrar por tipo de asentamiento. Valores posibles: Paraje, Localidad, Base Antártica, Entidad.

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. También se pueden especificar los valores especiales basico, estandar y completo.

max

integer Cantidad máxima de resultados a devolver. Si no se especifica, la API muestra 10 resultados por defecto.

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.

References

georef-ar-api/asentamientos

Examples


# Requiere conexion a internet. Se usa try() para que una caida o un
# rate limit del servicio no haga fallar R CMD check (politica de CRAN
# sobre paquetes que dependen de recursos de internet).
try(get_asentamientos(provincia = "22", departamento = "007"))

Obtener Calles

Description

Permite realizar búsquedas sobre el listado de calles. Realiza la consulta GET al endpoint /calles de georef-ar-api. Para aumentar la cuota de uso, se puede configurar un token JWT en la variable de entorno GEOREFAR_TOKEN (ver https://datosgobar.github.io/georef-ar-api/jwt-token/).

Usage

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

Arguments

id

text Filtrar por ID.

nombre

text Filtrar por Nombre. Se pueden especificar varios IDs separados por comas.

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. Se pueden especificar varios IDs separados por comas

categoria

text Permite filtrar por tipo de asentamiento. Valores posibles: Avenida, Calle, Pasaje

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. También se pueden especificar los valores especiales basico, estandar y completo.

max

integer Cantidad máxima de resultados a devolver. Si no se especifica, la API muestra 10 resultados por defecto.

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 calles.

References

georef-ar-api/calles

Examples


# Requiere conexion a internet. Se usa try() para que una caida o un
# rate limit del servicio no haga fallar R CMD check (politica de CRAN
# sobre paquetes que dependen de recursos de internet).
try(get_calles(provincia = "22", departamento = "007"))

Obtener Departamentos

Description

Permite realizar búsquedas sobre el listado de departamentos. Realiza la consulta GET al endpoint /departamentos de georef-ar-api. Para aumentar la cuota de uso, se puede configurar un token JWT en la variable de entorno GEOREFAR_TOKEN (ver https://datosgobar.github.io/georef-ar-api/jwt-token/).

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. Si no se especifica, la API muestra 10 resultados por defecto.

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


# Requiere conexion a internet. Se usa try() para que una caida o un
# rate limit del servicio no haga fallar R CMD check (politica de CRAN
# sobre paquetes que dependen de recursos de internet).
try(get_departamentos(provincia = "06", max = 5))

Obtener Establecimientos Educativos

Description

Permite realizar búsquedas sobre el listado de establecimientos educativos. Realiza la consulta GET al endpoint /establecimientos-educativos de georef-ar-api. Para aumentar la cuota de uso, se puede configurar un token JWT en la variable de entorno GEOREFAR_TOKEN (ver https://datosgobar.github.io/georef-ar-api/jwt-token/).

Usage

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

Arguments

id

text Filtrar por ID. Se pueden especificar varios IDs separados por comas.

nombre

text Filtrar por Nombre.

provincia

text Filtrar por nombre o ID de Provincia.

departamento

text Filtrar por nombre o ID de Departamento.

gestion

text Filtrar por tipo de gestión. Valores posibles: Estatal, Privada

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. También se pueden especificar los valores especiales basico, estandar y completo.

max

integer Cantidad máxima de resultados a devolver. Si no se especifica, la API muestra 10 resultados por defecto.

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 Establecimientos Educativos

References

georef-ar-api/establecimientos-educativos

Examples


# Requiere conexion a internet. Se usa try() para que una caida o un
# rate limit del servicio no haga fallar R CMD check (politica de CRAN
# sobre paquetes que dependen de recursos de internet).
try(get_establecimientos_educativos(provincia = "cordoba", max = 10))

Obtener Fracciones Censales

Description

Permite realizar búsquedas sobre el listado de fracciones censales. Realiza la consulta GET al endpoint /fracciones-censales de georef-ar-api. Para aumentar la cuota de uso, se puede configurar un token JWT en la variable de entorno GEOREFAR_TOKEN (ver https://datosgobar.github.io/georef-ar-api/jwt-token/).

Usage

get_fracciones_censales(
  id = NULL,
  provincia = NULL,
  departamento = NULL,
  orden = NULL,
  aplanar = TRUE,
  campos = NULL,
  max = NULL,
  inicio = NULL,
  exacto = NULL
)

Arguments

id

text Filtrar por ID. Se pueden especificar varios IDs separados por comas.

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. También se pueden especificar los valores especiales basico, estandar y completo.

max

integer Cantidad máxima de resultados a devolver. Si no se especifica, la API muestra 10 resultados por defecto.

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 Fracciones Censales.

References

georef-ar-api/fracciones-censales

Examples


# Requiere conexion a internet. Se usa try() para que una caida o un
# rate limit del servicio no haga fallar R CMD check (politica de CRAN
# sobre paquetes que dependen de recursos de internet).
try(get_fracciones_censales(id = "8208428"))

Descargar Datos Geográficos Completos

Description

Permite descargar listados completos de entidades geográficas en diversos formatos. Accede al endpoint ⁠/{filename}⁠ de la georef-ar-api. Para aumentar la cuota de uso, se puede configurar un token JWT en la variable de entorno GEOREFAR_TOKEN (ver https://datosgobar.github.io/georef-ar-api/jwt-token/).

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", "gobiernos-locales", "municipios", "asentamientos", "localidades", "aglomerados", "localidades-censales", "fracciones-censales", "radios-censales", "calles", "cuadras", "establecimientos-educativos", "instituciones-universitarias".

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


# Requiere conexion a internet. Se usa try() para que una caida o un
# rate limit del servicio no haga fallar R CMD check (politica de CRAN
# sobre paquetes que dependen de recursos de internet).
  # Obtener provincias en formato GeoJSON como objeto R
  provincias_geojson <- try(get_geodata_dump(entidad = "provincias", formato = "geojson"))

  # Guardar departamentos en formato CSV.
  # Se usa tempfile(): los ejemplos nunca deben escribir en el directorio
  # de trabajo ni en el espacio de archivos del usuario.
  destino <- tempfile(fileext = ".csv")
  try(get_geodata_dump(entidad = "departamentos", formato = "csv", path_to_save = destino))
  unlink(destino)

Obtener Gobiernos Locales

Description

Permite realizar búsquedas sobre el listado de gobiernos locales. Realiza la consulta GET al endpoint /gobiernos-locales de georef-ar-api. Para aumentar la cuota de uso, se puede configurar un token JWT en la variable de entorno GEOREFAR_TOKEN (ver https://datosgobar.github.io/georef-ar-api/jwt-token/).

Usage

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

Arguments

id

text Filtrar por ID. Se pueden especificar varios IDs separados por comas.

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 Filtrar por intersección con otras entidades geográficas. El valor del campo debe tener el siguiente formato: < tipo de entidad A>:<id 1>:<id 2>, < tipo de entidad B>:<id 1>:<id 2>, ... Se incluye en la respuesta cualquier entidad que intereseccione con una o más de las entidades con los IDs especificados.

categoria

text Permite filtrar por tipo de gobierno local. Valores posibles: Comisión de Fomento, Comisión Municipal, Comisión Municipal, Comuna, Comuna Rural, Junta de Gobierno, 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. También se pueden especificar los valores especiales basico, estandar y completo.

max

integer Cantidad máxima de resultados a devolver. Si no se especifica, la API muestra 10 resultados por defecto.

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 Gobiernos Locales

References

georef-ar-api/gobiernos-locales

Examples


# Requiere conexion a internet. Se usa try() para que una caida o un
# rate limit del servicio no haga fallar R CMD check (politica de CRAN
# sobre paquetes que dependen de recursos de internet).
try(get_gobiernos_locales(provincia = "cordoba", max = 10))

Obtener Instituciones Universitarias

Description

Permite realizar búsquedas sobre el listado de instituciones universitarias. Realiza la consulta GET al endpoint /instituciones-universitarias de georef-ar-api. Para aumentar la cuota de uso, se puede configurar un token JWT en la variable de entorno GEOREFAR_TOKEN (ver https://datosgobar.github.io/georef-ar-api/jwt-token/).

Usage

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

Arguments

id

text Filtrar por ID. Se pueden especificar varios IDs separados por comas.

nombre

text Filtrar por Nombre.

provincia

text Filtrar por nombre o ID de Provincia.

departamento

text Filtrar por nombre o ID de Departamento.

gestion

text Filtrar por tipo de gestión. Valores posibles: Estatal, Privada

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. También se pueden especificar los valores especiales basico, estandar y completo.

max

integer Cantidad máxima de resultados a devolver. Si no se especifica, la API muestra 10 resultados por defecto.

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 Instituciones Universitarias

References

georef-ar-api/instituciones-universitarias

Examples


# Requiere conexion a internet. Se usa try() para que una caida o un
# rate limit del servicio no haga fallar R CMD check (politica de CRAN
# sobre paquetes que dependen de recursos de internet).
try(get_instituciones_universitarias(provincia = "cordoba", max = 10))

Obtener Localidades

Description

Permite realizar búsquedas sobre el listado de localidades. Realiza la consulta GET al endpoint /localidades de georef-ar-api. Para aumentar la cuota de uso, se puede configurar un token JWT en la variable de entorno GEOREFAR_TOKEN (ver https://datosgobar.github.io/georef-ar-api/jwt-token/).

Usage

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

Arguments

id

text Filtrar por ID. Se pueden especificar varios IDs separados por comas.

nombre

text Filtrar por Nombre.

provincia

text Filtrar por nombre o ID de Provincia.

departamento

text Filtrar por nombre o ID de Departamento.

gobierno_local

text Filtrar por nombre o ID de Gobierno Local.

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. También se pueden especificar los valores especiales basico, estandar y completo.

max

integer Cantidad máxima de resultados a devolver. Si no se especifica, la API muestra 10 resultados por defecto.

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


# Requiere conexion a internet. Se usa try() para que una caida o un
# rate limit del servicio no haga fallar R CMD check (politica de CRAN
# sobre paquetes que dependen de recursos de internet).
try(get_localidades(nombre = "PALERMO", provincia = "CIUDAD AUTONOMA DE BUENOS AIRES"))

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. Para aumentar la cuota de uso, se puede configurar un token JWT en la variable de entorno GEOREFAR_TOKEN (ver https://datosgobar.github.io/georef-ar-api/jwt-token/).

Usage

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

Arguments

id

text Filtrar por ID. Se pueden especificar varios IDs separados por comas.

nombre

text Filtrar por Nombre.

provincia

text Filtrar por nombre o ID de Provincia.

departamento

text Filtrar por nombre o ID de Departamento.

gobierno_local

text Filtrar por nombre o ID de Gobierno Local.

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. También se pueden especificar los valores especiales basico, estandar y completo.

max

integer Cantidad máxima de resultados a devolver. Si no se especifica, la API muestra 10 resultados por defecto.

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


# Requiere conexion a internet. Se usa try() para que una caida o un
# rate limit del servicio no haga fallar R CMD check (politica de CRAN
# sobre paquetes que dependen de recursos de internet).
try(get_localidades_censales(nombre = "VILLA GENERAL BELGRANO"))

Obtener Municipios

Description

Permite realizar búsquedas sobre el listado de municipios. Realiza la consulta GET al endpoint /municipios de georef-ar-api. Para aumentar la cuota de uso, se puede configurar un token JWT en la variable de entorno GEOREFAR_TOKEN (ver https://datosgobar.github.io/georef-ar-api/jwt-token/).

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. Si no se especifica, la API muestra 10 resultados por defecto.

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


# Requiere conexion a internet. Se usa try() para que una caida o un
# rate limit del servicio no haga fallar R CMD check (politica de CRAN
# sobre paquetes que dependen de recursos de internet).
try(get_municipios(provincia = "cordoba", max = 10))

Obtener Provincias

Description

Permite realizar búsquedas sobre el listado de provincias. Realiza la consulta GET al endpoint /provincias de georef-ar-api. Para aumentar la cuota de uso, se puede configurar un token JWT en la variable de entorno GEOREFAR_TOKEN (ver https://datosgobar.github.io/georef-ar-api/jwt-token/).

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. Si no se especifica, la API muestra el 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

Data Frame con listado de Provincias

References

georef-ar-api/provincias

Examples


# Requiere conexion a internet. Se usa try() para que una caida o un
# rate limit del servicio no haga fallar R CMD check (politica de CRAN
# sobre paquetes que dependen de recursos de internet).
try(get_provincias(nombre = "Neuquen"))

Obtener Radios Censales

Description

Permite realizar búsquedas sobre el listado de radios censales. Realiza la consulta GET al endpoint /radios-censales de georef-ar-api. Para aumentar la cuota de uso, se puede configurar un token JWT en la variable de entorno GEOREFAR_TOKEN (ver https://datosgobar.github.io/georef-ar-api/jwt-token/).

Usage

get_radios_censales(
  id = NULL,
  provincia = NULL,
  departamento = NULL,
  fraccion_censal = NULL,
  orden = NULL,
  aplanar = TRUE,
  campos = NULL,
  max = NULL,
  inicio = NULL,
  exacto = NULL
)

Arguments

id

text Filtrar por ID. Se pueden especificar varios IDs separados por comas.

provincia

text Filtrar por nombre o ID de Provincia.

departamento

text Filtrar por nombre o ID de Departamento.

fraccion_censal

text Filtrar por ID de fracción 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. También se pueden especificar los valores especiales basico, estandar y completo.

max

integer Cantidad máxima de resultados a devolver. Si no se especifica, la API muestra 10 resultados por defecto.

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 Radios Censales.

References

georef-ar-api/radios-censales

Examples


# Requiere conexion a internet. Se usa try() para que una caida o un
# rate limit del servicio no haga fallar R CMD check (politica de CRAN
# sobre paquetes que dependen de recursos de internet).
try(get_radios_censales(id = "820842811", fraccion_censal = "8208428"))

Obtener Ubicacion

Description

Permite realizar una georreferenciación inversa para un punto, informando cuales unidades territoriales lo contienen, además de la calle y altura más cercana. Realiza la consulta GET al endpoint /ubicacion de georef-ar-api. Para aumentar la cuota de uso, se puede configurar un token JWT en la variable de entorno GEOREFAR_TOKEN (ver https://datosgobar.github.io/georef-ar-api/jwt-token/).

Usage

get_ubicacion(lat, lon, division = NULL, 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.

division

text Tipo de división territorial que define las unidades territoriales que se devolverán. Valores disponibles : politica, geoestadistica

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. También se pueden especificar los valores especiales basico, estandar y completo.

Value

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

References

georef-ar-api/ubicacion

Examples


# Requiere conexion a internet. Se usa try() para que una caida o un
# rate limit del servicio no haga fallar R CMD check (politica de CRAN
# sobre paquetes que dependen de recursos de internet).
try(get_ubicacion(lat = -34.6037, lon = -58.3816))

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. Para aumentar la cuota de uso, se puede configurar un token JWT en la variable de entorno GEOREFAR_TOKEN (ver https://datosgobar.github.io/georef-ar-api/jwt-token/).

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,
  desplazar = 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).

desplazar

boolean Si está activo, al georreferenciar ubica el punto sobre la manzana en lugar de ubicarlos sobre el eje de calle

Value

Un Data Frame con el listado normalizado de de direcciones

References

georef-ar-api/direcciones

Examples


# Requiere conexion a internet. Se usa try() para que una caida o un
# rate limit del servicio no haga fallar R CMD check (politica de CRAN
# sobre paquetes que dependen de recursos de internet).
try(normalizar_direccion(direccion = "Corrientes 1200, Rosario"))
try(normalizar_direccion(direccion = "SAN MARTIN 100", provincia = "02", max = 5))

Consultar aglomerados en lote (POST)

Description

Realiza múltiples consultas al endpoint /aglomerados en una sola llamada usando POST.

Usage

post_aglomerados(queries_list)

Arguments

queries_list

Lista de listas, donde cada elemento es una consulta con los mismos parámetros aceptados por get_aglomerados.

Value

Un tibble con los resultados combinados de todas las consultas.

Consultas POST por lotes a la georef-ar-api

Description

Familia de funciones que permiten realizar múltiples consultas a un mismo endpoint de la georef-ar-api en una sola llamada, utilizando el método POST. A diferencia de las funciones get_*, que resuelven una consulta por vez, las funciones post_* reciben un conjunto de consultas, las agrupan en lotes según los límites de la API, las envían en paralelo y combinan las respuestas en un único resultado.

Usage

post_asentamientos(queries_list)

post_calles(queries_list)

post_departamentos(queries_list)

post_normalizar_direccion(queries_list)

post_establecimientos_educativos(queries_list)

post_fracciones_censales(queries_list)

post_gobiernos_locales(queries_list)

post_instituciones_universitarias(queries_list)

post_localidades(queries_list)

post_localidades_censales(queries_list)

post_municipios(queries_list)

post_provincias(queries_list)

post_radios_censales(queries_list)

post_ubicacion(queries_list)

Arguments

queries_list

Lista de listas. Cada elemento es una consulta expresada como una lista nombrada, cuyos nombres se corresponden con los parámetros aceptados por la función get_* del mismo endpoint (por ejemplo nombre, id, max, campos).

Details

Cada función corresponde al endpoint homónimo y acepta los mismos parámetros de búsqueda que su equivalente get_*. Para aumentar la cuota de uso, se puede configurar un token JWT en la variable de entorno GEOREFAR_TOKEN (ver https://datosgobar.github.io/georef-ar-api/jwt-token/).

Value

Un tibble con los resultados combinados de todas las consultas enviadas. Si ninguna consulta produce resultados, se devuelve un tibble vacío y se emite un warning.

References

georef-ar-api

Examples


# Requiere conexion a internet. Se usa try() para que una caida o un
# rate limit del servicio no haga fallar R CMD check (politica de CRAN
# sobre paquetes que dependen de recursos de internet).
consultas <- list(
  list(nombre = "Neuquen"),
  list(nombre = "Santa Fe", max = 1)
)
try(post_provincias(consultas))

try(post_ubicacion(list(
  list(lat = -34.6037, lon = -58.3816),
  list(lat = -31.4201, lon = -64.1888)
)))

Reemplaza NULL por 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

x

A list, vector, or single value to process

Value

The input with all NULL values replaced by NA