API de autocompletado de direcciones
Sugiere direcciones, calles, ciudades y lugares mientras alguien escribe. Cada sugerencia lleva sus propias coordenadas y su precisión, así que cuando el usuario elige una ya tienes todo lo que necesitas. Sin tokens de sesión, sin llamada aparte para los detalles, sin precios por sesión.
Ejemplo
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/autocomplete?q=10+Downing&country=gb&limit=3"Las respuestas están ajustadas para la escritura: llegan en unas pocas decenas de milisegundos y toleran letras que faltan y palabras intercambiadas. Envía proximity=lat,lon para dar prioridad a los lugares cercanos, algo muy importante con nombres de calles que existen en muchas localidades.
Aplica debounce a las pulsaciones de teclas de unos 150 ms. Elegir una dirección típica lleva de 4 a 6 solicitudes.
{
"status": "ok",
"query": "10 Downing",
"suggestions": [
{
"text": "10 Downing Street, London SW1A 2AA, United Kingdom",
"lat": 51.503396,
"lon": -0.12764,
"type": "address",
"precision": "house",
"place_id": "gb.addr.7f3c2a19"
},
{
"text": "10 Downing Place, Cambridge CB2 3EN, United Kingdom",
"lat": 52.203042,
"lon": 0.121811,
"type": "address",
"precision": "house",
"place_id": "gb.addr.a01d9e44"
},
{
"text": "10 Downing Road, Dagenham RM9 6NP, United Kingdom",
"lat": 51.536118,
"lon": 0.137204,
"type": "address",
"precision": "house",
"place_id": "gb.addr.c58b7e02"
}
]
}Qué recibes
| Campo | Significado |
|---|---|
text | La sugerencia tal como debe mostrarse, en una línea. |
lat, lon | Coordenadas de la sugerencia. Presentes en todas las sugerencias. |
type | address, street, postcode, city, region, country o poi. |
precision | Los mismos cuatro valores que en la geocodificación. |
place_id | Un identificador estable. Pásalo a /v1/forward?place_id=... si quieres los componentes completos y los límites de la sugerencia elegida. |
Dónde se usa
Formularios de dirección en el proceso de pago
Un campo en lugar de seis. El place_id de la sugerencia elegida obtiene los componentes para rellenar el resto del formulario.
Cuadros de búsqueda en mapas
Pasa el centro del mapa como proximity para que "Calle Mayor" sea la que aparece en pantalla.
Reemplazar Places Autocomplete
El reemplazo compatible de Google Maps JavaScript ofrece google.maps.places.Autocomplete respaldado por este endpoint, sin precios por sesión.
Precio y límites
Cada llamada es una solicitud. No hay precios por sesión ni cargo aparte por elegir una sugerencia. Cada clave tiene 2.500 solicitudes gratuitas al día; a partir de ahí, 0,0001 € cada una del crédito prepago, o nada con una clave Unlimited (50 € al mes). Precios.