Guia técnico · JavaScript
Autocomplete de endereços em JavaScript
Chamada no backend
A API key não deve ir para o navegador. Faça a busca pelo seu backend e devolva apenas os campos necessários ao componente de autocomplete.
const response = await fetch('/seu-backend/autocomplete?q=Avenida%20Pau');
if (!response.ok) throw new Error('Não foi possível carregar sugestões');
const suggestions = await response.json(); Experiência do campo
Aplique debounce, exija pelo menos dois caracteres, mostre estado vazio e permita preenchimento manual. O endpoint oficial usado pelo backend é /api/v1/autocomplete.