API de geocodificación inversa
Envía una latitud y una longitud y obtén la dirección más cercana, con la calle, la ciudad, la región, el código postal y el país desglosados, además de la distancia entre la dirección y el punto que enviaste. Pide una respuesta menos detallada con level cuando solo quieras la ciudad o el país.
Ejemplo
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/reverse?lat=48.8584&lon=2.2945"El punto está a pocos metros de la base de la Torre Eiffel. La respuesta es la dirección postal más cercana, y distance_m te indica que está a 12 metros. Si la dirección más cercana estuviera a 400 metros, por ejemplo desde un punto en un parque, también lo verías y podrías decidir mostrar el barrio en su lugar.
Añade level=city para saltarte la dirección y obtener directamente la localidad, o level=country para una consulta rápida del 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"
}
}
}Qué recibes
| Campo | Significado |
|---|---|
result.formatted | La dirección más cercana en el formato de ese país. |
result.lat, result.lon | La posición de la propia dirección, no la del punto que enviaste. |
result.distance_m | Metros entre tu punto y la dirección. Un número alto significa que en realidad no estás en una dirección. |
result.precision | house, street, postcode o admin, según lo que exista cerca del punto en ese país. |
result.components | Partes de la dirección con las mismas claves que en la geocodificación directa. |
result es null | No hay nada a menos de 5 km del punto. Mar abierto, la Antártida. El estado sigue siendo ok. |
Dónde se usa
Etiquetar puntos GPS
Convierte la ubicación de un dispositivo en "cerca de 5 Avenue Anatole France" para un registro, un recibo o el pie de una foto. Usa distance_m para alternar entre "en" y "cerca de".
Valores predeterminados locales
Rellena de antemano un país, una moneda o un idioma a partir de la ubicación del visitante con level=country. Combínalo con la consulta de IP cuando no tengas coordenadas.
Entregas y trabajo de campo
Convierte el lugar donde un conductor se detuvo realmente en una dirección y compáralo con el destino que indicaba el pedido.
Precio y límites
Una llamada, una solicitud. Cada clave tiene 2.500 solicitudes gratuitas al día; a partir de ahí, 0,0001 € cada una del crédito prepago, o nada con una clave Unlimited (50 € al mes). Precios. Los hosts compatibles responden a las solicitudes inversas en los formatos de Google, Nominatim, Mapbox y otros.