Ir al contenido
POST AI agent ready /v1/address/autocomplete

API de autocompletar de direcciones: sugerencias de direcciones gratuitas

Envíe una consulta de dirección parcial y obtenga hasta 10 sugerencias de direcciones estructuradas con calle, ciudad, estado, país y coordenadas GPS. Diseñado para buscar campos de dirección a medida que escribe. Admite preferencia de idioma para resultados localizados.

Parameters

stringrequired

Partial address to autocomplete.

number

Max suggestions to return (1-10).

string

ISO 639-1 language code for results.

Code examples

curl -X POST https://api.botoi.com/v1/address/autocomplete \
  -H "Content-Type: application/json" \
  -d '{"query":"1600 Amphithea","limit":3,"lang":"en"}'

When to use this API

Cree campos de dirección de búsqueda a medida que escribe

Conecte este punto final a un campo de entrada con solicitudes rechazadas. Muestra un menú desplegable de direcciones coincidentes a medida que el usuario escribe. Cuando seleccionan uno, completan automáticamente los campos de calle, ciudad, estado y código postal.

Reduzca los errores de formulario en el pago móvil

Los usuarios de dispositivos móviles cometen más errores tipográficos que los usuarios de computadoras de escritorio. Las sugerencias de autocompletar les permiten tocar la dirección correcta en lugar de escribirla completa, lo que reduce el tiempo de finalización del formulario y las tasas de error.

Búsqueda de ubicación de energía en aplicaciones de mapeo

Utilice la función de autocompletar para permitir a los usuarios buscar lugares por nombre o dirección. Cada sugerencia incluye coordenadas, por lo que puede centrar el mapa en el resultado seleccionado sin una llamada de geocodificación por separado.

Frequently asked questions

¿Cuántas sugerencias puedo solicitar?
Establezca el parámetro de límite entre 1 y 10. El valor predeterminado es 5. La API devuelve como máximo la cantidad de resultados coincidentes encontrados, que puede ser menor que el límite.
¿Qué idiomas son compatibles?
Pase cualquier código de idioma ISO 639-1 (por ejemplo, "de" para alemán, "ja" para japonés). Los resultados se devuelven en el idioma solicitado cuando hay traducciones disponibles. De lo contrario, vuelve al idioma local.
¿Existe una longitud mínima de consulta?
La consulta debe tener al menos un carácter que no sea un espacio en blanco. Las consultas más breves arrojan resultados más amplios. Para obtener mejores sugerencias, envíe al menos 3 o 4 caracteres.
¿Esto funciona para nombres comerciales o direcciones postales?
Funciona para ambos. El geocodificador compara direcciones de calles, barrios, ciudades y lugares con nombre. Los nombres comerciales pueden coincidir o no según la cobertura de la base de datos cartográfica.
¿Cuál es el tiempo de respuesta?
Los tiempos de respuesta típicos son de 100 a 300 ms, según la carga del servicio de codificación geográfica. Para una experiencia de escritura anticipada fluida, las solicitudes de rebote se activan entre 150 y 200 ms después de que el usuario deja de escribir.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.