L'API Geocoding est un service qui fournit le geocoding et le geocoding inversé des adresses.
Le geocoding consiste à convertir des adresses (comme une adresse postale) en coordonnées géographiques (comme la latitude et la longitude), que vous pouvez utiliser pour placer des repères sur une carte ou pour positionner celle-ci.
Le geocoding inversé consiste à convertir des coordonnées géographiques en adresses lisibles par l'humain.
Vous pouvez également utiliser l'API Geocoding pour trouver l'adresse correspondant à un ID de lieu donné.
Exemple de requête et de réponse
Vous accédez à l'API Geocoding via une interface HTTP. Voici des exemples de requêtes de géocodage et de géocodage inversé.
Requête de géocodage et réponse (recherche de latitude/longitude)
L'exemple suivant demande la latitude et la longitude de "1600 Amphitheatre Parkway, Mountain View, CA", et précise que la sortie doit être au format JSON.
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
Pour tester cela, saisissez l'URL dans votre navigateur Web (veillez à remplacer YOUR_API_KEY par votre clé API réelle).
La réponse inclut la latitude et la longitude de l'adresse.
Pour en savoir plus sur la création d'URL de requête de géocodage, les paramètres disponibles et la compréhension de la réponse, consultez le guide du développeur.
Un exemple de réponse à une requête de géocodage est fourni ci-dessous, au format JSON :
{ "results" : [ { "address_components" : [ { "long_name" : "1600", "short_name" : "1600", "types" : [ "street_number" ] }, { "long_name" : "Amphitheatre Parkway", "short_name" : "Amphitheatre Pkwy", "types" : [ "route" ] }, { "long_name" : "Mountain View", "short_name" : "Mountain View", "types" : [ "locality", "political" ] }, { "long_name" : "Santa Clara County", "short_name" : "Santa Clara County", "types" : [ "administrative_area_level_2", "political" ] }, { "long_name" : "California", "short_name" : "CA", "types" : [ "administrative_area_level_1", "political" ] }, { "long_name" : "United States", "short_name" : "US", "types" : [ "country", "political" ] }, { "long_name" : "94043", "short_name" : "94043", "types" : [ "postal_code" ] } ], "formatted_address" : "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "geometry" : { "location" : { "lat" : 37.4267861, "lng" : -122.0806032 }, "location_type" : "ROOFTOP", "viewport" : { "northeast" : { "lat" : 37.4281350802915, "lng" : -122.0792542197085 }, "southwest" : { "lat" : 37.4254371197085, "lng" : -122.0819521802915 } } }, "place_id" : "ChIJtYuu0V25j4ARwu5e4wwRYgE", "plus_code" : { "compound_code" : "CWC8+R3 Mountain View, California, United States", "global_code" : "849VCWC8+R3" }, "types" : [ "street_address" ] } ], "status" : "OK" }
Requête de géocodage inversé et réponse (recherche d'une adresse)
L'exemple suivant demande l'adresse correspondant à une latitude/longitude donnée à Brooklyn, NY, États-Unis. Il indique également que la réponse doit être au format JSON.
https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEYPour tester cela, saisissez l'URL dans votre navigateur Web (veillez à remplacer "YOUR_API_KEY" par votre clé API réelle). La réponse inclut une adresse lisible par l'humain pour la latitude et la longitude.
Pour en savoir plus sur la création d'URL de requête de géocodage inversé, les paramètres disponibles et la compréhension de la réponse, consultez le guide du développeur.
Un exemple de réponse à une requête de géocodage inversé est fourni ci-dessous, au format JSON :
{ "plus_code" : { "compound_code" : "P27Q+MC New York, NY, USA", "global_code" : "87G8P27Q+MC" }, "results" : [ { "address_components" : [ { "long_name" : "279", "short_name" : "279", "types" : [ "street_number" ] }, { "long_name" : "Bedford Avenue", "short_name" : "Bedford Ave", "types" : [ "route" ] }, { "long_name" : "Williamsburg", "short_name" : "Williamsburg", "types" : [ "neighborhood", "political" ] }, { "long_name" : "Brooklyn", "short_name" : "Brooklyn", "types" : [ "political", "sublocality", "sublocality_level_1" ] }, { "long_name" : "Kings County", "short_name" : "Kings County", "types" : [ "administrative_area_level_2", "political" ] }, { "long_name" : "New York", "short_name" : "NY", "types" : [ "administrative_area_level_1", "political" ] }, { "long_name" : "United States", "short_name" : "US", "types" : [ "country", "political" ] }, { "long_name" : "11211", "short_name" : "11211", "types" : [ "postal_code" ] } ], "formatted_address" : "279 Bedford Ave, Brooklyn, NY 11211, USA", "geometry" : { "location" : { "lat" : 40.7142484, "lng" : -73.9614103 }, "location_type" : "ROOFTOP", "viewport" : { "northeast" : { "lat" : 40.71559738029149, "lng" : -73.9600613197085 }, "southwest" : { "lat" : 40.71289941970849, "lng" : -73.96275928029151 } } }, "place_id" : "ChIJT2x8Q2BZwokRpBu2jUzX3dE", "plus_code" : { "compound_code" : "P27Q+MC Brooklyn, New York, United States", "global_code" : "87G8P27Q+MC" }, "types" : [ "bakery", "cafe", "establishment", "food", "point_of_interest", "store" ] }, ... Additional results truncated in this example[] ... ], "status" : "OK" }
Commencer à coder avec nos bibliothèques clients
Les bibliothèques clientes vous aident à développer des applications avec les API des services Web Google Maps en fournissant des implémentations intégrées de tâches courantes, telles que l'authentification, la limitation des requêtes et la nouvelle tentative automatique. L'API Geocoding est disponible dans les clients Java, Python, Go et Node.js pour les services Google Maps.
Authentification, quotas, tarifs et règles
Authentification
Pour utiliser l'API Geocoding, vous devez d'abord l'activer et obtenir les identifiants d'authentification appropriés. Pour en savoir plus, consultez Premiers pas avec Google Maps Platform.
Quotas et tarifs
Pour en savoir plus sur les quotas et les tarifs définis pour l'API Geocoding, consultez la page Utilisation et facturation.
Règles
L'utilisation de l'API Geocoding doit être conforme aux Règles de l'API.
En savoir plus
L'API Geocoding offre de nombreuses autres possibilités. Pour obtenir d'autres démonstrations, exemples, paramètres disponibles, codes d'état et messages d'erreur, ainsi que d'autres informations, consultez le guide du développeur de l'API Geocoding.
Le guide du développeur de l'API Geocoding décrit le service Web de l'API Geocoding. Il s'adresse aux développeurs de sites Web et d'applications mobiles qui souhaitent utiliser des données de géocodage dans des cartes fournies par l'une des API Google Maps Platform.