L'API Geocoding v4 est un service qui fournit le geocoding, le geocoding inversé des adresses et des ID de lieu, ainsi que des informations sur la destination.
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.
Vous pouvez également utiliser l'API Geocoding pour trouver l'adresse correspondant à un
ID de lieu donné et pour récupérer des informations détaillées sur différentes destinations à l'aide de la méthode SearchDestinations.
Exemple de requête et de réponse
Vous accédez à l'API Geocoding via une interface HTTP. Vous trouverez ci-dessous des exemples de requêtes de geocoding et de geocoding 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 spécifie que la sortie doit être au format JSON.
curl -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
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.
Consultez le guide du développeur pour en savoir plus sur la création d'URL de requêtes de geocoding, les paramètres disponibles et la compréhension de la réponse.
Un exemple de réponse à une requête de géocodage est fourni ci-dessous, au format JSON :
{ "results": [ { "place": "//places.googleapis.com/places/ChIJ2Z2idB66j4ARI43TG-9RoCQ", "placeId": "ChIJ2Z2idB66j4ARI43TG-9RoCQ", "location": { "latitude": 37.4438238, "longitude": -122.0869895 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.4424748197085, "longitude": -122.0883384802915 }, "high": { "latitude": 37.445172780291493, "longitude": -122.08564051970852 } }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043-1351", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] }, { "longText": "1351", "shortText": "1351", "types": [ "postal_code_suffix" ] } ], "types": [ "premise", "street_address" ] } ] }
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, New York, États-Unis. Il indique également que la réponse doit être au format JSON.
https://geocode.googleapis.com/v4/geocode/location/37.4225508,-122.0846338?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 pour l'emplacement de latitude et de longitude location.
Consultez le guide du développeur pour en savoir plus sur la création d'URL de requêtes de geocoding inversé, les paramètres disponibles et la compréhension de la réponse.
Un exemple de réponse à une requête de géocodage inversé est fourni ci-dessous, au format JSON :
{ "results": [ { "place": "//places.googleapis.com/places/ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "placeId": "ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "location": { "latitude": 37.4225657, "longitude": -122.08465439999999 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.421214719708509, "longitude": -122.08603273029148 }, "high": { "latitude": 37.423912680291508, "longitude": -122.0833347697085 } }, "bounds": { "low": { "latitude": 37.4225178, "longitude": -122.08484599999998 }, "high": { "latitude": 37.422609600000008, "longitude": -122.0845215 } }, "formattedAddress": "Google Building 40, 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "Google Building 40", "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "Google Building 40", "shortText": "Google Building 40", "types": [ "premise" ], "languageCode": "en" }, { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] } ], "types": [ "street_address", "subpremise" ] }, ... Additional results truncated in this example[] ... }
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
Consultez la page Utilisation et facturation pour en savoir plus sur les quotas et les tarifs définis pour l'API Geocoding.
Règles
L'utilisation de l'API Geocoding doit être conforme aux règles de l'API.