Distance Matrix API – Übersicht

Die Distance Matrix API 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 Entfernung und Reisedauer zurückgegeben.

Vorteile der Distance Matrix API

Mit der Distance Matrix API können Sie die effizientesten Reiserouten zwischen verschiedenen möglichen Start- und Zielorten ermitteln. z. B. welche Worker an Jobstandorte gesendet werden oder von welchen Lagern Pakete gesendet werden.

Was kann ich mit der Distance Matrix API tun?

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

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

  • Entfernung für eine ausgewählte Mobilitätsform
  • Entfernung in Kilometern oder Meilen
  • Geschätzte Fahrtzeit bei starkem Verkehr

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

Funktionsweise der Distance Matrix API

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

Wenn in Ihrer Anfrage beispielsweise A und B als Startort und C und D als Zielorte angegeben sind, werden die Entfernungen und die Reisezeit in der folgenden Reihenfolge zurückgegeben:

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

Das folgende Beispiel zeigt eine Anfrage für zwei Ursprünge: Washington, DC und Boston, mit dem einzigen 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

Weitere Informationen

In der folgenden Tabelle sind die über die Distance Matrix API verfügbaren Ressourcen und die zurückgegebenen Daten aufgeführt.

Datenressourcen Zurückgegebene Daten Rückgabeformat
Distanzmatrix

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

  • Entfernung und Reisezeit zwischen Start- und Zielort
  • Verkehrsdauer, wenn Sie eine Mobilitätsform und eine Abfahrtszeit angegeben haben
  • JavaScript Object Notation
  • XML

Distance Matrix API verwenden

1 Jetzt einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der nachstehenden Einrichtungsanleitung.
2 Distance Matrix-Anfrage verwenden Sobald Sie einen API-Schlüssel haben, können Sie die Distance Matrix API direkt in Ihrem Browser testen. Beispiele finden Sie im Startleitfaden unter Beispielanfragen.
3 Komplexere Anfrage erstellen Versuchen Sie es mit einer Anfrage mit mehreren Start- und Zielorten. Informieren Sie sich über optionale Parameter, um Berechnungen wie eine angegebene Abfahrtszeit oder Routenbeschränkungen einzuschränken. Weitere Informationen finden Sie unter Optionale Parameter im Leitfaden zu Distance Matrix-Anfragen und -Antworten.
4 Grundlagen von Antworten Untersuchen Sie die Datenantworten, die Sie auf die Verwendung von Distance Matrix-Daten für Ihre App vorbereiten müssen. Weitere Informationen finden Sie unter Distance Matrix-Antworten.
5 Distance Matrix-Daten in eigene Apps einbinden Anhand dieser Daten können Sie Entfernung und Reisezeit berechnen.

Verfügbare Clientbibliotheken

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

Der Java-, Python-, Go- und Node.js-Client 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 Installationsanleitungen und Beispielcode.

Nächste Schritte