Usar en planillas de cálculo
La API Georef puede integrarse fácilmente en herramientas como Google Sheets, permitiendo importar datos geográficos actualizados o normalizar listados directamente desde una planilla, sin conocimientos de programación.
A continuación, te mostramos cómo hacerlo en tres pasos:
1. Cambiar la configuración regional (solo para coordenadas)
La API devuelve coordenadas con punto decimal (“.”), por lo que es importante configurar Google Sheets en una región que utilice ese formato (por ejemplo, “Estados Unidos”) para que las columnas con coordenadas se visualicen correctamente.
Esto solo es necesario si vas a trabajar con coordenadas (lat y lon).
2. Importar listados de unidades territoriales
Para traer datos directamente desde la API, podés usar la función nativa IMPORTDATA() de Google Sheets.
Por ejemplo, para importar todas las localidades de la provincia de Santa Fe:
=IMPORTDATA("https://apis.datos.gob.ar/georef/api/v2.0/localidades?provincia=santa%20fe&formato=csv&max=1000")
El resultado será una tabla con los campos de cada localidad: ID, nombre, centroide, provincia, etc.
Tip
También podés importar provincias, departamentos, municipios, o cualquier entidad de la API que admita formato=csv.
3. Normalizar un listado de valores (ej. provincias o direcciones)
Si, por ejemplo, tenés una lista con nombres de provincias y querés obtener su ID oficial y nombre normalizado, o si queres normalizar direcciones y obtener su georreferencia, podés hacerlo generando URLs individuales y utilizando un complemento para procesar respuestas JSON.
Paso a paso:
- Generá las URLs en una columna con esta fórmula (suponiendo que la celda A2 tiene el nombre de la provincia):
=CONCATENATE(“https://apis.datos.gob.ar/georef/api/v2.0/provincias?nombre="; A2;”&max=1”)
Importante
- Siempre incluir el parámetro
max=1para que la API devuelva solo el mejor resultado. Si no se incluye, la API puede devolver múltiples coincidencias eIMPORTJSONsolo tomará una, sobrescribiendo las otras filas si no están bien controladas. - No usar
exacto=truepara normalización, ya que este parámetro exige coincidencias exactas y puede omitir resultados útiles si hay variaciones en la escritura.
- Instalá el script ImportJSON:
- Menú:
Extensiones → Apps Script - Borrá el contenido del editor y pegá el siguiente script: https://gist.github.com/bradjasper/eeec0e013f8b10247c67
- Guardá el archivo como
ImportJSON.gs
- Usá la función
IMPORTJSON()para traer los datos normalizados. Por ejemplo:
=ImportJSON(C2; "/provincias/id,/provincias/nombre"; "noInherit,noTruncate,noHeaders")
Esto te devolverá en la hoja de cálculo el ID y el nombre exacto de la provincia.
Con este método podés normalizar listas de provincias, departamentos, municipios, localidades o cualquier otra entidad territorial de la API directamente desde tu planilla.
También podés:
Normalizar direcciones usando el endpoint /direcciones. Por ejemplo, si tenés un listado como Av. Corrientes 1234 podés generar una URL del estilo:
="https://apis.datos.gob.ar/georef/api/v2.0/direcciones?direccion=" & ENCODEURL(A2)
Y luego obtener atributos como calle, altura, provincia, localidad, coordenadas, etc.
Realizar georreferencia inversa utilizando el endpoint /ubicacion, que te permite obtener la provincia, departamento y municipio correspondiente a un par de coordenadas (lat, lon). Por ejemplo:
="https://apis.datos.gob.ar/georef/api/v2.0/ubicacion?lat=" & A2 & "&lon=" & B2
Con IMPORTJSON() podés obtener en tus celdas los campos deseados, como /ubicacion/provincia/nombre, /direccion/provincia/id, o cualquier otro atributo devuelto por la API.
Este enfoque es especialmente útil para validar datos o enriquecer bases existentes sin salir de tu entorno de planillas.