Présentation de l'API Distance Matrix

L'API Distance Matrix est un service qui accepte une requête HTTPS contenant des points de départ et des destinations pour un mode de transport donné. Pour chaque combinaison de point de départ et de destination, il renvoie la distance et la durée du trajet.

Pourquoi utiliser l'API Distance Matrix ?

Vous pouvez utiliser l'API Distance Matrix pour vous aider à déterminer les itinéraires les plus efficaces entre plusieurs points de départ et destinations possibles. Par exemple, quels nœuds de calcul envoyer sur les sites de tâches ou depuis quels entrepôts envoyer des colis.

Que pouvez-vous faire avec l'API Distance Matrix ?

Avec l'API Distance Matrix, vous pouvez fournir la distance et le temps de trajet d'une matrice de points de départ et de destinations. Vous pouvez spécifier plusieurs options, y compris un moyen de transport (en voiture, à vélo, en transports en commun ou à pied, par exemple) et des modes de transport (bus, métro, train, tramway ou train).

L'API Distance Matrix fournit des informations basées sur l'itinéraire recommandé entre les points de départ et d'arrivée. Vous pouvez demander les types de données de distance suivants:

  • Distance pour un mode de transport sélectionné
  • Distance en kilomètres ou miles
  • Estimation du temps de trajet en cas de trafic

Carte montrant le point de départ et les destinations sur une carte et dans la réponse de l'API

Fonctionnement de l'API Distance Matrix

L'API Distance Matrix utilise un nombre illimité d'origines (points de départ) et de destinations, et renvoie la distance et le temps de trajet entre chaque point de départ et toutes les destinations demandées, en commençant par le premier point de départ de la requête, puis en allant jusqu'à la suivante.

Par exemple, si votre requête spécifie A et B comme points de départ, et C et D comme destinations, elle renvoie les distances et le temps de trajet dans l'ordre suivant:

  • A à C
  • A à D
  • B vers C
  • B vers D

L'exemple suivant illustre une requête au format JSON pour deux origines : Washington, DC et Boston, avec une seule destination, New York (État de New York) :

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=New%20York%20City%2C%20NY
  &origins=Washington%2C%20DC%7CBoston
  &units=imperial
  &key=YOUR_API_KEY

Ressources

Le tableau suivant récapitule les ressources disponibles via l'API Distance Matrix, ainsi que les données renvoyées.

Ressources de données Données renvoyées Format renvoyé
Distance Matrix

Indiquez les points de départ et les destinations sous la forme d'ID de lieu, d'adresses ou de coordonnées de latitude/longitude.

  • Distance et temps de trajet entre chaque point de départ et chaque destination
  • Durée du trafic si vous avez spécifié le mode Voiture et une heure de départ
  • JSON
  • XML

Utiliser l'API Distance Matrix

1 Configuration Commencez par configurer votre projet Google Cloud, puis suivez les instructions de configuration qui s'affichent.
2 Essayer une requête Distance Matrix Une fois que vous disposez d'une clé API, vous pouvez commencer à tester l'API Distance Matrix directement dans votre navigateur. Consultez la section Exemples de requêtes du guide de démarrage pour voir des exemples.
3 Saisir une requête plus complexe Essayez une requête qui fournit plusieurs points de départ et destinations. Découvrez les paramètres facultatifs permettant de contraindre les calculs, tels qu'une heure de départ spécifiée ou des restrictions d'itinéraire. Consultez la section Paramètres facultatifs du guide Requêtes et réponses Distance Matrix.
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 Distance Matrix pour votre application. Pour en savoir plus, consultez la section Réponses Distance Matrix.
5 Intégrez les données Distance Matrix à 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 sur GitHub, où vous trouverez également des instructions d'installation et des exemples de code.

Étapes suivantes