Premiers pas

Google Maps Directions API est un service qui calcule des itinéraires entre des points géographiques. Vous pouvez rechercher des itinéraires pour différents moyens de transport dont les transports en commun, la voiture, la marche à pied ou le vélo.

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.

Exemple de requête et de réponse

Vous accédez à Google Maps Directions API via une interface HTTP, avec des requêtes construites en tant que chaînes d'URL utilisant des chaînes de texte ou des coordonnées de latitude/longitude pour identifier les points géographiques. Les requêtes doivent également contenir votre clé d'API.

L'exemple suivant illustre une requête d'itinéraire en voiture de Disneyland à Universal Studios Hollywood, au format JSON :

https://maps.googleapis.com/maps/api/directions/json?origin=Disneyland&destination=Universal+Studios+Hollywood4&key=YOUR_API_KEY

Essayez ! Vous pouvez essayer cette requête 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 renvoie l'itinéraire en voiture.

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

Un exemple de réponse est fourni ci-dessous, au format JSON :

{
   "geocoded_waypoints" : [
      {
         "geocoder_status" : "OK",
         "place_id" : "ChIJRVY_etDX3IARGYLVpoq7f68",
         "types" : [
            "bus_station",
            "transit_station",
            "point_of_interest",
            "establishment"
         ]
      },
      {
         "geocoder_status" : "OK",
         "partial_match" : true,
         "place_id" : "ChIJp2Mn4E2-woARQS2FILlxUzk",
         "types" : [ "route" ]
      }
   ],
   "routes" : [
      {
         "bounds" : {
            "northeast" : {
               "lat" : 34.1330949,
               "lng" : -117.9143879
            },
            "southwest" : {
               "lat" : 33.8068768,
               "lng" : -118.3527671
            }
         },
         "copyrights" : "Map data ©2016 Google",
         "legs" : [
            {
               "distance" : {
                  "text" : "35.9 mi",
                  "value" : 57824
               },
               "duration" : {
                  "text" : "51 mins",
                  "value" : 3062
               },
               "end_address" : "Universal Studios Blvd, Los Angeles, CA 90068, USA",
               "end_location" : {
                  "lat" : 34.1330949,
                  "lng" : -118.3524442
               },
               "start_address" : "Disneyland (Harbor Blvd.), S Harbor Blvd, Anaheim, CA 92802, USA",
               "start_location" : {
                  "lat" : 33.8098177,
                  "lng" : -117.9154353
               },

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


         "overview_polyline" : {
            "points" : "knjmEnjunUbKCfEA?_@]@kMBeE@qIIoF@wH@eFFk@WOUI_@?u@j@k@`@EXLTZHh@Y`AgApAaCrCUd@cDpDuAtAoApA{YlZiBdBaIhGkFrDeCtBuFxFmIdJmOjPaChDeBlDiAdD}ApGcDxU}@hEmAxD}[tt@yNb\\yBdEqFnJqB~DeFxMgK~VsMr[uKzVoCxEsEtG}BzCkHhKWh@]t@{AxEcClLkCjLi@`CwBfHaEzJuBdEyEhIaBnCiF|K_Oz\\
            {MdZwAbDaKbUiB|CgCnDkDbEiE|FqBlDsLdXqQra@kX|m@aF|KcHtLm@pAaE~JcTxh@w\\`v@gQv`@}F`MqK`PeGzIyGfJiG~GeLhLgIpIcE~FsDrHcFfLqDzH{CxEwAbBgC|B}F|DiQzKsbBdeA{k@~\\oc@bWoKjGaEzCoEzEwDxFsUh^wJfOySx[uBnCgCbCoFlDmDvAiCr@eRzDuNxC_EvAiFpCaC|AqGpEwHzFoQnQoTrTqBlCyDnGmCfEmDpDyGzGsIzHuZzYwBpBsC`CqBlAsBbAqCxAoBrAqDdDcNfMgHbHiPtReBtCkD|GqAhBwBzBsG~FoAhAaCbDeBvD_BlEyM``@uBvKiA~DmAlCkA|B}@lBcChHoJnXcB`GoAnIS~CIjFDd]A|QMlD{@jH[vAk@`CoGxRgPzf@aBbHoB~HeMx^eDtJ}BnG{DhJU`@mBzCoCjDaAx@mAnAgCnBmAp@uAj@{Cr@wBPkB@kBSsEW{GV}BEeCWyAWwHs@qH?
            cIHkDXuDn@mCt@mE`BsH|CyAp@}AdAaAtAy@lBg@pCa@jE]fEcBhRq@pJKlCk@hLFrB@lD_@xCeA`DoBxDaHvM_FzImDzFeCpDeC|CkExDiJrHcBtAkDpDwObVuCpFeCdHoIl\\uBjIuClJsEvMyDbMqAhEoDlJ{C|J}FlZuBfLyDlXwB~QkArG_AnDiAxC{G|OgEdLaE`LkBbEwG~KgHnLoEjGgDxCaC`BuJdFkFtCgCnBuClD_HdMqEzHcBpB_C|BuEzCmPlIuE|B_EtDeBhCgAdCw@rCi@|DSfECrCAdCS~Di@jDYhA_AlC{AxCcL`U{GvM_DjFkBzBsB`BqDhBaEfAsTvEmEr@iCr@qDrAiFnCcEzCaE~D_@JmFdGQDwBvCeErEoD|BcFjC}DbEuD~D`@Zr@h@?d@Wr@}@vAgCbEaHfMqA`Cy@dAg@bAO`@gCi@w@W"
         },
         "summary" : "I-5 N and US-101 N",
         "warnings" : [],
         "waypoint_order" : []
      }
   ],
   "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 Directions 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 Directions 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 Directions API.

Politiques

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

En savoir plus

Directions API vous permet de faire d'autres choses encore, comme demander des itinéraires pour différents modes de transport, utiliser des points de cheminement pour calculer des itinéraires passant par d'autres lieux ou estimer la durée d'un trajet. Consultez le guide du développeur de Directions API pour plus d'exemples et de détails.