Die Distance Matrix API (Legacy) ist ein Webdienst, der die Entfernung und Reisezeit für eine Matrix von Start- und Zielorten zurückgibt. Dabei wird die empfohlene Route zwischen den einzelnen Paaren verwendet. Sie können die Mobilitätsform (Auto, zu Fuß, Fahrrad, öffentliche Verkehrsmittel), die öffentlichen Verkehrsmittel, die Einheiten und die Abfahrtszeit für verkehrsabhängige Dauern festlegen. Sie gibt JSON oder XML zurück.
Distance Matrix API: Wichtige Fakten
- Produkt: Distance Matrix API
- Auch bekannt als: Distance Matrix API (Legacy), Distance Matrix (Legacy)
- Kategorie: Routen
- Plattform: Webdienst (REST)
- Ausführung auf: Server (Backend-Code)
- Einführungsphase: GA
- Lebenszyklus: Legacy
- Ersetzt durch: Routes API
- Übersicht: Distance Matrix API – Übersicht
Distance Matrix API: Wann sollte sie verwendet werden?
Verwenden Sie die Distance Matrix API, wenn:
- Sie verwalten ein bestehendes Projekt, in dem die Distance Matrix API (Legacy) bereits aktiviert ist und
/maps/api/distancematrixaufruft. - Sie benötigen die Entfernung und die Fahrzeit zwischen mehreren Start- und Zielorten von einem Server.
- Sie benötigen die Dauer im Verkehr für die Fahrt mit
departure_timeund einem optionalentraffic_model.
In folgenden Fällen sollten Sie die Distance Matrix API nicht verwenden:
- Sie starten ein neues Google Cloud-Projekt. Ab Oktober 2026 kann die Distance Matrix API (Legacy) nicht mehr für neue Projekte aktiviert werden. Verwenden Sie stattdessen die Routes API.
- Sie benötigen neue Funktionen oder eine Routenmatrix mit bis zu 625 Elementen mit gestreamten Antworten (
computeRouteMatrix). Verwenden Sie stattdessen die Routes API. - Sie benötigen eine vollständige Route mit Schritten und Polylinien zwischen Punkten, nicht nur Entfernungs- und Dauerwerte. Verwenden Sie stattdessen die Routes API.
Distance Matrix API: Einrichtung
- Zu aktivierender Dienst:
distance-matrix-backend.googleapis.com - Authentifizierung: API-Schlüssel
- Erste Schritte: Distance Matrix API einrichten
- Referenz: Distance Matrix API-Referenz
- Preise: Distance Matrix API-Nutzung und -Abrechnung
- Richtlinien: Distance Matrix API-Richtlinien
- Versionshinweise: Versionshinweise zur Distance Matrix API
Distance Matrix API: Häufige Fehler
- Problem: Jede serverseitige Anfrage ist auf 100 Elemente (Startorte × Zielorte) und auf 25 Startorte oder 25 Zielorte beschränkt. Bei größeren Anfragen wird
MAX_ELEMENTS_EXCEEDEDoderMAX_DIMENSIONS_EXCEEDEDzurückgegeben. Lösung: Teilen Sie die Matrix in Anfragen mit maximal 100 Elementen und 25 Start- oder Zielorten auf. Weitere Informationen finden Sie unter /maps/documentation/distance-matrix/usage-and-billing#usage-limits. - Problem: Wenn Sie
departure_timenicht angeben, basieren die Route und die Dauer auf der durchschnittlichen zeitunabhängigen Verkehrslage und es wird keinduration_in_trafficzurückgegeben. Die Ergebnisse können sich im Laufe der Zeit ändern. Lösung: Setzen Siedeparture_timeaufnowoder eine zukünftige Zeit mitmode=driving, um die Dauer unter Berücksichtigung der Verkehrslage zu erhalten. Anfragen mit Verkehrsinformationen werden zu einem höheren Preis abgerechnet. Weitere Informationen finden Sie unter /maps/documentation/distance-matrix/distance-matrix. - Problem: Der Parameter
unitsändert nur den Text in Entfernungsfeldern. Der Entfernungswert wird immer in Metern angegeben. Korrektur: Liesdistance.valueals Meter oder verwendedistance.textfür die Anzeige. Weitere Informationen finden Sie unter /maps/documentation/distance-matrix/distance-matrix. - Problem: Wenn die Distance Matrix API (Legacy) von einem Projekt aus aufgerufen wird, in dem sie nicht aktiviert ist, wird
REQUEST_DENIEDinstatusund einerror_messagezurückgegeben, der mitLegacyApiNotActivatedMapErrorverknüpft ist. KI-Assistenten generieren standardmäßig oft Code für Legacy-APIs. Lösung: Migrieren Sie zur Routes APIcomputeRouteMatrix(mit dem HeaderX-Goog-FieldMask). Aktivieren Sie die Legacy-API nur als kurzfristige Maßnahme per Formular. Weitere Informationen finden Sie unter /maps/legacy#LegacyApiNotActivatedMapError.