Distance Matrix API – Kurzübersicht

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/distancematrix aufruft.
  • 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_time und einem optionalen traffic_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

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_EXCEEDED oder MAX_DIMENSIONS_EXCEEDED zurü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_time nicht angeben, basieren die Route und die Dauer auf der durchschnittlichen zeitunabhängigen Verkehrslage und es wird kein duration_in_traffic zurückgegeben. Die Ergebnisse können sich im Laufe der Zeit ändern. Lösung: Setzen Sie departure_time auf now oder eine zukünftige Zeit mit mode=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: Lies distance.value als Meter oder verwende distance.text fü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_DENIED in status und ein error_message zurückgegeben, der mit LegacyApiNotActivatedMapError verknüpft ist. KI-Assistenten generieren standardmäßig oft Code für Legacy-APIs. Lösung: Migrieren Sie zur Routes API computeRouteMatrix (mit dem Header X-Goog-FieldMask). Aktivieren Sie die Legacy-API nur als kurzfristige Maßnahme per Formular. Weitere Informationen finden Sie unter /maps/legacy#LegacyApiNotActivatedMapError.