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 ?

L'API Directions vous permet d'obtenir des itinéraires pour plusieurs modes de transport (par exemple, en transports en commun, en voiture, à pied ou à vélo).

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é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 plusieurs manières, y compris sous forme de chaînes de texte (par exemple, "Chicago, Illinois" ou "Darwin, NT, Australie"), d'ID 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 du calcul d'itinéraires. Le produit prend en compte les éléments de transport suivants pour déterminer l'itinéraire le plus efficace:

  • 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 l'API Directions ainsi que les données renvoyées.

Ressources de données Données renvoyées Format de retour
en transports en commun

Indiquez les points de départ et les destinations sous forme d'ID de lieu, d'adresses ou de coordonnées de latitude/longitude. Pour en savoir plus, consultez la section Paramètres obligatoires.

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

Utiliser l'API Directions

1 Configuration Commencez par Configurer votre projet Google Cloud et suivez les instructions de configuration qui suivent.
2 Essayer la version de démonstration Une fois que vous disposez d'une clé API et d'un projet Cloud, vous pouvez essayer sans frais la démonstration des itinéraires. 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 des exemples d'itinéraires.
4 Comprendre les principes de base des réponses Explorez les réponses de données afin de préparer l'utilisation des données d'itinéraire pour votre application. Consultez la section Réponses 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 votre choix via 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 géré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.

Étapes suivantes