6.3. Reverse Geocode
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: