Tips y recomendaciones
Esta sección reúne sugerencias y buenas prácticas para aprovechar al máximo el uso de Georef, tanto al consumir la API desde hojas de cálculo como al integrar consultas en desarrollos propios.
Normalización: mejores resultados con max=1
Cuando se normalizan unidades territoriales o direcciones, es recomendable incluir el parámetro max=1 en la consulta. Esto asegura que se devuelva solo el resultado más probable. Si no se utiliza este parámetro, la respuesta puede incluir múltiples resultados, y al procesarlos automáticamente (por ejemplo, desde una hoja de cálculo), los valores podrían sobrescribirse entre sí.
En consultas de normalización, no usar exacto=true
El parámetro exacto=true sirve para obtener coincidencias exactas, pero no debe utilizarse en procesos de normalización, ya que reduce la flexibilidad del sistema para interpretar entradas con errores o variaciones comunes. Para una mejor tolerancia a inconsistencias, se recomienda no incluir este parámetro.
Usar importJSON() en Google Sheets
Para leer respuestas en formato JSON desde Google Sheets, se puede usar la función personalizada importJSON(). Requiere incorporar un script desde el menú Extensiones → Apps Script. Este método permite extraer campos específicos desde una URL de la API y procesarlos dentro de la hoja.
Consejo
cuando uses importJSON() con varias celdas y sin max=1, se pueden sobrescribir resultados en filas contiguas. Por eso, es clave filtrar con max=1.
Separador decimal en CSV.
Los CSV generados por Georef utilizan punto (.) como separador decimal. En Google Sheets y otras aplicaciones, es posible que se interprete incorrectamente si no está configurada una región adecuada. Para evitar errores, se recomienda establecer “Estados Unidos” como región dentro de la configuración del archivo.
Formato de geometrías: preferencia por GeoJSON
Si se planea trabajar en entornos de datos abiertos o integrar datos con aplicaciones web, se recomienda priorizar la descarga de geometrías en formato .geojson, ya que es abierto, liviano y ampliamente soportado. El formato .shp también está disponible, pero requiere software específico y su estructura no es tan flexible para web o automatización.
Descargas completas: usar .csv, .json, .geojson o .ndjson
Cada recurso principal de la API permite descargar la base completa con una simple modificación en la URL, agregando el formato deseado al final. Por ejemplo:
https://apis.datos.gob.ar/georef/api/v2.0/provincias.csv
Esto facilita el acceso sin tener que paginar o filtrar.