Vous êtes prêt !

Pour passer à l'étape de développement, accédez à notre documentation pour les développeurs.

Activer Google Maps Geocoding API

Pour commencer, nous allons vous guider à travers la console Google Developers et effectuer deux ou trois petites choses :

  1. Créer ou sélectionner un projet
  2. Activer Google Maps Geocoding API
  3. Créer les clés appropriées
Continuer

Premiers pas

Google Maps Geocoding API est un service qui effectue le géocodage et le géocodage inversé d'adresses.

Ce service est également disponible côté client avec Google Maps JavaScript API ou, pour une utilisation côté serveur, avec Java Client, Python Client, Go Client et Node.js Client for Google Maps Services.

Le géocodage est le processus qui permet de convertir des adresses (comme une adresse postale) en coordonnées géographiques (comme la latitude et la longitude) que vous pouvez ensuite utiliser pour placer des marqueurs sur une carte ou pour positionner la carte.

Le géocodage inversé est le processus de conversion de coordonnées géographiques en adresses lisibles. Le service de géocodage inversé de Google Maps Geocoding API vous permet également de retrouver l'adresse correspondant à un identifiant de lieu donné.

Exemple de requête et de réponse

L'accès à Google Maps Geocoding API s'effectue via une interface HTTP. Des exemples de requêtes de géocodage et de géocodage inversé sont fournis ci-dessous.

Requête de géocodage et réponse (recherche de latitude/longitude)

L'exemple suivant est une requête de latitude et de longitude pour l'adresse « 1600 Amphitheatre Parkway, Mountain View, CA », et spécifie que la réponse doit être au format JSON.

https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY

Vous pouvez essayer par vous-même en saisissant l'URL dans votre navigateur Web (assurez-vous de remplacer « YOUR_API_KEY » par votre propre clé d'API). La réponse inclut la latitude et la longitude de l'adresse.

Reportez-vous au guide du développeur pour plus d'informations sur comment créer des requêtes de géocodage et définir les paramètres disponibles, ainsi que sur comment interpréter 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 Pkwy",
               "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 Parkway, Mountain View, CA 94043, USA",
         "geometry" : {
            "location" : {
               "lat" : 37.4224764,
               "lng" : -122.0842499
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 37.4238253802915,
                  "lng" : -122.0829009197085
               },
               "southwest" : {
                  "lat" : 37.4211274197085,
                  "lng" : -122.0855988802915
               }
            }
         },
         "place_id" : "ChIJ2eUgeAK6j4ARbn5u_wAGqWA",
         "types" : [ "street_address" ]
      }
   ],
   "status" : "OK"
}

Requête de géocodage inversé et réponse (recherche d'une adresse)

L'exemple suivant illustre une requête d'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_KEY

Vous pouvez essayer par vous-même en saisissant l'URL dans votre navigateur Web (assurez-vous de remplacer « YOUR_API_KEY » par votre propre clé d'API). La réponse inclut une adresse lisible pour la latitude et la longitude données.

Reportez-vous au guide du développeur pour plus d'informations sur comment créer des requêtes de géocodage inversé et définir les paramètres disponibles, ainsi que sur comment interpréter la réponse.

Un exemple de réponse à une requête de géocodage inversé est fourni ci-dessous, au format JSON :

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "277",
               "short_name" : "277",
               "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" : [ "sublocality", "political" ]
            },
            {
               "long_name" : "Kings",
               "short_name" : "Kings",
               "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" : "277 Bedford Avenue, Brooklyn, NY 11211, USA",
         "geometry" : {
            "location" : {
               "lat" : 40.714232,
               "lng" : -73.9612889
            },
            "location_type" : "ROOFTOP",
            "viewport" : {
               "northeast" : {
                  "lat" : 40.7155809802915,
                  "lng" : -73.9599399197085
               },
               "southwest" : {
                  "lat" : 40.7128830197085,
                  "lng" : -73.96263788029151
               }
            }
         },
         "place_id" : "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
         "types" : [ "street_address" ]
      },

   ... Additional results truncated in this example[] ...

   ],
   "status" : "OK"
}

Commencer à coder avec nos bibliothèques clients

Les bibliothèques clients facilitent le développement avec les API de services Web Google Maps, car elles fournissent des implémentations simples et natives de tâches courantes comme l'authentification, la limitation de requêtes et les nouvelles tentatives automatiques. Google Maps Geocoding API est disponible pour les clients Java Client, Python Client, Go Client et Node.js Client for Google Maps Services.

Authentification, quotas et politiques

Activer l'API et obtenir une clé d'API

Pour utiliser Google Maps Geocoding API, vous devez d'abord activer l'API dans Google API Console et obtenir les informations d'authentification appropriées. Vous devez fournir une clé d'API dans chaque requête (ou un ID client si vous avez souscrit un plan Premium).

Cliquez sur le bouton ci-dessous afin de suivre les étapes pour :

  1. Créer ou sélectionner un projet
  2. Activer l'API
  3. Obtenir une clé d'API
Obtenir une clé

En savoir plus sur les informations d'authentification.

Quotas

Consultez la page des limites d'utilisation pour en savoir plus sur les quotas définis pour Google Maps Geocoding API.

Politiques

L'utilisation de Google Maps Geocoding API doit être conforme aux politiques de l'API.

En savoir plus

Geocoding API offre encore d'autres possibilités. Consultez le guide du développeur de Geocoding API pour voir d'autres exemples et démos, ainsi que pour connaître les paramètres disponibles, les codes de statut, les messages d'erreur et autres détails.

Envoyer des commentaires concernant…

Google Maps Geocoding API
Google Maps Geocoding API
Besoin d'aide ? Consultez notre page d'assistance.