Ce produit est obsolète. Depuis octobre 2026, il n'est plus possible d'activer l'ancienne API Directions pour les nouveaux projets Google Cloud. Les projets existants restent entièrement compatibles. Pour bénéficier de nouvelles fonctionnalités et de performances améliorées, migrez vers l'API Routes.

Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Réponses concernant les itinéraires

Développeurs de l'Espace économique européen (EEE)

Ce produit est en état obsolète. À partir d'octobre 2026, l'API Directions (ancienne) ne pourra plus être activée pour les nouveaux projets Google Cloud. Les projets existants restent entièrement compatibles. Pour bénéficier de nouvelles fonctionnalités et de performances améliorées, migrez vers l'API Routes.

Exemples de réponses

Les réponses de l'API Directions sont renvoyées au format indiqué par l'option output dans le chemin de la requête d'URL.

Vous trouverez ci-dessous un exemple de requête HTTP calculant l'itinéraire entre Chicago (Illinois) et Los Angeles (Californie) via deux points de cheminement à Joplin (Missouri) et Oklahoma City (Oklahoma).

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Los%20Angeles%2C%20CA
  &origin=Chicago%2C%20IL
  &waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Chicago%2C%20IL&destination=Los%20Angeles%2C%20CA&waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK&key=YOUR_API_KEY'

