A continuación se presentan consultas básicas a la API Georef utilizando el método GET. Estos ejemplos muestran cómo obtener información geográfica de distintas entidades y cómo realizar tareas de normalización y búsqueda.

Búsqueda de provincias por nombre

Consulta:

GET 
https://apis.datos.gob.ar/georef/api/v2.0/provincias?nombre=cordoba

Respuesta:

{
  "provincias": [
    {
      "id": "14",
      "centroide": { "lat": -32.142933, "lon": -63.801753 },
      "nombre": "CÓRDOBA"
    }
  ],
  "cantidad": 1,
  "total": 1,
  "inicio": 0
}

Listado de departamentos de una provincia

Consulta:

GET 
https://apis.datos.gob.ar/georef/api/v2.0/departamentos?provincia=jujuy&max=16

Respuesta (fragmento):

{
  "departamentos": [
    {
      "id": "38042",
      "centroide": { "lat": -24.194923, "lon": -65.12645 },
      "nombre": "PALPALÁ",
      "provincia": { "id": "38", "nombre": "JUJUY" }
    },
    ...
  ],
  "cantidad": 16,
  "total": 16
}

Búsqueda de municipios con respuesta aplanada

Consulta:

GET 
https://apis.datos.gob.ar/georef/api/v2.0/municipios?provincia=tucuman&aplanar

Respuesta (fragmento):

{
  "municipios": [
    {
      "centroide_lat": -27.816619,
      "centroide_lon": -65.199594,
      "id": "908210",
      "nombre": "Taco Ralo",
      "provincia_id": "90",
      "provincia_nombre": "Tucumán"
    },
    ...
  ],
  "cantidad": 10,
  "total": 112
}

Búsqueda de localidades con campos personalizados

Consulta:

GET 
https://apis.datos.gob.ar/georef/api/v2.0/localidades?provincia=chubut&campos=nombre

Respuesta (fragmento):

{
  "localidades": [
    {
      "id": "26007030000",
      "nombre": "PUERTO PIRAMIDE"
    },
    ...
  ],
  "cantidad": 10,
  "total": 90
}

Normalización de direcciones

Consulta:

GET 
https://apis.datos.gob.ar/georef/api/v2.0/direcciones?departamento=merlo&direccion=Florida al 2950

Respuesta :

{
  "direcciones": [
    {
      "altura": { "valor": 2950 },
      "calle": { "id": "0653901002985", "nombre": "FLORIDA", "categoria": "CALLE" },
      "departamento": { "id": "06539", "nombre": "Merlo" },
      "provincia": { "id": "06", "nombre": "Buenos Aires" },
      "ubicacion": { "lat": -34.7140908, "lon": -58.7346994 },
      "nomenclatura": "FLORIDA 2950, Merlo, Buenos Aires"
    }
  ],
  "cantidad": 1,
  "total": 1
}

Búsqueda de calles filtradas por categoría

Consulta:

GET 
https://apis.datos.gob.ar/georef/api/v2.0/calles?departamento=rio chico&categoria=avenida

Respuesta (fragmento):

{
  "calles": [
    {
      "id": "9007701000050",
      "nombre": "AV GRL SAVIO",
      "categoria": "AV",
      "nomenclatura": "AV GRL SAVIO, Río Chico, Tucumán",
      "provincia": { "id": "90", "nombre": "Tucumán" },
      "departamento": { "id": "90077", "nombre": "Río Chico" },
      "localidad_censal": { "id": "90077010", "nombre": "Aguilares" }
    },
    ...
  ],
  "cantidad": 3,
  "total": 3
}

Estos ejemplos pueden ejecutarse directamente desde un navegador web o incorporarse en desarrollos propios. Se recomienda siempre revisar los parámetros disponibles y ajustar el filtro max cuando se espera una gran cantidad de resultados.