Aide-mémoire sur l'API Distance Matrix

L'API Distance Matrix (ancienne) est un service Web qui renvoie la distance et la durée d'un trajet pour une matrice de points de départ et de destination, en fonction de l'itinéraire recommandé entre chaque paire. Vous pouvez définir le mode de transport (en voiture, à pied, à vélo, en transports en commun), les modes de transport en commun, les unités et l'heure de départ pour les durées basées sur le trafic. Elle renvoie du JSON ou du XML.

API Distance Matrix : informations clés

  • Produit : API Distance Matrix
  • Également appelée : API Distance Matrix (ancienne), Distance Matrix (ancienne)
  • Catégorie : Routes
  • Plate-forme : service Web (REST)
  • S'exécute sur : le serveur (code backend)
  • Étape de lancement : GA
  • Cycle de vie : Ancien
  • Remplacée par : l'API Routes
  • Présentation : Présentation de l'API Distance Matrix

API Distance Matrix : quand l'utiliser

Utilisez l'API Distance Matrix dans les cas suivants :

  • Vous gérez un projet existant pour lequel l'API Distance Matrix (ancienne version) est déjà activée et qui appelle /maps/api/distancematrix.
  • Vous avez besoin de la distance et de la durée du trajet entre plusieurs points de départ et plusieurs destinations à partir d'un serveur.
  • Vous avez besoin de connaître les durées de trajet en voiture en fonction du trafic, à l'aide de departure_time et d'un traffic_model facultatif.

Quand ne pas utiliser l'API Distance Matrix ?

  • Vous démarrez un nouveau projet Google Cloud. À partir d'octobre 2026, l'API Distance Matrix (ancienne version) ne pourra plus être activée pour les nouveaux projets. Utilisez plutôt l'API Routes.
  • Vous avez besoin de nouvelles fonctionnalités ou d'une matrice d'itinéraires de 625 éléments maximum avec des réponses diffusées (computeRouteMatrix). Utilisez plutôt l'API Routes.
  • Vous avez besoin d'un itinéraire complet avec des étapes et des polylignes entre les points, et pas seulement de valeurs de distance et de durée. Utilisez plutôt l'API Routes.

API Distance Matrix : configuration

API Distance Matrix : erreurs courantes

  • Problème : chaque requête côté serveur est limitée à 100 éléments (points de départ × destinations) et à 25 points de départ ou 25 destinations. Les requêtes plus volumineuses renvoient MAX_ELEMENTS_EXCEEDED ou MAX_DIMENSIONS_EXCEEDED. Solution : Divisez la matrice en requêtes ne contenant pas plus de 100 éléments et 25 points de départ ou destinations. Consultez /maps/documentation/distance-matrix/usage-and-billing#usage-limits.
  • Problème : Si vous ne spécifiez pas departure_time, l'itinéraire et la durée sont basés sur le trafic moyen toutes heures confondues, et aucun duration_in_traffic n'est renvoyé. Les résultats peuvent varier au fil du temps. Solution : Définissez departure_time sur now ou sur une heure ultérieure avec mode=driving pour obtenir des durées tenant compte du trafic. Notez que les requêtes de trafic sont facturées à un tarif plus élevé. Consultez /maps/documentation/distance-matrix/distance-matrix.
  • Problème : Le paramètre units ne modifie que le texte des champs de distance. La valeur de la distance est toujours exprimée en mètres. Correction : lisez distance.value comme des mètres ou utilisez distance.text pour l'affichage. Consultez /maps/documentation/distance-matrix/distance-matrix.
  • Problème : L'appel de l'API Distance Matrix (ancienne version) à partir d'un projet dans lequel elle n'est pas activée renvoie REQUEST_DENIED dans status et un error_message renvoyant vers LegacyApiNotActivatedMapError. Les assistants IA génèrent souvent du code d'API ancienne par défaut. Correction : Migrez vers l'API Routes computeRouteMatrix (avec l'en-tête X-Goog-FieldMask). N'activez l'ancienne API par formulaire qu'à court terme. Consultez /maps/legacy#LegacyApiNotActivatedMapError.