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.