Distance Matrix API – Übersicht

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

Vorteile der Distance Matrix API

Mithilfe der Distance Matrix API können Sie die effizienteste Reiserouten zwischen mehreren möglichen Start- und Zielorten berechnen. Für z. B. welche Mitarbeiter zu den Baustellen oder von welchen Warenlagern zu senden sind Pakete.

Was kann ich mit der Distance Matrix API tun?

Mit der Distance Matrix API können Sie Entfernung und Reisezeit für eine Matrix von Abreise- und Zielorten. Sie können verschiedene Optionen festlegen, z. B. Mobilitätsform wie 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 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 Zielort 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 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 einem Ziel: New York City, NY, in 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 Ressourcen aufgeführt, die über die Distance Matrix API zusammen mit den zurückgegebenen Daten an.

Datenressourcen Zurückgegebene Daten Rückgabeformat
Distanzmatrix

Geben Sie Start- und Zielorte in Form von Orts-IDs, Adressen, Längen- und Breitengrade angegeben werden.

  • Entfernung und Reisezeit zwischen Start- und Zielort Ziel
  • Verkehrsdauer, wenn Sie den Fahrmodus und eine Abfahrtszeit
  • JSON
  • XML

Distance Matrix API verwenden

1 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. Siehe Beispielanfragen finden Sie im Startleitfaden Beispiele.
3 Komplexere Anfragen erstellen Versuchen Sie es mit einer Anfrage, die mehrere Start- und Zielorte enthält. Weitere Informationen über optionale Parameter zur Einschränkung von Berechnungen wie Abfahrtszeit oder Routenbeschränkungen sein. Siehe Optionale Parameter im Leitfaden Distance Matrix – Anfrage und Antwort.
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 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:

Java-, Python-, Go- und Node.js-Client für Google Maps Dienste sind von der Community unterstützte Clientbibliotheken, die im Rahmen der Apache 2.0-Lizenz. Sie können sie auf GitHub herunterladen. Dort finden Sie auch Installationsanleitungen und Beispielcode.

Nächste Schritte