Skip to content

API del Servicio de Normalización de Datos Geográficos de Argentina

La API del Servicio de Normalización de Datos Geográficos, permite normalizar y codificar los nombres de unidades territoriales de la Argentina (provincias, departamentos, municipios y localidades) y de sus calles, así como ubicar coordenadas dentro de ellas.

Normalizar

Las unidades territoriales tienen nombres y códigos oficiales. Cuando no se usan, los datos son difíciles de cruzar entre sí y hay que normalizarlos antes.

provincia
Santiago del Estero
Stgo. del Estero
S. del Estero
Sgo. del Estero

GEThttps://apis.datos.gob.ar/georef/api/provincias?nombre=Sgo.%20del%20Estero

{
    "provincias": [
        {
            "nombre": "Santiago del Estero",
            "id": "86",
            "centroide": {
                "lat": -27.782412,
                "lon": -63.252387
            }
        }
    ],
    "cantidad": 1,
    "total": 1,
    "inicio": 0
}

Enriquecer

Cuando un conjunto de datos tiene puntos de coordenadas dentro de Argentina, puede cruzarse con muchos datos más, relacionados a las unidades territoriales que lo contienen. Para esto hay que agregarlas a los datos originales.

latlon
-27.2741-66.7529
-34.603633-58.3837587

GEThttps://apis.datos.gob.ar/georef/api/ubicacion?lat=-27.2741&lon=-66.7529

{
    "ubicacion": {
        "departamento": {
            "id": "10035",
            "nombre": "Belén"
        },
        "lat": -27.2741,
        "lon": -66.7529,
        "municipio": {
            "id": "100077",
            "nombre": "Hualfín"
        },
        "provincia": {
            "id": "10",
            "nombre": "Catamarca"
        }
    }
}

Referencia

Finalmente, se puede utilizar la API como punto de referencia al momento de crear datos que estén vinculados a datos geográficos. Por ejemplo, si se cuenta con un formulario en el que se debe mostrar a un usuario un listado de provincias, y luego un listado de municipios a partir de la provincia seleccionada, se podrían ejecutar las siguientes consultas:

Listar las provincias de la República Argentina:

GEThttps://apis.datos.gob.ar/georef/api/provincias?campos=id,nombre

{
    "provincias": [
        {
            "nombre": "Chaco",
            "id": "22"
        },
        { ... } // 23 resultados omitidos
    ],
    "cantidad": 24,
    "total": 24,
    "inicio": 0
}

Asumiendo que el usuario selecciona Chaco (ID: 22), se ejecutaría la siguiente consulta para obtener el listado de municipios:

GEThttps://apis.datos.gob.ar/georef/api/municipios?provincia=22&campos=id,nombre&max=100

{
    "municipios": [
        {
            "nombre": "Makallé",
            "id": "220161"
        },
        { ... } // 67 resultados omitidos
    ],
    "cantidad": 68,
    "total": 68,
    "inicio": 0
}

Notar que al ser datos que no son modificados regularmente, es posible retener copias de los mismos para ser reutilizados en el futuro.