Georef permite normalizar nombres de unidades territoriales de Argentina a partir de una cadena de texto que contenga el nombre (o una variante) de una provincia, departamento, gobierno local o asentamiento humano. La normalización devuelve el nombre estandarizado, su identificador único, otras unidades territoriales que la contienen e información adicional brindada por la fuente.

Este proceso es especialmente útil para:

• Establecer correspondencias entre bases de datos con distintos formatos o criterios de denominación.
• Integrar información territorial con fuentes oficiales.
• Estandarizar nombres escritos con errores, variantes locales o abreviaciones.
• Obtener datos geográficos asociados (por ejemplo, geometría o ubicación).

¿Qué se puede normalizar?

El servicio permite normalizar los siguientes niveles territoriales:

• Provincias
• Departamentos
• Gobierno Locales
• Municipios
• Asentamientos humanos
• Localidades
• Aglomerados
• Localidades censales

Cada uno de estos niveles cuenta con su propio endpoint en la API, y se puede utilizar de manera independiente o combinada (por ejemplo, normalizar una localidad especificando su provincia para mayor precisión).

Cómo funciona

El recurso correspondiente a cada entidad acepta parámetros como nombre, id, o filtros por jerarquías superiores (provincia, departamento, etc.). La API busca coincidencias aproximadas (con tolerancia a errores tipográficos o variantes comunes) y devuelve la forma estandarizada, su código y otras propiedades asociadas.

Ejemplo de consulta

GET 
https://apis.datos.gob.ar/georef/api/localidades?nombre=posadas&provincia=misiones

Ejemplo de respuesta

{
  "cantidad": 1,
  "localidades": [
    {
      "id": "54007010",
      "nombre": "Posadas",
      "provincia": {
        "id": "54",
        "nombre": "Misiones"
      },
      "departamento": {
        "id": "54007",
        "nombre": "Capital"
      },
      "centroide": {
        "lat": -27.36708,
        "lon": -55.89608
      }
    }
  ]
}

Campos de respuesta principales

• id: Código único de la localidad.
• nombre: Nombre oficial normalizado.
• categoria: Tipo de entidad (por ejemplo, “Localidad simple”, “Componente de localidad compuesta”).
• provincia: Objeto con id y nombre de la provincia.
• departamento: Objeto con id y nombre del departamento.
• municipio: Objeto con id y nombre del municipio, si está disponible.
• localidad_censal: Objeto con id y nombre de la localidad censal correspondiente.
• centroide: Coordenadas aproximadas del punto geográfico (latitud y longitud).
• fuente: Organismo proveedor del dato (por ejemplo, “INDEC”).

Buenas prácticas para mejorar resultados

• Utilizar parámetros combinados (nombre + provincia, por ejemplo, o provincia + departamento si se buscan localidades) para evitar ambigüedades.
• Consultar la referencia de la API (swagger) para conocer los campos disponibles para cada tipo de unidad.
• Aplicar filtros jerárquicos solo cuando se disponga de información confiable (ej. si se conoce el nombre de provincia o departamento con certeza).