L'exemple ci-dessus demande une réponse JSON. Il est également possible de demander une sortie XML. Sélectionnez les onglets ci-dessous pour afficher les exemples de réponses JSON et XML.

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ7cv00DwsDogRAMDACa2m4K8",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgdL4flSKrYcRnTpP0XQSojM",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJE9on3F3HwoAR9AhGJW_fL-I",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 41.8781139, "lng": -87.6297872 },
            "southwest": { "lat": 34.0523525, "lng": -118.2435717 },
          },
        "copyrights": "Map data ©2022 Google, INEGI",
        "legs":
          [
            {
              "distance": { "text": "579 mi", "value": 932311 },
              "duration": { "text": "8 hours 48 mins", "value": 31653 },
              "end_address": "Joplin, MO, USA",
              "end_location": { "lat": 37.0842449, "lng": -94.513284 },
              "start_address": "Chicago, IL, USA",
              "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
              "steps":
                [
                  {
                    "distance": { "text": "443 ft", "value": 135 },
                    "duration": { "text": "1 min", "value": 24 },
                    "end_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "html_instructions": "Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b>",
                    "polyline": { "points": "eir~FdezuOdCEjBC" },
                    "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
                    "travel_mode": "DRIVING",
                  },
                  {
                    "distance": { "text": "269 ft", "value": 82 },
                    "duration": { "text": "1 min", "value": 20 },
                    "end_location": { "lat": 41.8768866, "lng": -87.63073 },
                    "html_instructions": "Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b>",
                    "maneuver": "turn-right",
                    "polyline": { "points": "sar~FzdzuO@fC?|@" },
                    "start_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
            // Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity
          ],
        "overview_polyline":
          {
            "points": "eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)",
          },
        "summary": "I-55 S and I-44",
        "warnings": [],
        "waypoint_order": [0, 1],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>I-55 S and I-44</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8781139</lat>
     <lng>-87.6297872</lng>
    </start_location>
    <end_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </end_location>
    <polyline>
     <points>eir~FdezuOdCEjBC</points>
    </polyline>
    <duration>
     <value>24</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Head &lt;b&gt;south&lt;/b&gt; on &lt;b&gt;S Federal St&lt;/b&gt; toward &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>135</value>
     <text>443 ft</text>
    </distance>
   </step>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </start_location>
    <end_location>
     <lat>41.8768866</lat>
     <lng>-87.6307300</lng>
    </end_location>
    <polyline>
     <points>sar~FzdzuO@fC?|@</points>
    </polyline>
    <duration>
     <value>20</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Turn &lt;b&gt;right&lt;/b&gt; at the 1st cross street onto &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>82</value>
     <text>269 ft</text>
    </distance>
    <maneuver>turn-right</maneuver>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>31653</value>
    <text>8 hours 48 mins</text>
   </duration>
   <distance>
    <value>932311</value>
    <text>579 mi</text>
   </distance>
   <start_location>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </start_location>
   <end_location>
    <lat>37.0842449</lat>
    <lng>-94.5132840</lng>
   </end_location>
   <start_address>Chicago, IL, USA</start_address>
   <end_address>Joplin, MO, USA</end_address>
  </leg>
  <!-- Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity -->
  <copyrights>Map data ©2022 Google, INEGI</copyrights>
  <overview_polyline>
   <points>eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)</points>
  </overview_polyline>
  <waypoint_index>0</waypoint_index>
  <waypoint_index>1</waypoint_index>
  <bounds>
   <southwest>
    <lat>34.0523525</lat>
    <lng>-118.2435717</lng>
   </southwest>
   <northeast>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ7cv00DwsDogRAMDACa2m4K8</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ69Pk6jdlyIcRDqM1KDY3Fpg</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgdL4flSKrYcRnTpP0XQSojM</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJE9on3F3HwoAR9AhGJW_fL-I</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

Dans la suite de la présente documentation, nous utiliserons la syntaxe JSON. Dans la plupart des cas, le format de sortie n'a pas d'importance pour illustrer les concepts ou les noms de champs dans la documentation. Notez toutefois les différences subtiles suivantes :

Les résultats XML sont encapsulés dans un élément racine <DirectionsResponse>.
JSON désigne les entrées comportant plusieurs éléments par des tableaux au pluriel (tels que steps et legs), tandis que XML les désigne à l'aide de plusieurs éléments au singulier (tels que <step> et <leg>).
JSON indique l'ordre des points de cheminement via le champ waypoint_order, tandis que XML les indique à l'aide d'éléments <waypoint_index> individuels.
Les éléments vides sont indiqués par des tableaux vides en JSON, mais par l'absence de tels éléments en XML. Par exemple, une réponse qui ne génère aucun résultat renvoie un tableau routes vide au format JSON, mais aucun élément <route> au format XML.

DirectionsResponse

Champ	Obligatoire	Type	Description
`routes`	required	Array<DirectionsRoute>	Contient un tableau d'itinéraires du point de départ à la destination. Les itinéraires se composent d'étapes et de tronçons imbriqués. Pour en savoir plus, consultez DirectionsRoute.
`status`	required	DirectionsStatus	Contient l'état de la requête et éventuellement des informations de débogage qui vous aident à savoir pourquoi la requête a échoué. Pour en savoir plus, consultez DirectionsStatus.
`available_travel_modes`	facultatif	Array<TravelMode>	Contient un tableau des modes de transport disponibles. Ce champ est renvoyé lorsqu'une requête spécifie un mode de transport et n'obtient aucun résultat. Le tableau contient les modes de transport disponibles dans les pays de l'ensemble de points de cheminement donné. Ce champ n'est pas renvoyé si un ou plusieurs points de cheminement sont des points de cheminement de type "via". Pour en savoir plus, consultez TravelMode.
`error_message`	facultatif	chaîne	Lorsque le service renvoie un code d'état autre que `OK`, un champ `error_message` supplémentaire peut être présent dans l'objet de réponse. Ce champ contient des informations plus détaillées sur les raisons du code d'état donné. Ce champ n'est pas toujours renvoyé et son contenu est susceptible d'être modifié.
`geocoded_waypoints`	facultatif	Array<DirectionsGeocodedWaypoint>	Contient un tableau d'objets contenant des détails sur le geocoding du point de départ, de la destination et des points de cheminement. Les éléments du tableau geocoded_waypoints correspondent, par leur position basée sur zéro, au point de départ, aux points de cheminement dans l'ordre dans lequel ils sont spécifiés, et à la destination. Ces informations ne seront pas présentes pour les points de cheminement spécifiés sous forme de valeurs textuelles de latitude/longitude si le service ne renvoie aucun résultat. En effet, ces points de cheminement ne sont géocodés de manière inversée pour obtenir leur adresse représentative qu'une fois qu'un itinéraire a été trouvé. Un objet JSON vide occupera les emplacements correspondants dans le tableau geocoded_waypoints. Pour en savoir plus, consultez DirectionsGeocodedWaypoint.

DirectionsRoute

Les routes se composent de legs et de steps imbriqués.

Champ	Obligatoire	Type	Description
`bounds`	required	Limites	Contient le cadre de délimitation de la fenêtre d'affichage de l'élément `overview_polyline`. Pour en savoir plus, consultez Limites.
`copyrights`	required	chaîne	Contient les avis de droits d'auteur à afficher pour cet itinéraire. Vous devez gérer et afficher ces informations vous-même. Ce contenu est destiné à être lu tel quel. N'analysez pas par programmation ce contenu réservé à l'affichage.
`legs`	required	Tableau<DirectionsLeg>	Tableau contenant des informations sur une section de l'itinéraire entre un lieu et un autre. Une section séparée est présente pour chaque point de cheminement ou de destination spécifié. (Un itinéraire sans point de cheminement contient exactement une section dans le tableau "legs".) Chaque section est constituée d'une série d'étapes. Pour en savoir plus, consultez DirectionsLeg.
`overview_polyline`	required	DirectionsPolyline	Contient un objet qui comprend une représentation de l'itinéraire sous forme de polyligne encodée. Cette polyligne est un tracé approximatif (lissé) de l'itinéraire obtenu. Pour en savoir plus, consultez DirectionsPolyline.
`summary`	required	chaîne	Contient une brève description textuelle de l'itinéraire, adaptée pour nommer l'itinéraire et le distinguer des autres.
`warnings`	required	Array<string>	Contient un tableau d'avertissements à afficher lors de l'affichage de cet itinéraire. Vous devez gérer et afficher ces avertissements vous-même.
`waypoint_order`	required	Tableau<entier>	Tableau indiquant l'ordre des points de cheminement dans l'itinéraire calculé. Ces points de cheminement peuvent être réorganisés si la requête a été transmise avec optimize:true dans son paramètre waypoints.
`fare`	facultatif	Tarif	S'il est présent, ce champ contient le coût total de l'itinéraire (c'est-à-dire le total des prix des billets). Cette propriété n'est renvoyée que pour les requêtes de transports en commun et uniquement si les informations tarifaires sont disponibles pour toutes les sections en transports en commun. Pour en savoir plus, consultez Fare.

Limites

Rectangle en coordonnées géographiques à partir de points situés aux angles sud-ouest et nord-est.

Champ	Obligatoire	Type	Description
`northeast`	required	LatLngLiteral	Pour en savoir plus, consultez LatLngLiteral.
`southwest`	required	LatLngLiteral	Pour en savoir plus, consultez LatLngLiteral.

LatLngLiteral

Objet décrivant un emplacement spécifique avec la latitude et la longitude en degrés décimaux.

Champ	Obligatoire	Type	Description
`lat`	required	nombre	Latitude en degrés décimaux
`lng`	required	nombre	Longitude en degrés décimaux

DirectionsLeg

Champ	Obligatoire	Type	Description
`end_address`	required	chaîne	Contient l'adresse lisible par l'humain (généralement une adresse postale) issue du geocoding inversé du `end_location` de cette étape. Ce contenu est destiné à être lu tel quel. N'analysez pas par programmation l'adresse formatée.
`end_location`	required	LatLngLiteral	Coordonnées de latitude/longitude de la destination de cette étape. Étant donné que l'API Directions calcule l'itinéraire entre deux lieux à l'aide de l'option de transport la plus proche des points de départ et d'arrivée (il s'agit généralement d'une route), `end_location` peut être différent de la destination fournie pour cette section. Par exemple, c'est le cas si la destination n'est pas à proximité d'une route. Pour en savoir plus, consultez LatLngLiteral.
`start_address`	required	chaîne	Contient l'adresse lisible par l'humain (généralement une adresse postale) résultant du geocoding inversé de l'`start_location` de cette étape. Ce contenu est destiné à être lu tel quel. N'analysez pas par programmation l'adresse formatée.
`start_location`	required	LatLngLiteral	Coordonnées de latitude/longitude du point de départ de cette étape. Étant donné que l'API Directions calcule l'itinéraire entre deux lieux à l'aide de l'option de transport la plus proche des points de départ et d'arrivée (il s'agit généralement d'une route), `start_location` peut être différent du point de départ fourni pour cette section. Par exemple, c'est le cas si le point de départ n'est pas à proximité d'une route. Pour en savoir plus, consultez LatLngLiteral.
`steps`	required	Array<DirectionsStep>	Tableau d'étapes comportant des informations sur chaque étape distincte de la section du trajet. Pour en savoir plus, consultez DirectionsStep.
`traffic_speed_entry`	facultatif	Array<DirectionsTrafficSpeedEntry>	Obsolète : ce tableau est toujours vide. Informations sur la vitesse du trafic le long de l'étape. Pour en savoir plus, consultez DirectionsTrafficSpeedEntry.
`via_waypoint`	required	Array<DirectionsViaWaypoint>	Emplacements des points de cheminement intermédiaires le long de cette étape. Pour en savoir plus, consultez DirectionsViaWaypoint.
`arrival_time`	facultatif	TimeZoneTextValueObject	Contient l'heure d'arrivée prévue pour cette section. Cette propriété n'est renvoyée que pour les itinéraires en transports en commun. Pour en savoir plus, consultez TimeZoneTextValueObject.
`departure_time`	facultatif	TimeZoneTextValueObject	Contient l'heure de départ estimée pour cette section, spécifiée en tant qu'objet Time. `departure_time` n'est disponible que pour les itinéraires en transports en commun. Pour en savoir plus, consultez TimeZoneTextValueObject.
`distance`	facultatif	TextValueObject	Distance totale couverte par cette section. Pour en savoir plus, consultez TextValueObject.
`duration`	facultatif	TextValueObject	Durée totale de cette section. Pour en savoir plus, consultez TextValueObject.
`duration_in_traffic`	facultatif	TextValueObject	Indique la durée totale de cette section. Cette valeur est une estimation du temps passé dans les embouteillages, basée sur les conditions de circulation actuelles et historiques. Consultez le paramètre de requête `traffic_model` pour connaître les options permettant de demander que la valeur renvoyée soit optimiste, pessimiste ou une estimation approximative. La durée dans le trafic n'est renvoyée que si toutes les conditions suivantes sont remplies : La requête n'inclut pas de points de cheminement avec arrêt. Si la requête inclut des points de cheminement, ils doivent être précédés du préfixe `via:` pour éviter les arrêts. La requête porte spécifiquement sur un itinéraire en voiture (le paramètre mode est défini sur `driving`). La requête inclut un paramètre `departure_time`. Les conditions de circulation sont disponibles pour l'itinéraire demandé. Pour en savoir plus, consultez TextValueObject.

DirectionsStep

Chaque élément du tableau "steps" définit une seule étape de l'itinéraire calculé. Une étape est l'unité la plus petite d'un itinéraire et décrit une instruction unique et spécifique au cours du trajet. Par exemple, "Tourner à gauche vers Pl. Rol Tanguy" Cette étape décrit non seulement l'instruction, mais contient également des informations de distance et de durée entre cette étape et la suivante. Par exemple, une étape "Rejoindre Rue Armand Rousseau" peut contenir une durée de "60 kilomètres" et "40 minutes", indiquant que l'étape suivante se trouve à 60 kilomètres/40 minutes de cette étape.

Lorsque vous utilisez l'API Directions pour rechercher un itinéraire en transports en commun, le tableau des étapes inclut d'autres informations sur les transports en commun dans un tableau transit_details. Si l'itinéraire comprend plusieurs modes de transport, des indications détaillées (pour les étapes à pied ou en voiture) seront fournies dans un tableau d'étapes internes. Par exemple, une étape à pied inclura des indications : "Marcher jusqu'à Pl. Jeanne Laurent". Cette étape inclut des indications à pied détaillées pour cet itinéraire dans le tableau des étapes internes, par exemple : "Prendre la direction nord-ouest", "Tourner à gauche Rue Roger-Henri Guerrand" et "Tourner à gauche sur Av. Jules Maniez".

Champ	Obligatoire	Type	Description
`duration`	required	TextValueObject	Contient le temps généralement nécessaire pour suivre cette étape jusqu'à la suivante. Ce champ peut être non défini si la durée est inconnue. Pour en savoir plus, consultez TextValueObject.
`end_location`	required	LatLngLiteral	Contient l'emplacement du dernier point de cette étape. Pour en savoir plus, consultez LatLngLiteral.
`html_instructions`	required	chaîne	Contient des instructions mises en forme pour cette étape, présentées sous la forme d'une chaîne de texte HTML. Ce contenu est destiné à être lu tel quel. N'analysez pas par programmation ce contenu destiné uniquement à l'affichage.
`polyline`	required	DirectionsPolyline	Contient un seul objet de points qui comprend une représentation de l'étape sous forme de polyligne encodée. Cette polyligne est un tracé approximatif (lissé) de l'étape. Pour en savoir plus, consultez DirectionsPolyline.
`start_location`	required	LatLngLiteral	Contient l'emplacement du point de départ de cette étape. Pour en savoir plus, consultez LatLngLiteral.
`travel_mode`	required	TravelMode	Contient le type de mode de transport utilisé. Pour en savoir plus, consultez TravelMode.
`distance`	facultatif	TextValueObject	Contient la distance couverte par cette étape jusqu'à l'étape suivante. Ce champ peut être non défini si la distance est inconnue. Pour en savoir plus, consultez TextValueObject.
`maneuver`	facultatif	chaîne	Contient l'action à effectuer pour l'étape actuelle (tourner à gauche, s'insérer, continuer tout droit, etc.). Les valeurs sont susceptibles d'être modifiées, et de nouvelles valeurs peuvent être ajoutées sans préavis. The allowed values include: `turn-slight-left`, `turn-sharp-left`, `turn-left`, `turn-slight-right`, `turn-sharp-right`, `keep-right`, `keep-left`, `uturn-left`, `uturn-right`, `turn-right`, `straight`, `ramp-left`, `ramp-right`, `merge`, `fork-left`, `fork-right`, `ferry`, `ferry-train`, `roundabout-left`, and `roundabout-right`
`steps`	facultatif		Contient des instructions détaillées pour les étapes à pied ou en voiture dans les itinéraires en transports en commun. Les sous-étapes ne sont disponibles que lorsque travel_mode est défini sur "transit". Le tableau d'étapes interne est du même type que les étapes.
`transit_details`	facultatif	DirectionsTransitDetails	Informations relatives à cette étape si le mode de transport est `transit`. Pour en savoir plus, consultez DirectionsTransitDetails.

TextValueObject

Objet contenant une valeur numérique et sa représentation textuelle mise en forme.

Champ	Obligatoire	Type	Description
`text`	required	chaîne	Valeur de chaîne.
`value`	required	nombre	Valeur numérique.

DirectionsPolyline

L'encodage de polylignes est un algorithme de compression avec perte qui vous permet de stocker une série de coordonnées sous la forme d'une seule chaîne. Les coordonnées des points sont encodées à l'aide de valeurs signées. Si vous n'avez que quelques points statiques, vous pouvez également utiliser l'utilitaire d'encodage interactif des polylignes.

Le processus d'encodage convertit une valeur binaire en une série de codes de caractères pour les caractères ASCII à l'aide du schéma d'encodage base64 habituel : pour garantir l'affichage correct de ces caractères, les valeurs encodées sont additionnées à 63 (le caractère ASCII "?") avant d'être converties en ASCII. L'algorithme recherche également des codes de caractères supplémentaires pour un point donné en vérifiant le bit le moins significatif de chaque groupe d'octets. Si ce bit est défini sur 1, le point n'est pas encore complètement formé et des données supplémentaires doivent suivre.

De plus, pour économiser de l'espace, les points n'incluent que le décalage par rapport au point précédent (sauf, bien sûr, pour le premier point). Tous les points sont encodés en Base64 sous forme d'entiers signés, car les latitudes et les longitudes sont des valeurs signées. Le format d'encodage d'une polyligne doit représenter deux coordonnées (latitude et longitude) avec une précision raisonnable. Étant donné une longitude maximale de +/- 180 degrés avec une précision de cinq décimales (180,00000 à -180,00000), cela nécessite une valeur entière binaire signée de 32 bits.

Champ	Obligatoire	Type	Description
`points`	required	chaîne	Représentation de la polyligne sous forme de chaîne unique.

TravelMode

DRIVING (par défaut) indique un calcul utilisant le réseau routier.
BICYCLING demande le calcul d'un itinéraire à vélo via les pistes cyclables et les rues à privilégier (dans la mesure du possible).
TRANSIT demande un calcul d'itinéraire via les réseaux de transports en commun (dans la mesure du possible).
WALKING demande un calcul pour un itinéraire à pied via les voies piétonnes et les trottoirs (dans la mesure du possible).

DirectionsTransitDetails

Informations supplémentaires qui ne sont pas pertinentes pour les autres modes de transport.

Champ	Obligatoire	Type	Description
`arrival_stop`	facultatif	DirectionsTransitStop	Arrêt de transport en commun d'arrivée. Pour en savoir plus, consultez DirectionsTransitStop.
`arrival_time`	facultatif	TimeZoneTextValueObject	Pour en savoir plus, consultez TimeZoneTextValueObject.
`departure_stop`	facultatif	DirectionsTransitStop	Arrêt de départ des transports en commun. Pour en savoir plus, consultez DirectionsTransitStop.
`departure_time`	facultatif	TimeZoneTextValueObject	Pour en savoir plus, consultez TimeZoneTextValueObject.
`headsign`	facultatif	chaîne	Spécifie le sens du trajet sur cette ligne tel qu'indiqué sur le véhicule ou à l'arrêt de départ. Il s'agit souvent du terminus.
`headway`	facultatif	entier	Indique le nombre de secondes estimé entre deux départs depuis le même arrêt à l'heure actuelle. Par exemple, si la valeur de `headway` est de 600, vous attendrez environ 10 minutes si vous manquez votre bus.
`line`	facultatif	DirectionsTransitLine	Contient des informations sur la ligne de transports en commun utilisée à cette étape. Pour en savoir plus, consultez DirectionsTransitLine.
`num_stops`	facultatif	entier	Nombre d'arrêts entre le départ et l'arrivée. L'arrêt d'arrivée est inclus, mais pas celui de départ. Par exemple, si votre itinéraire consiste à partir de l'arrêt A pour arriver à l'arrêt D en passant par les arrêts B et C, `num_stops` renvoie 3.
`trip_short_name`	facultatif	chaîne	Texte qui apparaît sur les horaires et les panneaux d'affichage pour identifier un trajet en transports en commun pour les passagers. Le texte doit identifier un trajet unique au cours d'une journée de service. Par exemple, "538" est l'`trip_short_name` du train Amtrak qui part de San Jose (Californie) à 15h10 en semaine pour Sacramento (Californie).

DirectionsTransitStop

Champ	Obligatoire	Type	Description
`location`	required	LatLngLiteral	Emplacement de l'arrêt. Pour en savoir plus, consultez LatLngLiteral.
`name`	required	chaîne	Nom de l'arrêt de transports en commun.

TimeZoneTextValueObject

Objet contenant l'heure epoch Unix, un fuseau horaire et sa représentation textuelle formatée.

Champ	Obligatoire	Type	Description
`text`	required	chaîne	Heure spécifiée sous forme de chaîne dans le fuseau horaire.
`time_zone`	required	chaîne	Contient le fuseau horaire. La valeur correspond au nom du fuseau horaire, tel que défini dans la base de données des fuseaux horaires de l'IANA (par exemple, "America/New_York").
`value`	required	nombre	Heure spécifiée en tant qu'heure epoch Unix, ou secondes depuis le 1er janvier 1970 à minuit UTC.

DirectionsTransitLine

Champ	Obligatoire	Type	Description
`agencies`	required	Array<DirectionsTransitAgency>	L'agence (ou les agences) de transports en commun qui gère cette ligne de transports en commun. Pour en savoir plus, consultez DirectionsTransitAgency.
`name`	required	chaîne	Nom complet de la ligne de transports en commun, par exemple "8 Avenue Local".
`color`	facultatif	chaîne	Couleur couramment utilisée pour désigner cette ligne.
`icon`	facultatif	chaîne	Contient l'URL de l'icône associée à cette ligne.
`short_name`	facultatif	chaîne	Nom court de cette ligne de transports en commun. Il s'agit généralement d'un numéro de ligne tel que "M7" ou "355".
`text_color`	facultatif	chaîne	Couleur couramment utilisée pour désigner cette ligne.
`url`	facultatif	chaîne	Contient l'URL de cette ligne de transports en commun fournie par l'agence de transports en commun.
`vehicle`	facultatif	DirectionsTransitVehicle	Type de véhicule utilisé sur cette ligne de transports en commun. Pour en savoir plus, consultez DirectionsTransitVehicle.

DirectionsTransitAgency

Champ	Obligatoire	Type	Description
`name`	facultatif	chaîne	Nom de cette agence de transports en commun.
`phone`	facultatif	chaîne	Numéro de téléphone de l'agence de transports en commun.
`url`	facultatif	chaîne	URL de l'agence de transports en commun.

DirectionsTransitVehicle

Champ	Obligatoire	Type	Description
`name`	required	chaîne	Nom de ce véhicule, en majuscules.
`type`	required	chaîne	Type de véhicule utilisé. `BUS` : bus. `CABLE_CAR` : véhicule tracté par un câble, généralement en surface. Les téléphériques peuvent être de type GONDOLA_LIFT. `COMMUTER_TRAIN` : train de banlieue. `FERRY` : ferry. `FUNICULAR` : véhicule tracté par un câble le long d'une pente prononcée. Un funiculaire se compose généralement de deux rames, chacune agissant comme contrepoids de l'autre. `GONDOLA_LIFT` : téléphérique. `HEAVY_RAIL` : train express. `HIGH_SPEED_TRAIN` : train à grande vitesse. `INTERCITY_BUS` : bus interurbain. `LONG_DISTANCE_TRAIN` : train longue distance. `METRO_RAIL` : métro léger. `MONORAIL` : monorail. `OTHER` : ce type est renvoyé pour tous les autres véhicules. `RAIL` : train. `SHARE_TAXI` : type de bus pouvant faire monter et descendre des passagers n'importe où sur son trajet. `SUBWAY` : métro léger souterrain. `TRAM` : métro léger en surface. `TROLLEYBUS` : trolleybus. The allowed values include: `BUS`, `CABLE_CAR`, `COMMUTER_TRAIN`, `FERRY`, `FUNICULAR`, `GONDOLA_LIFT`, `HEAVY_RAIL`, `HIGH_SPEED_TRAIN`, `INTERCITY_BUS`, `LONG_DISTANCE_TRAIN`, `METRO_RAIL`, `MONORAIL`, `OTHER`, `RAIL`, `SHARE_TAXI`, `SUBWAY`, `TRAM`, and `TROLLEYBUS`
`icon`	facultatif	chaîne	Contient l'URL d'une icône associée à ce type de véhicule.
`local_icon`	facultatif	chaîne	Contient l'URL de l'icône associée à ce type de véhicule d'après la signalétique locale pour les transports en commun.

DirectionsTrafficSpeedEntry

Champ	Obligatoire	Type	Description
`offset_meters`	required	nombre	Décalage le long du trajet (en mètres) jusqu'auquel cette catégorie de vitesse est valide.
`speed_category`	required	chaîne	Conditions de circulation/vitesse actuelles sur cette partie d'un trajet.

DirectionsViaWaypoint

Champ	Obligatoire	Type	Description
`location`	facultatif	LatLngLiteral	Emplacement du point de cheminement. Pour en savoir plus, consultez LatLngLiteral.
`step_index`	facultatif	entier	Index de l'étape contenant le point de cheminement.
`step_interpolation`	facultatif	nombre	Position du point de cheminement le long de la polyligne de l'étape, exprimée sous la forme d'un ratio compris entre 0 et 1.

Fare

Tarif total de l'itinéraire.

{
  "currency" : "USD",
  "value" : 6,
  "text" : "$6.00"
}

Champ	Obligatoire	Type	Description
`currency`	required	chaîne	Code de la devise ISO 4217 indiquant la devise dans laquelle le montant est exprimé.
`text`	required	chaîne	Prix total, formaté dans la langue spécifiée.
`value`	required	nombre	Tarif total exprimé dans la devise spécifiée.

DirectionsStatus

Le champ "status" de l'objet de réponse Directions contient l'état de la requête et peut contenir des informations de débogage pour vous aider à identifier la cause de l'échec du service Directions. Le champ d'état peut contenir les valeurs suivantes :

OK indique que la réponse contient un résultat valide.
NOT_FOUND indique qu'au moins un des lieux spécifiés dans la requête comme point de départ, destination ou point de cheminement n'a pas pu être géocodé.
ZERO_RESULTS indique qu'aucun itinéraire n'a été trouvé entre le point de départ et la destination.
MAX_WAYPOINTS_EXCEEDED indique que trop de points de cheminement ont été fournis dans la requête. Pour les applications qui utilisent l'API Directions en tant que service Web ou le service Directions de l'API Maps JavaScript, le nombre maximal de points de cheminement autorisé est de 25, en plus du point de départ et de la destination.
MAX_ROUTE_LENGTH_EXCEEDED indique que l'itinéraire demandé est trop long et ne peut pas être traité. Cette erreur se produit lorsque des itinéraires plus complexes sont renvoyés. Essayez de réduire le nombre de points de cheminement, de changement de direction ou d'instructions.
INVALID_REQUEST indique que la requête fournie n'était pas valide. Les causes courantes de cet état incluent un paramètre ou une valeur de paramètre non valide.
OVER_DAILY_LIMIT indique l'un des éléments suivants :
- La clé API est manquante ou non valide.
- La facturation n'a pas été activée sur votre compte.
- La limite d'utilisation que vous avez définie vous-même a été dépassée.
- Le mode de facturation fourni n'est plus valide (une carte de crédit est arrivée à expiration, par exemple).
Consultez les questions fréquentes sur Maps pour savoir comment résoudre ce problème.
OVER_QUERY_LIMIT indique que le service a reçu trop de requêtes de votre application au cours de la période autorisée.
REQUEST_DENIED indique que le service a refusé l'utilisation du service Directions par votre application.
UNKNOWN_ERROR indique qu'une requête d'itinéraire n'a pas pu être traitée en raison d'une erreur du serveur. Si vous essayez à nouveau, la requête pourrait aboutir.

DirectionsGeocodedWaypoint

Champ	Obligatoire	Type	Description
`geocoder_status`	facultatif	chaîne	Indique le code d'état résultant de l'opération de geocoding. Ce champ peut contenir les valeurs suivantes : The allowed values include: `OK`, and `ZERO_RESULTS`
`partial_match`	facultatif		Indique que le geocoder n'a pas renvoyé de correspondance exacte pour la requête d'origine, bien qu'il ait pu trouver une partie de l'adresse demandée. Nous vous recommandons d'examiner la requête d'origine pour vérifier qu'elle ne contient pas d'erreur de syntaxe et/ou que l'adresse est bien complète. Les correspondances partielles sont souvent renvoyées lorsque l'adresse postale n'existe pas dans la localité que vous avez indiquée dans la requête. Les correspondances partielles peuvent aussi être renvoyées lorsqu'une requête correspond à plusieurs lieux au sein de la même localité. Par exemple, "21 Henr St, Bristol, UK" renvoie une correspondance partielle pour Henry Street et Henrietta Street. Notez que si une requête comprend un composant d'adresse mal saisi, le service de geocoding peut suggérer une autre adresse. Les suggestions déclenchées de cette façon sont également signalées comme des correspondances partielles.
`place_id`	facultatif	chaîne	Identifiant unique pouvant être utilisé avec d'autres API Google. Consultez la présentation des ID de lieu.
`types`	facultatif	Array<string>	Indique le type d'adresse du résultat de géocodage utilisé pour calculer l'itinéraire. `administrative_area_level_1` indique une entité civile de premier ordre en dessous du niveau du pays. Aux États-Unis, ces niveaux administratifs correspondent aux États. Toutes les nations ne possèdent pas ces niveaux administratifs. Dans la plupart des cas, les noms courts "administrative_area_level_1" correspondront fidèlement aux subdivisions ISO 3166-2 et aux autres listes largement diffusées. Cependant, cela n'est pas systématique, car nos résultats de geocoding se basent sur divers signaux et données de localisation. `administrative_area_level_2` indique une entité civile de deuxième ordre en dessous du niveau du pays. Aux États-Unis, ces niveaux administratifs correspondent aux comtés. Toutes les nations ne possèdent pas ces niveaux administratifs. `administrative_area_level_3` indique une entité civile de troisième ordre en dessous du niveau du pays. Ce type indique une division civile mineure. Toutes les nations ne possèdent pas ces niveaux administratifs. `administrative_area_level_4` indique une entité civile de quatrième ordre en dessous du niveau du pays. Ce type indique une division civile mineure. Toutes les nations ne possèdent pas ces niveaux administratifs. `administrative_area_level_5` indique une entité civile de cinquième ordre en dessous du niveau du pays. Ce type indique une division civile mineure. Toutes les nations ne possèdent pas ces niveaux administratifs. `airport` indique un aéroport. `colloquial_area` indique un autre nom couramment utilisé pour l'entité. `country` indique l'entité politique nationale et correspond généralement au type de premier ordre renvoyé par le Geocoder. `intersection` indique une intersection majeure, généralement sur deux routes principales. `locality` indique une entité politique de ville ou de municipalité incorporée. `natural_feature` indique un élément géographique naturel important. `neighborhood` indique un quartier nommé. `park` indique un parc nommé. `plus_code` indique une référence de lieu encodée, déterminée par la latitude et la longitude. Vous pouvez utiliser des Plus Codes pour remplacer les adresses postales dans les endroits où elles n'existent pas (où les bâtiments ne sont pas numérotés ni nommés). Pour en savoir plus, consultez https://plus.codes. `point_of_interest` indique un point d'intérêt nommé. En général, ces "POI" sont des entités locales importantes qui ne correspondent à aucune autre catégorie, comme "Empire State Building" ou "Tour Eiffel". `political` indique une entité politique. Généralement, ce type indique un polygone de certaines administrations civiles. `postal_code` indique un code postal utilisé dans les adresses de courrier postal du pays. `premise` indique un lieu nommé, généralement un bâtiment ou un ensemble de bâtiments ayant un nom commun. `route` indique une route nommée (par exemple, "US 101"). `street_address` indique une adresse postale précise. `sublocality` indique une entité civile de premier ordre en dessous d'une localité. Pour certains établissements, vous pouvez recevoir l'un des types supplémentaires suivants : sublocality_level_1 à sublocality_level_5. Chaque niveau de sous-localité correspond à une entité civile. Plus le nombre est élevé, plus la zone géographique est petite. `subpremise` indique une entité de premier ordre située en dessous d'un lieu nommé, généralement un bâtiment particulier au sein d'un ensemble de bâtiments ayant un nom commun. `tourist_attraction` indique un site touristique. `train_station` indique une gare ferroviaire. `transit_station` indique une station de transports en commun. Une liste de types vide indique qu'il n'y a aucun type connu pour un composant d'adresse particulier, par exemple un Lieu-dit en France.

Réponses concernant les itinéraires Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Exemples de réponses

URL

curl

JSON

XML

DirectionsResponse

routes

status

available_travel_modes

error_message

geocoded_waypoints

DirectionsRoute

bounds

copyrights

legs

overview_polyline

summary

warnings

waypoint_order

fare

Limites

northeast

southwest

LatLngLiteral

lat

lng

DirectionsLeg

end_address

end_location

start_address

start_location

steps

traffic_speed_entry

via_waypoint

arrival_time

departure_time

distance

duration

duration_in_traffic

DirectionsStep

duration

end_location

html_instructions

polyline

start_location

travel_mode

distance

maneuver

steps

transit_details

TextValueObject

text

value

DirectionsPolyline

points

TravelMode

DirectionsTransitDetails

arrival_stop

arrival_time

departure_stop

departure_time

headsign

headway

line

num_stops

trip_short_name

DirectionsTransitStop

location

name

TimeZoneTextValueObject

text

time_zone

value

DirectionsTransitLine

agencies

name

color

icon

short_name

Réponses concernant les itinéraires

`routes`

`status`

`available_travel_modes`

`error_message`

`geocoded_waypoints`

`bounds`

`copyrights`

`legs`

`overview_polyline`

`summary`

`warnings`

`waypoint_order`

`fare`

`northeast`

`southwest`

`lat`

`lng`

`end_address`

`end_location`

`start_address`

`start_location`

`steps`

`traffic_speed_entry`

`via_waypoint`

`arrival_time`

`departure_time`

`distance`

`duration`

`duration_in_traffic`

`duration`

`end_location`

`html_instructions`

`polyline`

`start_location`

`travel_mode`

`distance`

`maneuver`

`steps`

`transit_details`

`text`

`value`

`points`

`arrival_stop`

`arrival_time`

`departure_stop`

`departure_time`

`headsign`

`headway`

`line`

`num_stops`

`trip_short_name`

`location`

`name`

`text`

`time_zone`

`value`

`agencies`

`name`

`color`

`icon`

`short_name`

`text_color`

`url`

`vehicle`

`name`

`phone`

`url`

`name`

`type`

`icon`

`local_icon`

`offset_meters`

`speed_category`

`location`

`step_index`

`step_interpolation`

`currency`

`text`

`value`