Présentation de l'ancienne API Directions

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 au format JSON ou XML entre des lieux.

Pourquoi utiliser l'API Directions (ancienne version) ?

L'API Directions (ancienne version) vous permet d'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 (ancienne version) ?

L'API Directions (ancienne version) 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 manières, y compris sous forme de chaînes de texte (par exemple, "Chicago, Illinois, États-Unis" ou "Darwin, Territoire du Nord, Australie"), d'ID de lieu ou de coordonnées de latitude/longitude.

Fonctionnement de l'API Directions (ancienne version)

L'API Directions (ancienne version) renvoie les itinéraires les plus efficaces lors du calcul des itinéraires. Le produit prend en compte les éléments de trajet 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 un 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 (ancienne version) ainsi que les données qu'elle renvoie.

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

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

Itinéraires détaillés, divisés en itinéraires, segments et étapes. Pour en savoir plus, consultez Réponses Directions.
  • JSON
  • XML

Comment utiliser l'API Directions (ancienne version) ?

1 Au préalable Commencez par Configurer votre projet Google Cloud et suivez les instructions de configuration qui suivent.
2 Essayez 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émo de l'API Directions (ancienne version).
3 Créer 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 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 vous préparer à utiliser les 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 :

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