Ce produit ou cette fonctionnalité est en version ancienne. Pour en savoir plus sur l'état "Ancien" et sur la migration des anciens services vers les nouveaux, consultez
Produits et fonctionnalités anciens.
Présentation de l'ancienne API Directions
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Développeurs de l'Espace économique européen (EEE)
L'API Directions (ancienne version) est un service qui accepte une requête HTTP et renvoie des itinéraires entre des lieux au format JSON ou XML.
Pourquoi utiliser l'API Directions ?
L'API Directions vous permet d'obtenir des itinéraires pour plusieurs modes de transport (transports en commun, voiture, marche ou vélo, par exemple).
Que pouvez-vous faire avec l'API Directions ?
L'API Directions vous permet de calculer des itinéraires entre des lieux, y compris les informations suivantes :
- Itinéraires pour plusieurs modes de transport, y compris les transports en commun, la voiture, la marche ou le vélo.
- Itinéraires multi-segments passant par une série de points de cheminement.
- Spécifiez les points de départ, les destinations et les points de cheminement de plusieurs façons, y compris sous forme de chaînes de texte (par exemple, "Chicago, IL" ou "Darwin, NT, Australie"), d'ID de lieux ou de coordonnées de latitude/longitude.
Fonctionnement de l'API Directions
L'API Directions renvoie les itinéraires les plus efficaces lors du calcul des itinéraires. Le produit tient compte des éléments de voyage suivants pour déterminer l'itinéraire le plus efficace :
- Temps de trajet (principal)
- Distance
- Nombre de tours
L'exemple de requête suivant renvoie des itinéraires en voiture de Toronto (Ontario) à Montréal (Québec) au format JSON :
https://maps.googleapis.com/maps/api/directions/json
?destination=Montreal
&origin=Toronto
&key=YOUR_API_KEY
Ressources
Le tableau suivant récapitule les ressources disponibles via l'API Directions, ainsi que les données qu'elle renvoie.
| Ressources de données |
Données renvoyées |
Format de retour |
| Directions
Indiquez les origines et les destinations sous la forme d'ID de lieu, d'adresses ou de coordonnées de latitude/longitude. Pour en savoir plus, consultez Paramètres requis.
|
Instructions détaillées, divisées en itinéraires, étapes et sous-étapes. Pour en savoir plus, consultez Réponses d'itinéraire.
|
|
Utiliser l'API Directions
| 1 |
Configurez votre appareil. |
Commencez par configurer votre projet Google Cloud, puis suivez les instructions de configuration. |
| 2 |
Essayer la démo |
Une fois que vous disposez d'une clé API et d'un projet cloud, vous pouvez essayer la démo d'itinéraire sans frais. Consultez la démonstration de l'API Directions.
|
| 3 |
Créer une demande |
Consultez les exemples de requêtes et découvrez les options disponibles que vous pouvez fournir, telles que les modes de transport, les points de cheminement et les restrictions d'itinéraire. Consultez des exemples d'itinéraires.
|
| 4 |
Comprendre les principes de base des réponses |
Explorez les réponses aux données pour vous préparer à utiliser les données d'itinéraire pour votre application. Pour en savoir plus, consultez Réponses d'itinéraire.
|
| 5 |
Intégrez des données de directions dans votre propre application. |
Vous pouvez utiliser ces données pour calculer la distance et la durée du trajet.
|
Bibliothèques clientes disponibles
Appelez cette API dans le langage de votre choix à l'aide de l'une des bibliothèques clientes suivantes :
Les clients Java, Python, Go et Node.js pour les services Google Maps sont des bibliothèques clientes alimentées par la communauté, disponibles en Open Source sous la licence Apache 2.0.
Téléchargez-les depuis GitHub, où vous trouverez également des instructions d'installation et un exemple de code.
Étape suivante
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/03 (UTC).
[null,null,["Dernière mise à jour le 2025/09/03 (UTC)."],[[["\u003cp\u003eThe Directions API provides route information between locations using various transportation modes like driving, walking, transit, or bicycling.\u003c/p\u003e\n"],["\u003cp\u003eYou can customize your requests by specifying origins, destinations, waypoints, and travel preferences.\u003c/p\u003e\n"],["\u003cp\u003eThe API calculates the most efficient routes based on travel time, distance, and the number of turns.\u003c/p\u003e\n"],["\u003cp\u003eResults are available in JSON or XML format and include detailed directions, routes, legs, and steps.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries are available in Java, Python, Go, and Node.js for easy integration into your applications.\u003c/p\u003e\n"]]],[],null,["# Directions API (Legacy) overview\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nThe Directions API (Legacy) is a service that accepts an HTTP request and returns JSON or XML-formatted directions between locations.\n\nWhy use the Directions API\n--------------------------\n\nWith the Directions API, you can get directions for several modes of\ntransportation, such as transit, driving, walking, or bicycling.\n\nWhat you can do with the Directions API?\n----------------------------------------\n\nWith the Directions API, you can calculate directions between locations,\nincluding the following details:\n\n- Directions for several modes of transportation, including transit, driving, walking or bicycling.\n- Multipart directions using a series of waypoints.\n- Specify origins, destinations, and waypoints in multiple ways, including as text strings (for example, \"Chicago, IL\" or \"Darwin, NT, Australia\"), place IDs, or latitude/longitude coordinates.\n\nHow the Directions API works\n----------------------------\n\nThe Directions API returns the most efficient routes when\ncalculating directions. The product factors in the following travel elements\nwhen determining the most efficient route:\n\n- Travel time (primary)\n- Distance\n- Number of turns\n\nThe following example request returns driving directions from Toronto, Ontario to Montreal, Quebec in JSON format: \n\n```scdoc\nhttps://maps.googleapis.com/maps/api/directions/json\n ?destination=Montreal\n &origin=Toronto\n &key=YOUR_API_KEY\n```\n\n### Resources\n\nThe following table summarizes the resources available through the\nDirections API along with the data it returns.\n\n\u003cbr /\u003e\n\n| Data resources | Data returned | Return format |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| [Directions](/maps/documentation/directions/get-directions#DirectionsRequests) Supply origins and destinations in the form of place IDs, addresses, or latitude/longitude coordinates. See [required parameters](/maps/documentation/directions/get-directions#required-parameters) for details. | Detailed directions, broken into routes, legs, and steps. See [Directions responses](/maps/documentation/directions/get-directions#DirectionsResponses) for details. | - JSON - XML |\n\n\u003cbr /\u003e\n\nHow to use the Directions API\n-----------------------------\n\n|---|---------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up.** | Start with [Set up your Google Cloud project](/maps/documentation/directions/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Try the demo** | Once you have an API key and a cloud project you try out the directions demo at no charge. See [The Directions API demo](/maps/documentation/directions/start). |\n| 3 | **Build a request** | See the example requests and learn about the available options you can supply, such as travel modes, waypoints, and route restrictions. See [Directions examples](/maps/documentation/directions/get-directions#ExampleRequests). |\n| 4 | **Understand response basics** | Explore the data responses to prepare to use directions data for your app. See [Directions responses](/maps/documentation/directions/get-directions#DirectionsResponses) for details. |\n| 5 | **Incorporate direction data into your own app!** | You can use this data to calculate travel distance and time. |\n\n#### Available client libraries\n\nCall this API in the language of\nyour choice through one of the following client libraries:\n\n- [Java\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client\n for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nThe Java Client, Python Client, Go Client and Node.js Client for Google Maps\nServices are community-supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\nDownload them from GitHub, where you can also find installation instructions and sample code.\n\nWhat's next\n-----------\n\n- **Start using the Directions API** : Go to [Get started](/maps/documentation/directions/start).\n- **Start making Directions requests** : Go to [Get\n directions](/maps/documentation/directions/get-directions).\n- **Follow best practices** : Go to [Web service best\n practices](/maps/documentation/directions/web-service-best-practices)."]]
