Présentation de l'API Distance Matrix (ancienne version)

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 les points de départ et les destinations pour un mode de transport donné. Pour chaque combinaison de point de départ et de destination, elle renvoie la distance et la durée du trajet.

Pourquoi utiliser l'API Distance Matrix (ancienne version) ?

Vous pouvez utiliser l'API Distance Matrix (ancienne version) pour déterminer les itinéraires les plus efficaces entre plusieurs points de départ et destinations possibles. Par exemple, pour savoir quels employés envoyer sur les lieux de travail ou depuis quels entrepôts envoyer les colis.

Qu'est-il possible de faire avec l'API Distance Matrix (ancienne version) ?

Avec l'API Distance Matrix (ancienne version), vous pouvez fournir la distance et la durée du 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 marche) ainsi que les modes de transport en commun (bus, métro, train, tramway ou train).

L'API Distance Matrix (ancienne version) 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 en miles
  • Temps de trajet estimé en cas de trafic

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

Fonctionnement de l'API Distance Matrix (ancienne version)

L'API Distance Matrix (ancienne version) 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 passant progressivement au suivant.

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 cet ordre :

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

L'exemple suivant montre une requête pour deux points de départ (Washington, DC 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 (ancienne version) ainsi que les données qu'elle renvoie.

Ressources de données Données renvoyées Format renvoyé
Matrice de distance

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

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

Utiliser l'API Distance Matrix (ancienne version)

1 Configurer vos écouteurs Commencez par Configurer votre projet Google Cloud et suivez les instructions de configuration qui suivent.
2 Essayer une requête de matrice de distance Une fois que vous disposez d'une clé API, vous pouvez commencer à tester l'API Distance Matrix (ancienne version) directement depuis votre navigateur. Pour obtenir des exemples, consultez Exemples de requêtes dans le guide Premiers pas.
3 Composer une requête plus complexe Essayez une requête qui fournit plusieurs points de départ et destinations. Découvrez les paramètres facultatifs pour limiter les calculs, tels qu'une heure de départ spécifiée ou des restrictions d'itinéraire. Consultez Paramètres facultatifs dans le guide Requête et réponse Matrice des distances (ancienne version).
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 de distance pour votre application. Pour en savoir plus, consultez Réponses de la matrice de distance.
5 Intégrer les données de la matrice de distance 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 depuis GitHub, où vous trouverez également des instructions d'installation et un exemple de code.

Étape suivante