Présentation de l'API Distance Matrix

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

Pourquoi utiliser l'API Distance Matrix ?

Vous pouvez utiliser l'API Distance Matrix pour déterminer des itinéraires entre plusieurs points de départ et destinations possibles. Pour Par exemple, quels employés envoyer sur les sites de travail ou depuis quels entrepôts envoyer packages.

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

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

L'API Distance Matrix fournit des informations en fonction de 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 le mode de transport sélectionné
  • Distance en kilomètres ou en miles
  • Temps de trajet estimé en fonction des embouteillages

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é de points de départ et de destinations, et renvoie la distance et le temps de trajet entre chacun. et toutes les destinations demandées, en commençant par la première la demande et de passer à la suivante étape par étape.

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:

  • De A à C
  • A à D
  • De B à C
  • De B à D

L'exemple suivant présente une requête pour deux origines: Washington, DC et Boston, avec une seule destination, New York City, NY, Format JSON:

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 le API Distance Matrix, ainsi que les données qu'elle renvoie.

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

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

  • la distance et le temps de trajet entre chaque point de départ et chaque point ; destination
  • Durée des embouteillages, si vous avez indiqué 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 et terminez la configuration en suivant les instructions ci-dessous.
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 depuis votre navigateur. Consultez la section Exemples de requêtes. dans le guide de démarrage pour obtenir des exemples.
3 Rédiger une requête plus complexe Essayez une requête qui fournit plusieurs points de départ et destinations. Apprendre des paramètres facultatifs pour contraindre les calculs, tels qu'une valeur l'heure de départ ou des restrictions d'itinéraire. Consultez la section Paramètres facultatifs. dans le guide Requêtes et réponses Distance Matrix.
4 Comprendre les principes de base des réponses Explorez les réponses de données pour vous préparer à utiliser les données de la matrice des distances pour votre application. Voir Réponses Distance Matrix pour en savoir plus.
5 Intégrez des données de 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 de votre choix via l'une des bibliothèques clientes suivantes:

Les clients Java, Python, Go et Node.js pour Google Maps Les services sont des bibliothèques clientes soutenues par la communauté, disponibles en Open Source dans le cadre du 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