Skip to content

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

Versión: 0.5.3

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.

En la Guía para la identificación y uso de entidades interoperables se explica cómo funcionan las unidades territoriales internas de la Argentina y la relación entre 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

GET https://apis.datos.gob.ar/georef/api/provincias?nombre=Sgo. del Estero

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

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

GET https://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"
        }
    },
    "parametros": { ... }
}

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:

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

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

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

GET https://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,
    "parametros": { ... }
}

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


Si sos usuario de la API de Normalización de Datos Geográficos y querés estar al tanto de los cambios y novedades, inscribite en la base de contactos de Datos Argentina y elegí sobre qué temas querés que te escribamos.

¿Tenés algo que contarnos? Nos encantaría que nos cuentes por Twitter o por mail qué mejoró usar la API en tu trabajo y qué le falta para mejorar aún más.