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 requête
La requête suivante renvoie un itinéraire en voiture de Toronto (Ontario) à Montréal (Québec).
URL
https://maps.googleapis.com/maps/api/directions/json?destination=Montreal &origin=Toronto &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY'
En modifiant les paramètres mode et avoid, vous pouvez modifier la requête initiale pour renvoyer un itinéraire à vélo pittoresque qui évite les grands axes routiers.
URL
https://maps.googleapis.com/maps/api/directions/json ?avoid=highways &destination=Montreal &mode=bicycling &origin=Toronto &key=YOUR_API_KEYYOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&avoid=highways&mode=bicycling&key=YOUR_API_KEY'YOUR_API_KEY'
La requête suivante recherche un itinéraire en transports en commun entre Brooklyn, New York et Queens, New York. La requête ne spécifie pas de departure_time. L'heure de départ est donc définie par défaut sur l'heure actuelle :
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Queens &mode=transit &origin=Brooklyn &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&keyYOUR_API_KEY'
La requête de transport en commun suivante inclut une heure de départ spécifique.
Remarque : Dans cet exemple, l'heure de départ est définie sur le 30 juillet 2012 à 9h45. Pour éviter une erreur, vous devez remplacer le paramètre par une heure ultérieure avant d'envoyer la requête.
URL
https://maps.googleapis.com/maps/api/directions/json ?departure_time=1343641500 &destination=Queens &mode=transit &origin=Brooklyn &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&departure_time=1343641500&key=YOUR_API_KEY'
La requête suivante utilise des Plus Codes pour renvoyer un itinéraire en voiture de H8MW+WP à GCG2+3M à Calcutta, en Inde.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=GCG2%2B3M%20Kolkata%20India &origin=H8MW%2BWP%20Kolkata%20India &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=H8MW%2BWP%20Kolkata%20India&destination=GCG2%2B3M%20Kolkata%20India&key=YOUR_API_KEY'
La requête suivante renvoie un itinéraire en voiture de Glasgow (Royaume-Uni) à Perth (Royaume-Uni) à l'aide d'ID de lieu.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y &origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE &keyYOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE&destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y&key=YOUR_API_KEY'
Modes de transport
Lorsque vous calculez un itinéraire, vous pouvez spécifier le mode de transport mode à utiliser. Par défaut, les itinéraires sont calculés pour les driving. Les modes de transport suivants sont acceptés :
driving(par défaut) indique un itinéraire en voiture standard via le réseau routier.walkingdemande un itinéraire à pied via les voies piétonnes et les trottoirs (dans la mesure du possible).bicyclingdemande un itinéraire à vélo via les pistes cyclables et les rues à privilégier (dans la mesure du possible).transitdemande un itinéraire via les réseaux de transports en commun (dans la mesure du possible). Si vous définissez le mode surtransit, vous pouvez éventuellement spécifier undeparture_timeou unarrival_time. Si aucune heure n'est spécifiée,departure_timeest défini par défaut sur "now" (c'est-à-dire que l'heure de départ est définie par défaut sur l'heure actuelle). Vous pouvez également inclure untransit_modeet/ou untransit_routing_preference.
Remarque : Les itinéraires à pied et à vélo peuvent ne pas inclure de voies piétonnes ou cyclables claires. Dans ce cas, ils renvoient des warnings dans le résultat renvoyé, que vous devez afficher pour l'utilisateur.
Information sur l'état de la circulation
Les informations sur le trafic sont utilisées lorsque toutes les conditions suivantes s'appliquent (à savoir celles requises pour recevoir le champ
duration_in_traffic dans la réponse Directions) :
- Le paramètre
modede transport estdrivingou n'est pas spécifié (drivingest le mode de transport par défaut). - La requête inclut un paramètre
departure_timevalide.departure_timepeut être défini sur l'heure actuelle ou sur une heure ultérieure, mais pas sur une heure passée. - La requête n'inclut pas de points de cheminement avec arrêt. Si la requête inclut des points de cheminement, le préfixe
via:doit leur être ajouté pour influencer le trajet, mais sans ajouter d'arrêts. Par exemple,&waypoints=via:San Francisco|via:Mountain View|...
Vous pouvez éventuellement inclure le paramètre
traffic_model dans votre requête pour spécifier les hypothèses à utiliser pour calculer le temps de trajet selon le trafic.
L'URL suivante lance une requête Directions pour un trajet de Boston (Massachusetts) à Concord (Massachusetts), via Charlestown et Lexington. La requête inclut une heure de départ, ce qui répond à toutes les exigences pour renvoyer le champ duration_in_traffic dans la réponse Directions.
URL
https://maps.googleapis.com/maps/api/directions/json ?departure_time=now &destination=Concord%2C%20MA &origin=Boston%2C%20MA &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&departure_time=now&key=YOUR_API_KEY'
Repères
Lorsque vous calculez des itinéraires à l'aide de l'API Directions (ancienne), vous pouvez spécifier des points de cheminement pour renvoyer un itinéraire qui inclut des passages ou des arrêts à des lieux intermédiaires. Vous pouvez ajouter des points de cheminement aux itinéraires en voiture, à pied ou à vélo, mais pas aux itinéraires en transports en commun.
Spécifiez les emplacements dans le paramètre waypoints.
Vous pouvez fournir un ou plusieurs lieux séparés par une barre verticale (| ou %7C), sous la forme d'un ID de lieu, d'une adresse ou de coordonnées de latitude/longitude. Par défaut, le service Directions calcule un itinéraire en utilisant les points de cheminement dans l'ordre où ils sont fournis. L'ordre de priorité pour l'analyse de la valeur du point de cheminement est le suivant : ID de lieu, coordonnées de latitude/longitude, puis adresse.
- Si vous transmettez un ID de lieu, vous devez le faire précéder de
place_id:. Vous pouvez obtenir les ID de lieu via l'API Geocoding et l'API Places (y compris Place Autocomplete). Pour obtenir un exemple d'utilisation des ID de lieu de Place Autocomplete, consultez Place Autocomplete et Directions. Pour en savoir plus sur les ID de lieu, consultez la présentation des ID de lieu.Pour plus d'efficacité et de précision, utilisez des ID de lieu lorsque cela est possible. Ces ID sont explicitement uniques, comme une paire de valeurs de latitude/longitude, et offrent des avantages de géocodage pour l'itinéraire, tels que des points d'accès et des variables de trafic. Contrairement à une adresse, les ID ne nécessitent pas que le service effectue une recherche ou une requête intermédiaire pour obtenir des détails sur un lieu. Les performances sont donc meilleures.
- Si vous transmettez des coordonnées de latitude/longitude, les valeurs sont directement envoyées au serveur d'interface pour calculer l'itinéraire sans géocodage. Les points sont alignés sur les routes et peuvent ne pas fournir la précision dont votre application a besoin. Utilisez des coordonnées lorsque vous êtes certain que les valeurs spécifient réellement les points dont votre application a besoin pour l'itinéraire, sans tenir compte des points d'accès possibles ni des détails de géocodage supplémentaires. Assurez-vous que les valeurs de latitude et de longitude sont séparées par une virgule (
%2C) et non par un espace (%20). - Si vous transmettez une adresse, le service Directions géocode la chaîne et la convertit en coordonnées de latitude/longitude pour calculer l'itinéraire. Si la valeur de l'adresse est ambiguë, elle peut déclencher une recherche pour lever l'ambiguïté par rapport à des adresses similaires. Par exemple, "1st Street" peut être une valeur complète ou une valeur partielle pour "1st street NE" ou "1st St SE". Ce résultat peut être différent de celui renvoyé par l'API Geocoding. Vous pouvez éviter les erreurs d'interprétation en utilisant des ID de lieu. Consultez Résoudre les problèmes liés aux résultats de ma demande d'itinéraire.
Vous pouvez également fournir un ensemble de points encodés à l'aide de l'algorithme de polyligne encodée. Un ensemble encodé est utile pour un grand nombre de points de cheminement, car l'URL est beaucoup plus courte. Tous les services Web ont une limite d'URL de 16 384 caractères.
- Les polylignes encodées doivent être précédées de
enc:et suivies d'un signe deux-points (:). Exemple :waypoints=enc:gfo}EtohhU:. - Vous pouvez également inclure plusieurs polylignes encodées, séparées par une barre verticale (
|). Par exemple :waypoints=via:enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:| via:enc:udymA{~bxM:
L'URL suivante lance une requête d'itinéraire pour un trajet entre Boston (Massachusetts) et Concord (Massachusetts), avec des arrêts à Charlestown et Lexington, dans cet ordre. L'exemple utilise les adresses suivantes :
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Concord%2C%20MA &origin=Boston%2C%20MA &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'
Influencer les itinéraires avec des points d'arrêt et de passage
Pour chaque point de cheminement de la requête, la réponse d'itinéraire ajoute une entrée au tableau legs afin de fournir les détails des arrêts sur cette étape du trajet.
Si vous souhaitez influencer l'itinéraire à l'aide de points de cheminement sans ajouter d'arrêt, ajoutez le préfixe via: au point de cheminement. Les points de cheminement précédés du préfixe via: n'ajoutent pas d'entrée au tableau legs, mais l'itinéraire passe par le point de cheminement.
L'URL suivante modifie la requête précédente de sorte que l'itinéraire passe par Lexington sans s'arrêter :
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Concord%2C%20MA &origin=Boston%2C%20MA &waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'
Le préfixe via: est particulièrement efficace lorsque vous créez des itinéraires en réponse au déplacement des points de cheminement par l'utilisateur sur la carte. Cela permet à l'utilisateur de voir à quoi peut ressembler l'itinéraire final en temps réel et de s'assurer que les points de cheminement sont placés à des emplacements accessibles à l'API Directions (ancienne version).
L'URL suivante demande des points de cheminement utilisant des coordonnées de latitude/longitude :
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Perth%2C%20AU &origin=Sydney%2C%20AU &waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008&key=YOUR_API_KEY'
Voici la même requête utilisant une polyligne encodée :
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Perth%2C%20AU &origin=Sydney%2C%20AU &waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'
Notez que vous pouvez librement combiner un spécificateur via: avec des modificateurs d'emplacement.
Exemple :
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Perth%2C%20AU &origin=Sydney%2C%20AU &waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'
Optimiser vos points de cheminement
Par défaut, le service Directions calcule un itinéraire passant par les points de cheminement dans l'ordre fourni. Vous pouvez facultativement transmettre optimize:true comme premier argument dans le paramètre waypoints pour permettre au service Directions d'optimiser l'itinéraire fourni en réorganisant les points de cheminement dans un ordre plus efficace. (Cette optimisation est une application du
problème du voyageur de commerce.) La durée du trajet est le principal facteur optimisé, mais d'autres facteurs (tels que la distance, le nombre de bifurcations et bien d'autres) peuvent être pris en compte lors du choix de l'itinéraire le plus efficace. Tous les points de cheminement doivent être des arrêts pour que le service Directions optimise l'itinéraire.
Si vous demandez au service Directions d'optimiser l'ordre des points de cheminement, cet ordre sera renvoyé dans le champ waypoint_order de l'objet routes.
Le champ waypoint_order renvoie des valeurs basées sur zéro.
L'exemple suivant calcule un trajet routier d'Adélaïde (Australie-Méridionale) vers chacune des principales régions viticoles d'Australie-Méridionale à l'aide de l'optimisation d'itinéraire.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Adelaide%2C%20SA &origin=Adelaide%2C%20SA &waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Adelaide%2C%20SA&destination=Adelaide%2C%20SA&waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA&key=YOUR_API_KEY'
L'inspection de l'itinéraire calculé indique que le calcul utilise les points de cheminement dans l'ordre suivant :
"waypoint_order": [ 3, 2, 0, 1 ]
Restrictions
Il est possible de calculer des itinéraires qui respectent des restrictions données. Les restrictions sont indiquées à l'aide du paramètre avoid et d'un argument de ce paramètre indiquant la restriction à éviter. Les restrictions suivantes sont prises en charge :
avoid=tollsavoid=highwaysavoid=ferries
Vous pouvez demander un itinéraire qui évite toute combinaison de péages, d'autoroutes et de ferries en transmettant les deux restrictions au paramètre "avoid". Par exemple, avoid=tolls|highways|ferries.
Remarque : L'ajout de restrictions n'exclut pas les itinéraires qui incluent la caractéristique restreinte. Il oriente le résultat vers des itinéraires plus favorables.
Systèmes d'unités
Les résultats d'itinéraire contiennent des champs text dans distance qui peuvent être affichés à l'utilisateur pour indiquer la distance d'une "étape" particulière de l'itinéraire. Par défaut, ce texte utilise le système d'unités du pays ou de la région de départ.
Par exemple, un itinéraire de "Chicago, Illinois" à "Toronto, Ontario" affichera les résultats en miles, tandis que l'itinéraire inverse les affichera en kilomètres. Vous pouvez ignorer ce système d'unités en définissant explicitement celui que vous souhaitez utiliser dans le paramètre units de la requête, en transmettant l'une des valeurs suivantes :
metricspécifie l'utilisation du système métrique. Les distances textuelles sont renvoyées en utilisant des kilomètres et des mètres.imperialspécifie l'utilisation du système impérial (anglais). Les distances textuelles sont renvoyées en utilisant des miles et des pieds.
Remarque : Ce paramètre de système d'unités n'influe que sur le text affiché dans les champs distance. Les champs distance contiennent également des values, qui sont toujours exprimés en mètres.
Pondération de la région
Vous pouvez configurer le service Directions pour qu'il renvoie les résultats d'une région spécifique à l'aide du paramètre region. Ce paramètre accepte un argument ccTLD (domaine national de premier niveau) à deux caractères spécifiant la pondération régionale. La plupart des codes ccTLD sont identiques aux codes ISO 3166-1 alpha-2, à quelques exceptions près.
Par exemple, le ccTLD du Royaume-Uni est "uk" (.co.uk), tandis que son code ISO 3166-1 est "gb" (techniquement pour l'entité "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord"). Consultez Détails de la couverture Google Maps Platform pour obtenir une liste des régions prises en charge.
Vous pouvez utiliser n'importe quel domaine dans lequel l'application Google Maps principale a lancé des itinéraires en voiture.
Par exemple, une demande d'itinéraire de "Toledo" à "Madrid" renvoie des résultats appropriés lorsque region est défini sur es et que "Toledo" est interprété comme la ville espagnole :
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Madrid &origin=Toledo ®ion=es &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid®ion=es&key=YOUR_API_KEY'
JSON
{ "geocoded_waypoints": [ { "geocoder_status": "OK", "place_id": "ChIJ8f21C60Lag0R_q11auhbf8Y", "types": ["locality", "political"], }, { "geocoder_status": "OK", "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ", "types": ["locality", "political"], }, ], "routes": [ { "bounds": { "northeast": { "lat": 40.4165207, "lng": -3.7026134 }, "southwest": { "lat": 39.862808, "lng": -4.029406799999999 }, }, "copyrights": "Map data ©2022 Inst. Geogr. Nacional", "legs": [ { "distance": { "text": "74.3 km", "value": 74327 }, "duration": { "text": "57 mins", "value": 3446 }, "end_address": "Madrid, Spain", "end_location": { "lat": 40.4165207, "lng": -3.705076 }, "start_address": "Toledo, Spain", "start_location": { "lat": 39.862808, "lng": -4.0273727 }, "steps": [ { "distance": { "text": "0.6 km", "value": 615 }, "duration": { "text": "2 mins", "value": 106 }, "end_location": { "lat": 39.8681019, "lng": -4.029378299999999 }, "html_instructions": "Head <b>northwest</b> on <b>Av. de la Reconquista</b> toward <b>C. de la Diputación</b>", "polyline": { "points": "quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC", }, "start_location": { "lat": 39.862808, "lng": -4.0273727 }, "travel_mode": "DRIVING", }, // Additional steps omitted for brevity ], "traffic_speed_entry": [], "via_waypoint": [], }, ], "overview_polyline": { "points": "quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)", }, "summary": "A-42", "warnings": [], "waypoint_order": [], }, ], "status": "OK", }
XML
<DirectionsResponse> <status>OK</status> <route> <summary>A-42</summary> <leg> <step> <travel_mode>DRIVING</travel_mode> <start_location> <lat>39.8628080</lat> <lng>-4.0273727</lng> </start_location> <end_location> <lat>39.8681019</lat> <lng>-4.0293783</lng> </end_location> <polyline> <points>quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC</points> </polyline> <duration> <value>106</value> <text>2 mins</text> </duration> <html_instructions>Head <b>northwest</b> on <b>Av. de la Reconquista</b> toward <b>C. de la Diputación</b></html_instructions> <distance> <value>615</value> <text>0.6 km</text> </distance> </step> <!-- Additional steps omitted for brevity --> <duration> <value>3446</value> <text>57 mins</text> </duration> <distance> <value>74327</value> <text>74.3 km</text> </distance> <start_location> <lat>39.8628080</lat> <lng>-4.0273727</lng> </start_location> <end_location> <lat>40.4165207</lat> <lng>-3.7050760</lng> </end_location> <start_address>Toledo, Spain</start_address> <end_address>Madrid, Spain</end_address> </leg> <copyrights>Map data ©2022 Inst. Geogr. Nacional</copyrights> <overview_polyline> <points>quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)</points> </overview_polyline> <bounds> <southwest> <lat>39.8628080</lat> <lng>-4.0294068</lng> </southwest> <northeast> <lat>40.4165207</lat> <lng>-3.7026134</lng> </northeast> </bounds> </route> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJ8f21C60Lag0R_q11auhbf8Y</place_id> </geocoded_waypoint> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id> </geocoded_waypoint> </DirectionsResponse>
Une demande d'itinéraire de "Toledo" à "Madrid" envoyée sans paramètre region ne renvoie aucun résultat, car "Toledo" est interprété comme la ville de l'Ohio et non d'Espagne :
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Madrid &origin=Toledo &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid&key=YOUR_API_KEY'
JSON
{ "geocoded_waypoints": [ { "geocoder_status": "OK", "place_id": "ChIJeU4e_C2HO4gRRcM6RZ_IPHw", "types": ["locality", "political"], }, { "geocoder_status": "OK", "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ", "types": ["locality", "political"], }, ], "routes": [], "status": "ZERO_RESULTS", }
XML
<DirectionsResponse> <status>ZERO_RESULTS</status> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJeU4e_C2HO4gRRcM6RZ_IPHw</place_id> </geocoded_waypoint> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id> </geocoded_waypoint> </DirectionsResponse>
Modificateurs de position
Vous pouvez utiliser des modificateurs d'emplacement pour indiquer comment les conducteurs doivent se diriger vers un lieu donné. Pour cela, utilisez le paramètre side_of_road afin de spécifier le côté de la route à emprunter ou indiquez un cap pour préciser la bonne direction. Ces modificateurs peuvent être librement combinés avec le modificateur via: pour les points de cheminement intermédiaires.
Spécifier que les itinéraires doivent passer par un côté particulier de la route
Lorsque vous spécifiez un point de cheminement, vous pouvez demander que l'itinéraire passe par le côté de la route vers lequel le point de cheminement est orienté en utilisant le préfixe side_of_road:. Par exemple, cette requête d'itinéraire renvoie un itinéraire long afin que le véhicule se retrouve du côté de la route vers lequel le point de cheminement a été orienté :
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=side_of_road%3A37.7663444%2C-122.4412006 &origin=37.7680296%2C-122.4375126 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=37.7680296%2C-122.4375126&destination=side_of_road%3A37.7663444%2C-122.4412006&key=YOUR_API_KEY'
Lorsque vous utilisez side_of_road: avec des polylignes encodées, le paramètre est appliqué à chaque emplacement le long de la polyligne.
Le modificateur side_of_road: ne peut être utilisé qu'avec les restrictions suivantes :
- Le paramètre
modede transport estdrivingou n'est pas spécifié (drivingest le mode de transport par défaut).
Spécifier que les itinéraires doivent avoir un cap particulier
Lorsque vous spécifiez un point de cheminement, vous pouvez demander que l'itinéraire passe par ce point dans une direction particulière. Cette orientation est spécifiée avec le préfixe heading=X:, où X est une valeur entière en degrés comprise entre 0 (inclus) et 360 (exclus). Un cap de 0 indique le nord, 90 indique l'est, et ainsi de suite dans le sens des aiguilles d'une montre. Par exemple, dans cette demande d'itinéraire, l'itinéraire va vers l'est à partir du point de départ, puis fait demi-tour :
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=37.773245%2C-122.469502 &origin=heading%3D90%3A37.773279%2C-122.468780 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=heading%3D90%3A37.773279%2C-122.468780&destination=37.773245%2C-122.469502&key=YOUR_API_KEY'
Le modificateur heading=X: ne peut être utilisé qu'avec les restrictions suivantes :
- Le paramètre
modede transport estdrivingoubicycling, ou n'est pas spécifié (drivingest le mode de transport par défaut). - Le modificateur
side_of_roadn'est pas spécifié pour le même emplacement. - L'emplacement est spécifié avec une valeur de latitude/longitude. Vous ne pouvez pas utiliser
headingavec des adresses, des ID de lieu ou des polylignes encodées.