| 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 a requisição para utilizar 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 buscar, 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.62686que 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:
...