API de geocodificação reversa
Envie uma latitude e uma longitude e receba o endereço mais próximo, com rua, cidade, região, código postal e país separados, além da distância entre o endereço e o ponto que você enviou. Peça uma resposta menos detalhada com level quando quiser apenas a cidade ou o país.
Exemplo
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/reverse?lat=48.8584&lon=2.2945"O ponto fica a poucos metros da base da Torre Eiffel. A resposta é o endereço postal mais próximo, e distance_m informa que ele está a 12 metros. Se o endereço mais próximo estivesse a 400 metros, por exemplo a partir de um ponto em um parque, você também veria isso e poderia decidir mostrar o bairro.
Adicione level=city para pular o endereço e obter a localidade diretamente, ou level=country para uma consulta rápida de país.
{
"status": "ok",
"lat": 48.8584,
"lon": 2.2945,
"result": {
"formatted": "5 Avenue Anatole France, 75007 Paris, France",
"lat": 48.85837,
"lon": 2.29448,
"distance_m": 12,
"type": "address",
"precision": "house",
"components": {
"house_number": "5",
"road": "Avenue Anatole France",
"suburb": "7th Arrondissement",
"city": "Paris",
"state": "Ile-de-France",
"postcode": "75007",
"country": "France",
"country_code": "fr"
}
}
}O que você recebe
| Campo | Significado |
|---|---|
result.formatted | O endereço mais próximo no formato daquele país. |
result.lat, result.lon | A posição do próprio endereço, não o ponto que você enviou. |
result.distance_m | Metros entre o seu ponto e o endereço. Um número alto significa que você não está exatamente em um endereço. |
result.precision | house, street, postcode ou admin, dependendo do que existe perto do ponto naquele país. |
result.components | Partes do endereço com as mesmas chaves da geocodificação direta. |
result é null | Nada em um raio de 5 km do ponto. Mar aberto, Antártida. O status continua sendo ok. |
Onde é usada
Rotular pontos de GPS
Transforme a localização de um dispositivo em "perto de 5 Avenue Anatole France" para um log, um recibo ou a legenda de uma foto. Use distance_m para alternar entre "em" e "perto de".
Padrões locais
Preencha previamente um país, uma moeda ou um idioma a partir da localização do visitante com level=country. Combine com a consulta de IP quando você não tiver coordenadas.
Entregas e trabalho de campo
Converta o local onde um motorista realmente parou em um endereço e compare-o com o destino indicado no pedido.
Preço e limites
Uma chamada, uma requisição. Toda chave tem 2.500 requisições gratuitas por dia; acima disso, € 0,0001 cada uma a partir do crédito pré-pago, ou nada em uma chave Unlimited (€ 50 por mês). Preços. Hosts compatíveis (drop-in) respondem a requisições reversas nos formatos do Google, do Nominatim, do Mapbox e outros.