Geocodificación directa

Convierte texto en coordenadas. Acepta direcciones completas, direcciones parciales, códigos postales, nombres de lugares y puntos de interés, en cualquier idioma.

Parámetros

Ejemplo

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/forward?q=Dam+1,+Amsterdam&countries=nl&limit=1"

const url = new URL("https://api.mygeocode.com/v1/forward");
url.searchParams.set("q", "Dam 1, Amsterdam");
url.searchParams.set("countries", "nl");
url.searchParams.set("limit", "1");

const data = await (await fetch(url, { headers: { "X-API-Key": "YOUR_KEY" } })).json();
console.log(data.results[0]);

import requests

r = requests.get("https://api.mygeocode.com/v1/forward",
                 params={"q": "Dam 1, Amsterdam", "countries": "nl", "limit": 1}, headers={"X-API-Key": "YOUR_KEY"}, timeout=10)
print(r.json()["results"][0])

{
  "status": "ok",
  "query": "Dam 1, Amsterdam",
  "results": [
    {
      "formatted": "Dam 1, 1012 JS Amsterdam, Netherlands",
      "lat": 52.373119,
      "lon": 4.893604,
      "type": "address",
      "precision": "house",
      "confidence": 0.98,
      "place_id": "nl.addr.c21d40e8",
      "components": {
        "house_number": "1",
        "road": "Dam",
        "neighbourhood": "Centrum",
        "city": "Amsterdam",
        "state": "North Holland",
        "state_code": "NH",
        "postcode": "1012 JS",
        "country": "Netherlands",
        "country_code": "nl"
      },
      "bounds": { "north": 52.373519, "south": 52.372719, "east": 4.894204, "west": 4.893004 }
    }
  ]
}

Campos de la respuesta

Claves de los componentes

Solo aparecen las claves que corresponden. Se usan las mismas claves en todos los países.

Notas

• Los resultados se ordenan por una combinación de confianza, precisión y proximidad. El primer resultado es el que debes usar, salvo que muestres un selector.
• Cuando no se encuentra un número de casa en una calle conocida, el resultado tiene type: street y precision: street, con el número interpolado donde los datos lo permiten. Revisa precision si eso te importa.
• Los códigos postales solos sirven como q. Para cargas de trabajo solo con códigos postales, el endpoint de códigos postales es más rápido y devuelve el nombre del lugar según la autoridad postal.
• Una consulta en un alfabeto para un lugar que usa otro (en cirílico para una dirección japonesa, por ejemplo) funciona, pero lang decide el alfabeto de la respuesta.

La misma consulta en los formatos de otros proveedores

Si ya tienes código escrito para uno de estos proveedores, consérvalo: el host compatible acepta la misma ruta y los mismos parámetros y responde con la estructura de respuesta de ese proveedor, con este endpoint detrás. Consulta cómo funcionan los hosts compatibles.

Consultas masivas

Envía por POST un cuerpo JSON a la misma ruta con queries, un array de hasta 100 direcciones, y la respuesta incluye un array results con una entrada por consulta en el orden enviado. Cada entrada cuenta como una solicitud, y un lote mayor que lo que queda de la cuota se rechaza entero.

$ curl -X POST "https://api.mygeocode.com/v1/forward" -H "Content-Type: application/json" -d '{"queries": ["Brandenburg Gate, Berlin", "Bahnhofstrasse 1, Zurich"]}'

Errores

400 invalid_request cuando no hay q, ni un campo estructurado ni place_id, cuando limit está fuera del rango de 1 a 10, o cuando bounds o proximity están mal formados. Consulta errores para el resto.