6.3. Reverse Geocode

Owned by Eduardo Nakamura (Unlicensed)
Last updated: Feb 17, 2023 by Willian Silva
8 min read

Construindo requisições para Reverse Geocode API

O objetivo desse segundo endpoint, Reverse Geocode, é retornar informações sobre o endereço a partir de suas coordenadas.

Para realizar a requisição para a Reverse Geocode é necessário enviar a requisição usando o método POST para o seguinte endpoint: 

Parâmetros da requisição

Parâmetros obrigatórios

  • lat - Latitude;

  • lon - Longitude.

Parâmetros opcionais

  • id - Texto com o identificador;

  • distance - Distância máxima em metros para a busca do endereço.

Há o limite de 200 pontos para o envio em uma mesma requisição

Exemplo 1 - Busca do endereço a partir da coordenada

Na requisição abaixo, queremos descobrir a qual endereço pertence essas coordenadas:

[ { "lat": -23.566617861455924, "lon": -46.65362331449377 } ]

A resposta irá conter as seguintes informações:

  • found - Quantidade de registros encontrados.

  • results - Resultados encontrados:

    • id - Identificador do processamento;

    • address - Endereço:

      • road - Nome da via;

      • district - Bairro;

      • zipCode - CEP;

      • city - Cidade;

      • state - Estado;

      • mainLocation - Coordenadas geográficas em latitude/longitude;

    • type - Indica qual o melhor elemento encontrado na base cartográfica para o retorno da coordenada geográfica;

    • score - Pontuação de referência do resultado do processo de geocodificação;

    • distance - Distância em metros em relação à coordenada enviada.

  • label - Endereço completo encontrado utilizado no processo de geocodificação.

 

A resposta completa pode ser conferida abaixo:

{ "found": 1, "results": [ { "id": "1034bf0c-8d7a-474c-8eb1-6a0108882054", "address": { "road": "Alameda Campinas", "district": "Jardim Paulista", "zipCode": "01404000", "city": "São Paulo", "state": { "code": "SP", "name": "São Paulo" }, "mainLocation": { "lat": -23.5665, "lon": -46.65382 } }, "type": "ZIPCODE", "score": 9976.046, "distance": 23.95446729752212, "label": "Alameda Campinas, Jardim Paulista, 01404000, São Paulo, São Paulo, SP" } ] }

 

Nota: Quanto maior o score, maior será a relevância do resultado para o endereço solicitado.

Exemplo 2 - Busca do endereço a partir de mais de uma coordenada

Neste exemplo, o ponto “L1” deverá retornar resultados em um raio de 25 metros de distância. Para isso usaremos o parâmetro distance:

[ { "id": "L1", "lat": -26.90314282963394, "lon": -48.68018153051618, "distance": 25 }, { "id": "L2", "lat": -26.908620508271895, "lon": -48.67848497677373 } ]

A resposta completa pode ser conferida abaixo: