El autocompletado de direcciones es un tipo de solicitud distinto de una consulta de geocodificación directa: tiene que responder a una entrada parcial y cambiante en lugar de a una única dirección terminada, normalmente mientras alguien escribe en un formulario. Hemos ampliado nuestros hosts compatibles para admitir también este patrón, con la misma estructura de solicitud de autocompletado de los proveedores que lo ofrecen.
Esto se suma a nuestro endpoint nativo /v1/autocomplete, documentado en /docs/address-autocomplete/, que gestiona directamente el mismo tipo de solicitud de dirección parcial. Siempre que el proveedor original de un host compatible también ofrezca autocompletado, esa misma estructura de solicitud ahora es compatible en nuestro host equivalente, salvo los textos de copyright, términos y privacidad, que son los nuestros.
La autenticación y los precios de las solicitudes de autocompletado siguen exactamente las mismas reglas que cualquier otro tipo de solicitud de la plataforma. Una clave se autentica como cabecera X-API-Key, como cabecera Authorization: Bearer, con autenticación HTTP Basic o como parámetro de consulta, y el uso cuenta contra la misma cuota diaria gratuita, tanto si esa cuota procede de la red que llama como de la propia clave. Por encima de la cuota gratuita, las solicitudes de autocompletado se descuentan del crédito prepago a 0,0001 € por solicitud o quedan cubiertas por un paquete Unlimited, exactamente igual que cualquier otro endpoint.
El tráfico de autocompletado suele ir a un ritmo distinto del de una consulta de geocodificación típica, ya que a menudo se lanza con cada pulsación de tecla mientras alguien escribe una dirección en un formulario, en lugar de una vez por envío terminado. Eso hace que la visibilidad de la cuota sea especialmente útil aquí: las mismas cabeceras de cuota incluidas en cada respuesta, X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining y las demás, permiten a una integración vigilar el consumo en tiempo real y ajustar su comportamiento, por ejemplo aplicando un debounce más agresivo a las solicitudes, si el uso es mayor de lo esperado.
Para los equipos que ya usan un host compatible para la geocodificación y gestionan el autocompletado por separado con otro proveedor o una segunda integración, esta actualización significa que el autocompletado ahora puede pasar al mismo host y a la misma clave, reuniendo ambos tipos de solicitud en una sola cuenta en lugar de repartirlos entre dos.
Qué hosts compatibles admiten autocompletado depende de si su proveedor original lo hace, y los detalles de cada uno están documentados en la página de ese host, a la que se llega desde la lista completa en /compatibility/. Probar el autocompletado con un host compatible no cuesta nada, gracias a la cuota gratuita disponible para cualquier clave nueva.