Table of Contents |
---|
...
O objetivo desse terceiro endpoint, Suggestions, é retornar as coordenadas geográficas a partir de um endereço fornecido na própria URL.
Para realizar utilizar a requisição para a Suggestions é API será necessário enviar a requisição usando o método GET para o seguinte endpoint:
Na própria URL serão enviados todos os parâmetros para obter a coordenada geográfica as coordenadas geográficas e sugestões de endereços.
...
type
- Limita o tipo da pesquisa. Valores possíveis:ZIPCODE - CEP;
STATE
- Estado;CITY
- Cidade;POI
- Pedágios (Até a data deste documento 10/02/2023atual);DISTRICT
- Bairro.
center
- Coordenadas de referência para a busca de resultados. Formato:center=-23.552088765,-46.6341653162
;radius
- Especifica o raio de buscarbusca, em metros, a partir do ponto central. Caso não seja informado, o valor padrão é 5.000.000 metros (5.000 Km).
...
Info |
---|
Nota: Quanto maior o score, maior será a relevância do resultado para o endereço solicitado. |
Exemplo 2 - Busca de sugestões a partir de texto livre
...
q
- Texto com o endereço que queremos buscar, “Alameda Campinas, 01404100, Jardim Paulista;center
- Ponto central do nosso raio, no caso serão as coordenadas-23.538379,-46.62686
que correspondem ao centro da cidade de São Paulo;radius
- Tamanho do raio de busca, no caso será 10000 metros, ou 10 quilômetros.
Na resposta, podemos observar que a quantidade de endereços retornados diminui de 11 para 9, restringindo os resultados apenas para a cidade de São Paulo:
...