Distance Matrix API – Übersicht

Die Distance Matrix API ist ein Dienst, der HTTPS-Anfragen mit Start- und Zielorten für eine bestimmte Mobilitätsform akzeptiert. Für jede Kombination aus Start- und Zielort werden die Strecke und die Reisezeit 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. Zum Beispiel, welche Worker an Jobstandorte gesendet werden oder von welchen Lagern aus Pakete gesendet werden sollen.

Was kann ich mit der Distance Matrix API tun?

Mit der Distance Matrix API können Sie Entfernungen und Reisezeiten für eine Matrix aus Start- und Zielorten angeben. Sie können verschiedene Optionen angeben, darunter Transportmittel wie Auto, Fahrrad, öffentliche Verkehrsmittel oder zu Fuß sowie Nahverkehrsmittel wie Bus, U-Bahn, Zug, Straßenbahn oder Bahn.

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

  • Strecke für eine ausgewählte Mobilitätsform
  • Strecke in Kilometern oder Meilen
  • Geschätzte Reisezeit bei starker Verkehrslage

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

Funktionsweise der Distance Matrix API

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

Wenn in Ihrer Anfrage beispielsweise A und B als Startorte und C und D als Ziele angegeben sind, werden Entfernungen und Reisezeit in dieser Reihenfolge zurückgegeben:

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

Das folgende Beispiel zeigt eine Anfrage für zwei Ursprünge: Washington, DC und Boston mit dem 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 verfügbaren Ressourcen und 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- und Längengradkoordinaten an.

  • Entfernung und Reisezeit zwischen Start- und Zielort
  • Dauer im Verkehr, 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 zur Einrichtung.
2 Distance Matrix-Anfrage ausprobieren Sobald Sie einen API-Schlüssel haben, können Sie die Distance Matrix API direkt über Ihren Browser testen. Beispiele finden Sie im Startleitfaden unter Beispielanfragen.
3 Komplexere Anfrage erstellen Versuchen Sie es mit einer Anfrage, die mehrere Start- und Zielorte enthält. Hier finden Sie Informationen zu optionalen Parametern zur Einschränkung von Berechnungen, z. B. eine angegebene Abflugzeit oder Routeneinschränkungen. Weitere Informationen finden Sie unter Optionale Parameter im Leitfaden zu Distance Matrix-Anfragen und -Antworten.
4 Grundlagen zu Antworten Untersuchen Sie die Datenantworten, um die Verwendung von Distance Matrix-Daten für Ihre App vorzubereiten. Weitere Informationen finden Sie unter Distance Matrix-Antworten.
5 Distance Matrix-Daten in Ihre eigene App einbinden Anhand dieser Daten lassen sich Entfernung und Fahrzeit 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