API Distance Matrix

L'API Matrix calcule les temps de trajet et les distances entre chaque combinaison d'origines et de destinations en une seule requête. Les cas d'usage typiques comprennent la recherche du conducteur ou technicien le plus proche d'un chantier, la résolution de problèmes de routage de véhicules, l'estimation des fenêtres temporelles de livraison pour les clients, et le calcul de la couverture de la zone de service pour la planification des installations.

L'API Directions renvoie un seul itinéraire détaillé entre deux points, avec les instructions de virage et la géométrie. L'API Matrix renvoie un tableau de distances et de durées pour plusieurs paires origine-destination sans géométrie d'itinéraire. Si vous devez comparer efficacement de nombreux emplacements, l'API Matrix est plus rapide et plus rentable que des appels Directions individuels.

L'API prend en charge des matrices jusqu'à 100 origines par 100 destinations dans une seule requête, donnant jusqu'à 10 000 paires origine-destination par appel. Les matrices n'ont pas besoin d'être carrées : vous pouvez envoyer 1 origine par 100 destinations pour une recherche de localisation proche, ou 50 par 50 pour une attribution complète flotte-client.

L'API Matrix prend en charge la conduite, la marche, le vélo et les transports en commun. Le mode de transport est défini par requête. Toutes les paires dans une seule requête utilisent le même mode. Si vous avez besoin de résultats multi-modes, envoyez des requêtes séparées pour chaque mode et fusionnez les réponses dans votre application.

Par défaut, l'API Matrix utilise des vitesses de circulation libre représentatives des conditions de voyage typiques. Les durées ajustées au trafic en temps réel sont disponibles sur les plans éligibles. Définissez le paramètre departure_time sur un horodatage futur pour recevoir des estimations de voyage selon l'heure de la journée basées sur les modèles de trafic historiques.

Envoyez votre unique emplacement de requête comme origine et votre liste d'emplacements candidats comme destinations. L'API renvoie le temps de trajet et la distance du point de requête à chaque candidat en un seul appel. Triez la réponse par durée pour trouver l'option la plus proche. C'est nettement plus efficace que d'appeler l'API Directions en boucle pour chaque candidat.