Autocompletado de direcciones

Sugerencias para entradas parciales, optimizadas para la latencia y la tolerancia a errores tipográficos. Cada sugerencia incluye coordenadas, así que la mayoría de las integraciones nunca necesitan una segunda llamada.

Parámetros

Ejemplo

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/autocomplete?q=oxford+st&proximity=51.515,-0.141&limit=3"

const url = new URL("https://api.mygeocode.com/v1/autocomplete");
url.searchParams.set("q", "oxford st");
url.searchParams.set("proximity", "51.515,-0.141");
url.searchParams.set("limit", "3");

const { suggestions } = await (await fetch(url, { headers: { "X-API-Key": "YOUR_KEY" } })).json();
suggestions.forEach((s) => console.log(s.text, s.lat, s.lon));

import requests

r = requests.get("https://api.mygeocode.com/v1/autocomplete",
                 params={"q": "oxford st", "proximity": "51.515,-0.141", "limit": 3}, headers={"X-API-Key": "YOUR_KEY"}, timeout=5)
for s in r.json()["suggestions"]:
    print(s["text"], s["lat"], s["lon"])

{
  "status": "ok",
  "query": "oxford st",
  "suggestions": [
    { "text": "Oxford Street, London W1, United Kingdom", "lat": 51.515419, "lon": -0.141588, "type": "street", "precision": "street", "place_id": "gb.street.0a91e2c4" },
    { "text": "Oxford Street, Southampton SO14, United Kingdom", "lat": 50.899021, "lon": -1.399537, "type": "street", "precision": "street", "place_id": "gb.street.77b4d1f0" },
    { "text": "Oxford Street Station, London W1, United Kingdom", "lat": 51.515167, "lon": -0.141251, "type": "poi", "precision": "house", "place_id": "gb.poi.3c5a8e19" }
  ]
}

Campos de la respuesta

Notas

• Aplica un debounce a la entrada de unos 150 ms y cancela las solicitudes en curso cuando el usuario siga escribiendo. Las respuestas incluyen la query a la que responden, así que puedes descartar las obsoletas.
• No hay tokens de sesión. Cada llamada es una solicitud. Elegir una dirección típica lleva de 4 a 6 llamadas.
• Llamar desde el navegador en el nivel gratuito es el uso previsto para sitios públicos. Se cuenta la IP del visitante, no la tuya.
• Los formatos del widget places.Autocomplete de Google, Mapbox Search Box, HERE Autosuggest y Bing Autosuggest están disponibles en los hosts compatibles (drop-in).

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.

Errores

400 invalid_request cuando q tiene menos de 2 caracteres, o types contiene un valor desconocido.