Normalización de direcciones

Georef permite normalizar y georreferenciar direcciones en todo el país a partir de un texto libre que contenga combinaciones de nombres de calles, alturas y referencias espaciales (entre calles, esquinas, etc.). A través de este proceso se devuelve una estructura organizada con el nombre estandarizado de la calle, el número de altura (si lo hay), las intersecciones de referencia y, cuando es posible, la ubicación geográfica estimada.

¿Qué se puede hacer?

Interpretar direcciones con estructuras diversas, incluso si contienen errores comunes de escritura.
Obtener el nombre normalizado de la calle y su identificación oficial.
Obtener el nombre de las unidades territoriales en las que se encuentran las direcciones.
Obtener la ubicación geográfica aproximada (latitud y longitud) de la dirección.

El recurso utilizado es /direcciones, y la interpretación de los textos se realiza mediante la librería de código abierto georef-ar-address.

Parámetros principales

direccion (obligatorio): texto con la dirección a normalizar.
provincia, departamento, localidad_censal, localidad: opcionales pero recomendables para limitar la búsqueda y aumentar la precisión.

Se aceptan múltiples formatos de dirección, como:

calle [altura]
calle 1 esquina calle 2
calle 1 entre calle 2 y calle 3 [altura]
calle 1 [altura] entre calle 2 y calle 3

La altura puede estar acompañada por piso, unidad o complemento (ej. “2do C”).

Ejemplo de consulta


GET 
https://apis.datos.gob.ar/georef/api/v2.0/direcciones?direccion=Av. Santa Fe nro 260 2ndo C, entre Santa Rosa y Colón&departamento=capital&provincia=cordoba

Ejemplo de respuesta


{
  "cantidad": 1,
  "direcciones": [
    {
      "altura": {
        "unidad": "nro",
        "valor": 260
      },
      "calle": {
        "categoria": "AV",
        "id": "1401401002460",
        "nombre": "AV SANTA FE"
      },
      "calle_cruce_1": {
        "categoria": "CALLE",
        "id": "1401401038100",
        "nombre": "SANTA ROSA"
      },
      "calle_cruce_2": {
        "categoria": "AV",
        "id": "1401401002060",
        "nombre": "AV COLON"
      },
      "departamento": {
        "id": "14014",
        "nombre": "Capital"
      },
      "localidad_censal": {
        "id": "14014010",
        "nombre": "Córdoba"
      },
      "nomenclatura": "AV SANTA FE 260 (ENTRE SANTA ROSA Y AV COLON), Capital, Córdoba",
      "piso": null,
      "provincia": {
        "id": "14",
        "nombre": "Córdoba"
      },
      "ubicacion": {
        "lat": -31.4080674840673,
        "lon": -64.20062417513701
      }
    }
  ]
}

Campos principales de respuesta

Al normalizar una dirección, la API devuelve un objeto con varios campos estructurados. A continuación se detallan los principales:

altura: Información sobre la altura reconocida en la dirección.
- unidad: Unidad de la altura o prefijo del valor numérico (por ejemplo, “nro”, “km”).
- valor: Valor numérico de la altura, o null si no fue reconocida como tal.
calle: Propiedades de la primera calle detectada.
- nombre: Nombre normalizado.
- id: Identificador único.
categoria: Tipo de calle (AV, CALLE, etc.).
calle_cruce_1 (opcional): Segunda calle presente en la dirección (ej. en esquinas o entre calles).
- nombre, id, categoria
calle_cruce_2 (opcional): Tercera calle presente en la dirección.
- nombre, id, categoria
departamento: Departamento correspondiente a la calle reconocida.
- id, nombre
- localidad_censal: Localidad censal asociada.
- id, nombre
provincia: Provincia correspondiente.
- id, nombre
piso: Piso extraído, si fue identificado en el texto original.
nomenclatura: Versión legible y estandarizada de la dirección completa.
ubicacion: Resultados de la georreferenciación de la dirección (lon y lat). Cuando los valores están presentes, representan una aproximación de la ubicación de la dirección. Cuando no están presentes, se debe a que los datos indexados en la API no fueron suficientes para obtener un resultado estimativo. La efectividad de la georreferenciación varía de acuerdo a cada región del país.

Normalización por lotes

Para normalizar múltiples direcciones de forma simultánea, se recomienda utilizar los recursos de consultas por lotes, que permiten enviar listas de direcciones en una sola solicitud. Más detalles en la sección Consultas por lotes.

Presidencia de la Nación