Présentation de l'API Distance Matrix

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

Introduction

L'API Distance Matrix (ancienne version) 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 déterminer les itinéraires les plus efficaces entre plusieurs points de départ et destinations possibles. Par exemple, quels employés envoyer sur les sites d'intervention ou depuis quels entrepôts envoyer les colis.

Fonctionnalités de l'API Distance Matrix

L'API Distance Matrix vous permet de fournir la distance et le temps de trajet pour une matrice de points de départ et de destinations. Vous pouvez spécifier plusieurs options, y compris le mode de transport (voiture, vélo, transports en commun ou à pied) et les modes de transports en commun (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 déplacement sélectionné
  • Distance en kilomètres ou en miles
  • Durée du trajet estimée avec le trafic

Carte montrant les points de départ et de destination sur une carte et dans la réponse de l'API

Fonctionnement de l'API Distance Matrix

L'API Distance Matrix utilise un nombre quelconque de 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 et en procédant par étapes jusqu'au suivant.

Par exemple, si votre requête spécifie A et B comme origines, et C et D comme destinations, elle renvoie les distances et les temps de trajet dans cet ordre :

  • A à C
  • A à D
  • B2C
  • B2D

L'exemple suivant montre une requête pour deux origines (Washington, D.C. et Boston) avec une seule destination (New York, NY) au 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 l'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 origines et les destinations sous la forme d'ID de lieu, d'adresses ou de coordonnées de latitude/longitude.

  • Distance et durée du trajet entre chaque point de départ et chaque destination
  • Durée du trajet en voiture si vous avez spécifié le mode de conduite et une heure de départ
  • JSON
  • XML

Utiliser l'API Distance Matrix

1 Configurer Commencez par configurer votre projet Google Cloud, puis suivez les instructions de configuration.
2 Essayer une requête Distance Matrix Une fois que vous avez obtenu une clé API, vous pouvez commencer à tester l'API Distance Matrix directement depuis votre navigateur. Pour obtenir des exemples, consultez la section Exemples de requêtes du guide Premiers pas.
3 Composer une requête plus complexe Essayez une requête qui fournit plusieurs origines 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ête et réponse Distance Matrix.
4 Comprendre les principes de base des réponses Explorez les réponses aux données pour préparer l'utilisation des données de la matrice des distances pour votre application. Pour en savoir plus, consultez Réponses de la matrice des distances.
5 Intégrez les données de la matrice des distances 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