Présentation de l'API Directions

L'API Directions est un service qui accepte une requête HTTP et renvoie des itinéraires au format JSON ou XML entre des lieux ;

Pourquoi utiliser l'API Directions ?

Avec l'API Directions, vous pouvez obtenir un itinéraire pour plusieurs modes de des moyens de transport, tels que les transports en commun, la voiture, la marche 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, avec les informations suivantes:

  • Itinéraires pour plusieurs modes de transport, dont les transports en commun, la voiture, à pied ou à vélo.
  • Itinéraire 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 différentes manières, par exemple des chaînes de texte (par exemple, "Chicago, Illinois" ou "Darwin, Territoire du Nord, Australie"), placez ou des coordonnées de latitude/longitude.

Fonctionnement de l'API Directions

L'API Directions renvoie les itinéraires les plus efficaces lorsque calculer des itinéraires. Le produit prend en compte les éléments de voyage suivants pour déterminer l'itinéraire le plus rapide:

  • Durée du trajet (principal)
  • Distance
  • Nombre de tours

L'exemple de requête suivant renvoie l'itinéraire 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 le API Directions et les données qu'elle renvoie.

Ressources de données Données renvoyées Format de retour
Directions

Indiquez les points de départ et les destinations sous forme d'ID de lieu, d'adresses ou des coordonnées de latitude/longitude. Voir les paramètres obligatoires pour en savoir plus.

Itinéraires détaillés, répartis en itinéraires, étapes et pas. Voir Réponses d'itinéraire pour en savoir plus.
  • JSON
  • XML

Utiliser l'API Directions

1 Configuration Commencez par Configurer votre Projet Google Cloud et terminez la configuration en suivant les instructions ci-dessous.
2 Essayer la version de démonstration Une fois que vous disposez d'une clé API et d'un projet Cloud, vous pouvez tester la démo de l'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 les options que vous pouvez fournir, telles que les modes de transport, les points de cheminement et des restrictions de routage. Consultez des exemples d'itinéraires.
4 Comprendre les principes de base des réponses Explorez les réponses de données afin de vous préparer à utiliser les données d'itinéraire pour votre application. Voir Réponses aux requêtes d'itinéraire pour en savoir plus.
5 Intégrez des données d'itinéraire à 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 de votre choix via l'une des bibliothèques clientes suivantes:

Les clients Java, Python, Go et Node.js pour Google Maps Les services sont des bibliothèques clientes soutenues par la communauté, disponibles en Open Source dans le cadre du 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