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.

lat	lon
-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.