Pular para o conteúdo
POST AI agent ready /v1/address/autocomplete

API de preenchimento automático de endereço - sugestões de endereço gratuitas

Envie uma consulta parcial de endereço e receba até 10 sugestões de endereços estruturados com ruas, cidades, estados, países e coordenadas GPS. Projetado para campos de endereço de pesquisa conforme você digita. Suporta preferência 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

Crie campos de endereço de pesquisa conforme você digita

Conecte esse endpoint a um campo de entrada com solicitações rejeitadas. Mostre uma lista suspensa de endereços correspondentes conforme o usuário digita. Quando eles selecionam um, preencha os campos de rua, cidade, estado e CEP automaticamente.

Reduza erros de formulário no checkout móvel

Os usuários de dispositivos móveis cometem mais erros de digitação do que os usuários de desktop. As sugestões de preenchimento automático permitem que eles toquem no endereço correto em vez de digitá-lo completamente, reduzindo o tempo de preenchimento do formulário e as taxas de erro.

Potencialize a pesquisa de localização em aplicativos de mapeamento

Use o preenchimento automático para permitir que os usuários pesquisem lugares por nome ou endereço. Cada sugestão inclui coordenadas, para que você possa centralizar o mapa no resultado selecionado sem uma chamada de geocodificação separada.

Frequently asked questions

Quantas sugestões posso solicitar?
Defina o parâmetro limite entre 1 e 10. O padrão é 5. A API retorna no máximo o número de resultados correspondentes encontrados, que pode ser menor que o limite.
Quais idiomas são suportados?
Passe qualquer código de idioma ISO 639-1 (por exemplo, "de" para alemão, "ja" para japonês). Os resultados são retornados no idioma solicitado quando há traduções disponíveis. Caso contrário, volta para o idioma local.
Existe um comprimento mínimo de consulta?
A consulta deve ter pelo menos um caractere que não seja um espaço em branco. Consultas mais curtas retornam resultados mais amplos. Para melhores sugestões, envie pelo menos 3-4 caracteres.
Isso funciona para nomes comerciais ou endereços?
Funciona para ambos. O geocodificador corresponde a endereços, bairros, cidades e locais nomeados. Os nomes comerciais podem ou não corresponder, dependendo da cobertura do banco de dados de mapeamento.
Qual é o tempo de resposta?
Os tempos de resposta típicos são de 100 a 300 ms, dependendo da carga do serviço de geocodificação. Para uma experiência de digitação suave, debounce solicitações para disparar 150-200 ms depois que o usuário parar de digitar.

Get your API key

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

Sign up free View full docs