¡Acá Vamos!

API en JSON

Accede a esta página con el header Accept: application/json para obtener la respuesta en JSON. Por ejemplo:

$ curl -H "Accept: application/json" -G "http://acavamos.com/geocode?address=Juan+Carlos+Gómez+1362"
  {
    "response_code": "200",
    "results": [{
      "latitude":      -34.9066,
      "longitude":     -56.20291,
      "addresses":     ["Juan Carlos Gómez 1362"]
    }]
  }

Cuando se encuentre la dirección en la base de datos el API retornará response_code: 200. Si la dirección no se encuentra, entonces se retornará response_code: 404 (y una lista vacía de results.)

La lista addresses contiene un listado de todos los padrones cuyo centroide se situe en esas coordenadas.

Si los datos son ambiguos, y se encuentran muchos puntos con una dirección similar a la provista, se retornará response_code: 300, y varios valores en la lista results. Por ejemplo:

$ curl -H "Accept: application/json" -G "http://acavamos.com/geocode?address=18+de+julio+1360"
  {
    "response_code": "300",
    "results": [{
      "latitude":  -34.90282,
      "longitude": -56.1869,
      "addresses": ["Avenida Uruguay 1360", "Avenida Uruguay 1364"]
    }, {
      "latitude":  -34.9057,
      "longitude": -56.18617,
      "addresses": ["Avenida 18 de Julio 1360", "Avenida 18 de Julio 1374", "Avenida 18 de Julio 1384"]
    }]
  }

Mapas Embebibles

Accede a la URL http://acavamos.com/geocode?address=Juan+Carlos+Gómez+1362 para obtener el mapa como imagen estática.

Si la dirección es ambigua (response_code: 300 en el API JSON) se retornará un cuerpo vacío con un código HTTP 300. Si la dirección no se encuentra en la base de datos, se retornará un cuerpo vacío con un código HTTP 404.

Puedes configurar el mapa con los siguientes parámetros en la URL:

size

Una cadena de la forma ANCHOxLARGO, por ejemplo size=500x600.

Si solo especificas un valor, la imagen será cuadrada: size=340

Ejemplo: http://acavamos.com/geocode/map.png?address=Juan+Carlos+Gómez+1362&size=500x600

Valor por omisión: 400x300

zoom

Un número entre 1 y 18, por ejemplo zoom=13.

Ejemplo: http://acavamos.com/geocode/map.png?address=Juan+Carlos+Gómez+1362&zoom=13

Valor por omisión: 16