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_timeet d'untraffic_modelfacultatif.
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
- Service à activer :
distance-matrix-backend.googleapis.com - Authentification : clé API
- Premiers pas : Configurer l'API Distance Matrix
- Documentation de référence : Documentation de référence de l'API Distance Matrix
- Tarifs : Utilisation et facturation de l'API Distance Matrix
- Règles : Règles de l'API Distance Matrix
- Notes de version : Notes de version de l'API Distance Matrix
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_EXCEEDEDouMAX_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 aucunduration_in_trafficn'est renvoyé. Les résultats peuvent varier au fil du temps. Solution : Définissezdeparture_timesurnowou sur une heure ultérieure avecmode=drivingpour 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
unitsne modifie que le texte des champs de distance. La valeur de la distance est toujours exprimée en mètres. Correction : lisezdistance.valuecomme des mètres ou utilisezdistance.textpour 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_DENIEDdansstatuset unerror_messagerenvoyant versLegacyApiNotActivatedMapError. Les assistants IA génèrent souvent du code d'API ancienne par défaut. Correction : Migrez vers l'API RoutescomputeRouteMatrix(avec l'en-têteX-Goog-FieldMask). N'activez l'ancienne API par formulaire qu'à court terme. Consultez /maps/legacy#LegacyApiNotActivatedMapError.