Distance Matrix API

Die Matrix API berechnet Reisezeiten und Entfernungen zwischen jeder Kombination von Ursprüngen und Zielen in einer einzigen Anfrage. Typische Anwendungsfälle sind das Finden des nächstgelegenen Fahrers oder Technikers für einen Auftrag, das Lösen von Fahrzeugroutenproblemen, die Schätzung von Lieferzeitfenstern für Kunden sowie die Berechnung der Servicebereichsabdeckung für die Standortplanung.

Die Directions API gibt eine einzelne detaillierte Route zwischen zwei Punkten zurück, einschließlich Abbiegeanweisungen und Geometrie. Die Matrix API gibt eine Tabelle von Entfernungen und Dauern für mehrere Ursprungs-Ziel-Paare ohne Routengeometrie zurück. Wenn Sie viele Standorte effizient vergleichen müssen, ist die Matrix API schneller und kostengünstiger als einzelne Directions-Aufrufe.

Die API unterstützt Matrizen bis zu 100 Ursprüngen mal 100 Zielen in einer einzigen Anfrage, was bis zu 10.000 Ursprungs-Ziel-Paare pro Aufruf ergibt. Matrizen müssen nicht quadratisch sein: Sie können 1 Ursprung mal 100 Ziele für eine Standortsuche in der Nähe senden, oder 50 mal 50 für eine vollständige Flotte-zu-Kunde-Zuweisung.

Die Matrix API unterstützt Fahren, Gehen, Radfahren und öffentliche Verkehrsmittel. Der Reisemodus wird pro Anfrage festgelegt. Alle Paare in einer einzigen Anfrage verwenden denselben Modus. Wenn Sie Ergebnisse für mehrere Modi benötigen, senden Sie separate Anfragen für jeden Modus und zusammenführen Sie die Antworten in Ihrer Anwendung.

Standardmäßig verwendet die Matrix API freie Fahrtgeschwindigkeiten, die typische Reisebedingungen darstellen. Echtzeit-verkehrsangepasste Dauern sind auf berechtigten Plänen verfügbar. Setzen Sie den Parameter departure_time auf einen zukünftigen Zeitstempel, um tageszeit-basierte Reiseschätzungen auf Grundlage historischer Verkehrsmuster zu erhalten.

Senden Sie Ihren einzelnen Abfragestandort als Ursprung und Ihre Liste von Kandidatenstandorten als Ziele. Die API gibt die Reisezeit und Entfernung vom Abfragepunkt zu jedem Kandidaten in einem Aufruf zurück. Sortieren Sie die Antwort nach Dauer, um die nächstgelegene Option zu finden. Dies ist deutlich effizienter als das Aufrufen der Directions API in einer Schleife für jeden Kandidaten.