Pourquoi utiliser l'API Directions ?
Avec l'API Directions, vous pouvez obtenir des itinéraires pour plusieurs modes de transport, tels que les transports en commun, la voiture, la marche à pied ou le vélo.
Que pouvez-vous faire avec l'API Directions ?
Avec l'API Directions, vous pouvez calculer des itinéraires entre des lieux et obtenir les informations suivantes:
- Itinéraires pour plusieurs modes de transport, dont les transports en commun, la voiture, la marche ou le vélo.
- Directions en plusieurs parties utilisant une série de points de cheminement.
- Spécifiez les points de départ, les destinations et les points de cheminement de plusieurs manières, y compris sous forme de chaînes de texte (par exemple, "Chicago, IL" ou "Darwin, Territoire du Nord, Australie"), d'identifiants de lieu ou de coordonnées de latitude/longitude.
Fonctionnement de l'API Directions
L'API Directions renvoie les itinéraires les plus efficaces lors de leur calcul. Le produit prend en compte les éléments de voyage suivants pour déterminer l'itinéraire le plus efficace:
- Temps de trajet (principal)
- Distance
- Nombre de virages
L'exemple de requête suivant renvoie l'itinéraire en voiture de Toronto, en Ontario, à Montréal, au 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 renvoyées.
Ressources de données | Données renvoyées | Format renvoyé |
---|---|---|
en transports en commun
Indiquez les points de départ et les destinations sous la forme d'ID de lieu, d'adresses ou de coordonnées de latitude/longitude. Pour en savoir plus, consultez les paramètres obligatoires. |
Itinéraires détaillés composés d'itinéraires, de sections et d'étapes. Pour en savoir plus, consultez Réponses Directions. |
|
Utiliser l'API Directions
1 | Configuration | Commencez par configurer votre projet Google Cloud, puis suivez les instructions de configuration qui s'affichent. |
2 | Essayer la version de démonstration | Une fois que vous disposez d'une clé API et d'un projet cloud, essayez la démonstration d'itinéraire sans frais. Consultez la démonstration de l'API Directions. |
3 | Créer une requête | Consultez les exemples de requêtes et découvrez les options que vous pouvez fournir, telles que les modes de transport, les points de cheminement et les restrictions d'itinéraire. Consultez Exemples d'itinéraires. |
4 | Comprendre les principes de base des réponses | Explorez les réponses de données pour préparer l'utilisation des données d'itinéraire pour votre application. Pour en savoir plus, consultez Réponses Directions. |
5 | Intégrez des données d'itinéraire dans votre propre application. | Vous pouvez utiliser ces données pour calculer la distance et le temps de trajet. |
Bibliothèques clientes disponibles
Appelez cette API dans le langage de votre choix via l'une des bibliothèques clientes suivantes:
- Client Java pour les services Google Maps
- Client Python pour les services Google Maps
- Client Go pour les services Google Maps
- Client Node.js pour les services Google Maps
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 sur GitHub, où vous trouverez également des instructions d'installation et des exemples de code.
Étapes suivantes
- Commencer à utiliser l'API Directions: consultez la page Premiers pas.
- Commencez à envoyer des requêtes d'itinéraire: consultez Obtenir un itinéraire.
- Suivez les bonnes pratiques: consultez les bonnes pratiques pour les services Web.