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 emplacements.

Pourquoi utiliser l'API Directions ?

Avec l'API Directions, vous pouvez obtenir des itinéraires pour plusieurs modes de transport, comme 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 un itinéraire 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.
  • Vous pouvez spécifier des points de départ, de destination et de cheminement de plusieurs manières, y compris sous forme de chaînes de texte (par exemple, "Chicago, IL" 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 tient compte des éléments de voyage suivants pour déterminer l'itinéraire le plus efficace:

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

L'exemple de requête suivant renvoie des itinéraires routiers 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 la forme d'ID de lieu, d'adresses ou de coordonnées de latitude/longitude. Pour en savoir plus, consultez la section Paramètres obligatoires.

Instructions détaillées, divisées en itinéraires, étapes et instructions Pour en savoir plus, consultez la section Réponses aux itinéraires.
  • JSON
  • XML

Utiliser l'API Directions

1 Configurez votre appareil. Commencez par Configurer votre projet Google Cloud, puis suivez les instructions de configuration qui suivent.
2 Essayer la démo Une fois que vous disposez d'une clé API et d'un projet cloud, vous pouvez essayer la démonstration de la navigation sans frais. Consultez la démo de l'API Directions.
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 les exemples d'itinéraires.
4 Comprendre les principes de base des réponses Explorez les réponses aux données pour vous préparer à utiliser les données de navigation pour votre application. Pour en savoir plus, consultez la section Réponses aux données de navigation.
5 Intégrez des données de navigation 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 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 sur GitHub, où vous trouverez également des instructions d'installation et un exemple de code.

Étape suivante