Présentation de l'ancienne API Directions

Développeurs de l'Espace économique européen (EEE)

L'ancienne API Directions 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

Grâce à l'API Directions, vous pouvez obtenir des itinéraires pour plusieurs modes de transport, tels que les transports en commun, la voiture, la marche ou le 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 détails suivants :

  • Instructions pour plusieurs modes de transport, y compris les transports en commun, la voiture, la marche ou le vélo.
  • Itinéraire en plusieurs étapes utilisant une série de points de passage.
  • Spécifiez les origines, les destinations et les points de passage de plusieurs manières, notamment sous forme de chaînes de texte (par exemple, « Chicago, IL » ou « Darwin, NT, 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 du calcul des directions. Le produit prend en compte les éléments de voyage suivants pour déterminer l'itinéraire le plus efficace :

  • Temps de trajet (primaire)
  • Distance
  • Nombre de tours

L'exemple de requête suivant renvoie un itinéraire routier 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 forme d'identifiants de lieu, d'adresses ou de coordonnées de latitude/longitude. Voir paramètres requis pour plus de détails.

Instructions détaillées, décomposées en itinéraires, étapes et tronçons. Voir les réponses Directions pour plus de détails.
  • JSON
  • XML

Utiliser l'API Directions

1 Installez-vous. 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 sans frais la démo des instructions. Consultez la démonstration de l'API Directions.
3 Construire une requête 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 passage et les restrictions d'itinéraire. VoirExemples de directions.
4 Comprendre les principes de base des réponses Explorez les réponses aux données pour préparer l'utilisation des 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