Distance Matrix API (Legacy) – Übersicht

Entwickler im Europäischen Wirtschaftsraum (EWR)

Einführung

Die Distance Matrix API (Legacy) ist ein Dienst, der eine HTTPS-Anfrage mit Start- und Zielorten für eine bestimmte Mobilitätsform akzeptiert. Für jede Kombination aus Start- und Zielort werden die Entfernung und die Dauer zurückgegeben.

Gründe für die Verwendung der Distance Matrix API (Legacy)

Mit der Distance Matrix API (Legacy) können Sie die effizientesten Reiserouten zwischen mehreren möglichen Start- und Zielorten ermitteln. Beispielsweise, welche Mitarbeiter zu Arbeitsorten geschickt werden sollen oder von welchen Lagern Pakete versendet werden sollen.

Möglichkeiten mit der Distance Matrix API (Legacy)

Mit der Distance Matrix API (Legacy) können Sie die Entfernung und Zeit für eine Matrix aus Start- und Zielorten abrufen. Sie können mehrere Optionen angeben, darunter die Mobilitätsform, z. B. Auto, Fahrrad, öffentliche Verkehrsmittel oder zu Fuß, sowie die Art der öffentlichen Verkehrsmittel, z. B. Bus, U-Bahn, Zug, Straßenbahn oder Eisenbahn.

Die Distance Matrix API (Legacy) liefert Informationen basierend auf der empfohlenen Route zwischen Start- und Endpunkt. Du kannst die folgenden Arten von Entfernungsdaten anfordern:

  • Entfernung für eine ausgewählte Mobilitätsform
  • Entfernung in Kilometern oder Meilen
  • Geschätzte Reisedauer bei der aktuellen Verkehrslage

Karte, auf der Ausgangs- und Zielpunkte auf einer Karte und in der API-Antwort zu sehen sind

Funktionsweise der Distance Matrix API (Legacy)

Die Distance Matrix API (Legacy) verwendet eine beliebige Anzahl von Start- und Zielorten und gibt die Entfernung und Reisedauer zwischen jedem Startort und allen angeforderten Zielorten zurück. Dabei wird mit dem ersten Startort in der Anfrage begonnen und schrittweise zum nächsten übergegangen.

Wenn Sie in Ihrer Anfrage beispielsweise A und B als Startpunkte und C und D als Ziele angeben, werden Entfernungen und Fahrtzeiten in dieser Reihenfolge zurückgegeben:

  • A bis C
  • A bis D
  • B bis C
  • B bis D

Das folgende Beispiel zeigt eine Anfrage für zwei Startpunkte (Washington, DC und Boston) mit einem einzelnen Ziel (New York City, NY) im JSON-Format:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=New%20York%20City%2C%20NY
  &origins=Washington%2C%20DC%7CBoston
  &units=imperial
  &key=YOUR_API_KEY

Ressourcen

In der folgenden Tabelle sind die über die Distance Matrix API (Legacy) verfügbaren Ressourcen und die zurückgegebenen Daten zusammengefasst.

Datenressourcen Zurückgegebene Daten Rückgabeformat
Distanzmatrix

Geben Sie Ausgangsorte und Zielorte in Form von Orts-IDs, Adressen oder Breiten-/Längengradkoordinaten an.

  • Entfernung und Fahrtzeit zwischen jedem Start- und Zielort
  • Dauer im Verkehr, wenn Sie den Fahrmodus und eine Abfahrtszeit angegeben haben
  • JSON
  • XML

Distance Matrix API (Legacy) verwenden

1 Einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Einrichtungsanleitung.
2 Distanzmatrix-Anfrage ausprobieren Sobald Sie einen API-Schlüssel haben, können Sie die Distance Matrix API (Legacy) direkt in Ihrem Browser testen. Beispiele finden Sie unter Beispielanfragen im Startleitfaden.
3 Komplexere Anfrage erstellen Versuchen Sie es mit einer Anfrage, die mehrere Start- und Zielorte enthält. Informationen zu optionalen Parametern, mit denen Sie Berechnungen einschränken können, z. B. eine bestimmte Abfahrtszeit oder Routeneinschränkungen. Weitere Informationen finden Sie unter Optionale Parameter im Leitfaden Distanzmatrix (Legacy) – Anfrage und Antwort.
4 Grundlagen zu Antworten Sehen Sie sich die Datenantworten an, um sich auf die Verwendung von Distanzmatrixdaten für Ihre App vorzubereiten. Weitere Informationen finden Sie unter Distanzmatrixantworten.
5 Daten aus der Distanzmatrix in Ihre eigene App einbinden Anhand dieser Daten können Sie die Reisedistanz und -zeit berechnen.

Verfügbare Clientbibliotheken

Rufen Sie diese API in der Sprache Ihrer Wahl über eine der folgenden Clientbibliotheken auf:

Die Java-, Python-, Go- und Node.js-Clients für Google Maps-Dienste sind von der Community unterstützte Clientbibliotheken, die unter der Apache 2.0-Lizenz als Open Source zur Verfügung gestellt werden. Laden Sie sie von GitHub herunter. Dort finden Sie auch Installationsanleitungen und Beispielcode.

Nächste Schritte