API de preenchimento automático de endereços
Sugira endereços, ruas, cidades e lugares enquanto alguém digita. Cada sugestão traz suas próprias coordenadas e precisão, então, quando o usuário escolhe uma, você já tem tudo de que precisa. Sem tokens de sessão, sem chamada separada de detalhes, sem cobrança por sessão.
Exemplo
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/autocomplete?q=10+Downing&country=gb&limit=3"As respostas são ajustadas para a digitação: voltam em algumas dezenas de milissegundos e toleram letras faltando e palavras trocadas. Envie proximity=lat,lon para classificar primeiro os lugares próximos, o que faz muita diferença para nomes de ruas que existem em muitas cidades.
Aplique debounce às teclas em cerca de 150 ms. Um endereço típico leva de 4 a 6 requisições para ser escolhido.
{
"status": "ok",
"query": "10 Downing",
"suggestions": [
{
"text": "10 Downing Street, London SW1A 2AA, United Kingdom",
"lat": 51.503396,
"lon": -0.12764,
"type": "address",
"precision": "house",
"place_id": "gb.addr.7f3c2a19"
},
{
"text": "10 Downing Place, Cambridge CB2 3EN, United Kingdom",
"lat": 52.203042,
"lon": 0.121811,
"type": "address",
"precision": "house",
"place_id": "gb.addr.a01d9e44"
},
{
"text": "10 Downing Road, Dagenham RM9 6NP, United Kingdom",
"lat": 51.536118,
"lon": 0.137204,
"type": "address",
"precision": "house",
"place_id": "gb.addr.c58b7e02"
}
]
}O que você recebe
| Campo | Significado |
|---|---|
text | A sugestão como deve ser exibida, em uma linha. |
lat, lon | Coordenadas da sugestão. Presentes em todas as sugestões. |
type | address, street, postcode, city, region, country ou poi. |
precision | Os mesmos quatro valores da geocodificação. |
place_id | Um identificador estável. Passe-o para /v1/forward?place_id=... se quiser os componentes completos e os limites da sugestão escolhida. |
Onde é usada
Formulários de endereço no checkout
Um campo em vez de seis. O place_id da sugestão escolhida busca os componentes para preencher o restante do formulário.
Caixas de busca em mapas
Passe o centro do mapa como proximity para que "Rua Principal" signifique a que está na tela.
Substituindo o Places Autocomplete
O substituto compatível do Google Maps JavaScript oferece google.maps.places.Autocomplete atendido por este endpoint, sem cobrança por sessão.
Preço e limites
Cada chamada é uma requisição. Não há cobrança por sessão nem cobrança separada por escolher uma sugestão. Toda chave tem 2.500 requisições gratuitas por dia; depois disso, € 0,0001 cada uma do crédito pré-pago, ou nada em uma chave Unlimited (€ 50 por mês). Preços.