Distance Matrix API – Übersicht

Die Distance Matrix API ist ein Dienst, der eine HTTPS-Anfrage mit Start- und Zielorten für ein bestimmtes Verkehrsmittel akzeptiert. Für jede Kombination aus Start- und Zielort werden zurückgegeben:

Vorteile der Distance Matrix API

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

Was kann ich mit der Distance Matrix API tun?

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

Die Distance Matrix API liefert Informationen basierend auf der empfohlenen Route zwischen Start- und Zielpunkt. Sie können folgende Arten von Entfernungsdaten anfordern:

  • Entfernung für eine ausgewählte Mobilitätsform
  • Entfernung in Kilometern oder Meilen
  • Geschätzte Fahrzeit bei Stau

Karte mit Start- und Zielpunkten auf einer Karte und in der API-Antwort

Funktionsweise der Distance Matrix API

Die Distance Matrix API verwendet eine beliebige Anzahl von Start- und Zielorten und gibt die Entfernung und Reisezeit zwischen jedem Start- und allen angeforderten Zielorten zurück, beginnend mit dem ersten Startort in der Anfrage und fortlaufend bis zum nächsten.

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

  • A bis C
  • A bis D
  • B2C
  • B nach D

Das folgende Beispiel zeigt eine Anfrage für zwei Startorte: Washington, DC und Boston, mit einem einzigen Zielort, 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 verfügbaren Ressourcen sowie die zurückgegebenen Daten zusammengefasst.

Datenressourcen Zurückgegebene Daten Rückgabeformat
Distance Matrix

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

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

Distance Matrix API verwenden

1 Jetzt einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung.
2 Distance Matrix-Anfrage ausprobieren Sobald Sie einen API-Schlüssel haben, können Sie die Distance Matrix API direkt in Ihrem Browser testen. Beispiele finden Sie unter Beispielanfragen in der Anleitung.
3 Komplexere Anfragen erstellen Versuchen Sie es mit einer Anfrage, die mehrere Start- und Zielorte enthält. Optionale Parameter, mit denen sich Berechnungen einschränken lassen, z. B. eine bestimmte Abfahrtszeit oder Routenbeschränkungen. Weitere Informationen finden Sie im Leitfaden Distance Matrix-Anfrage und ‑Antwort unter Optionale Parameter .
4 Grundlagen von Antworten Sehen Sie sich die Datenantworten an, um sich auf die Verwendung von Distance Matrix-Daten für Ihre App vorzubereiten. Weitere Informationen finden Sie unter Distance Matrix-Antworten.
5 Fügen Sie Daten aus der Entfernungsmatrix in Ihre eigene App ein. Anhand dieser Daten können Sie die Entfernung und die Fahrtzeit berechnen.

Verfügbare Clientbibliotheken

Sie können diese API in der Sprache Ihrer Wahl über eine der folgenden Clientbibliotheken aufrufen:

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. Sie können sie von GitHub herunterladen. Dort finden Sie auch eine Installationsanleitung und Beispielcode.

Nächste Schritte