API de géocodage inverse
Envoyez une latitude et une longitude et obtenez l'adresse la plus proche, avec la rue, la ville, la région, le code postal et le pays détaillés, ainsi que la distance entre l'adresse et le point envoyé. Demandez une réponse moins détaillée avec level lorsque vous ne voulez que la ville ou le pays.
Exemple
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/reverse?lat=48.8584&lon=2.2945"Le point se trouve à quelques mètres du pied de la tour Eiffel. La réponse est l'adresse postale la plus proche, et distance_m vous indique qu'elle est à 12 mètres. Si l'adresse la plus proche était à 400 mètres, par exemple depuis un point situé dans un parc, vous le verriez aussi et pourriez décider d'afficher plutôt le quartier.
Ajoutez level=city pour ignorer l'adresse et obtenir directement la localité, ou level=country pour une recherche rapide du pays.
{
"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"
}
}
}Ce que vous recevez
| Champ | Signification |
|---|---|
result.formatted | L'adresse la plus proche, au format du pays. |
result.lat, result.lon | La position de l'adresse elle-même, et non du point envoyé. |
result.distance_m | Mètres entre votre point et l'adresse. Un nombre élevé signifie que vous ne vous trouvez pas vraiment à une adresse. |
result.precision | house, street, postcode ou admin, selon ce qui existe près du point dans ce pays. |
result.components | Éléments de l'adresse, avec les mêmes clés que pour le géocodage direct. |
result vaut null | Rien dans un rayon de 5 km autour du point. Haute mer, Antarctique. Le statut reste ok. |
Où elle est utilisée
Nommer des points GPS
Transformez la position d'un appareil en « près du 5 avenue Anatole France » pour un journal, un reçu ou une légende de photo. Utilisez distance_m pour choisir entre « au » et « près du ».
Valeurs par défaut locales
Préremplissez un pays, une devise ou une langue à partir de la position du visiteur avec level=country. Associez-le à la recherche d'IP lorsque vous n'avez pas de coordonnées.
Livraison et interventions terrain
Convertissez l'endroit où un chauffeur s'est réellement arrêté en adresse et comparez-le avec la destination indiquée dans la commande.
Prix et limites
Un appel, une requête. Chaque clé dispose de 2 500 requêtes gratuites par jour ; au-delà, 0,0001 € par requête sur le crédit prépayé, ou rien avec une clé Unlimited (50 € par mois). Tarifs. Les hôtes compatibles (drop-in) répondent aux requêtes inverses aux formats Google, Nominatim, Mapbox et d'autres formats.