L'API Geocoding est un service qui fournit des fonctions de geocoding et de geocoding inversé d'adresses.
Le geocoding consiste à convertir des adresses (comme une adresse postale). en coordonnées géographiques (latitude et longitude, par exemple), que vous pouvez utiliser pour placer des repères. sur une carte ou positionne la carte.
Le geocoding inversé consiste à convertir des coordonnées géographiques. en une adresse lisible.
Vous pouvez également utiliser l'API Geocoding pour trouver l'adresse d'un ID de lieu donné.
Exemple de requête et de réponse
Vous accédez à l'API Geocoding via une interface HTTP. Suivies sont 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, Californie, États-Unis", et spécifie 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 ce faire, 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 <ph type="x-smartling-placeholder"></ph> la création d'URL de requête de geocoding et paramètres disponibles et comprendre la réponse.
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, dans l'État de New York, aux É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_KEY
Pour ce faire, saisissez l'URL dans votre navigateur Web (veillez à remplacer "YOUR_API_KEY" par votre clé API). La réponse inclut une adresse lisible pour la latitude et la longitude. l'emplacement.
Consultez le guide du développeur. pour en savoir plus sur <ph type="x-smartling-placeholder"></ph> créer des URL de requête de geocoding inversé paramètres disponibles et comprendre la réponse.
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 permettent le développement avec les API de services Web Google Maps en fournissant des des implémentations natives des tâches courantes, telles que l'authentification, la limitation et les nouvelles tentatives automatiques. L'API Geocoding est disponible dans Client Java, les clients 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 d'obtenir les bons identifiants. Pour en savoir plus, consultez Premiers pas avec Google Maps Platform
Quotas et tarifs
Examiner l'utilisation et la 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
En savoir plus
L'API Geocoding vous offre bien d'autres possibilités. Consultez le le guide du développeur de l'API Geocoding pour accéder à des démonstrations supplémentaires. exemples, paramètres disponibles, codes d'état et messages d'erreur, ainsi que d'autres détails.
Le le guide du développeur de l'API Geocoding décrit les Service Web de l'API Geocoding. Il est destiné aux développeurs de sites Web et d'applications mobiles qui souhaitent utiliser des données de geocoding dans les cartes fournies par l'une des plates-formes Google Maps Platform API.