Distance Matrix API – Ü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 der Reise zurückgegeben.

Gründe für die Verwendung der Distance Matrix API

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

Funktionen der Distance Matrix API

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

Die Distance Matrix API liefert Informationen basierend auf der empfohlenen Route zwischen Start- und Endpunkt. Sie können die folgenden Arten von Distanzdaten anfordern:

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

Karte mit Start und Zielorten und 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 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 Zielorte angeben, werden die Entfernungen und die Fahrzeit in dieser Reihenfolge zurückgegeben:

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

Das folgende Beispiel zeigt eine Anfrage für zwei Startpunkte: 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
Distanzmatrix

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

  • Entfernung und Reisezeit zwischen jedem Start- und Zielort
  • Dauer im Straßenverkehr, wenn Sie den Fahrmodus und eine Abfahrtszeit angegeben haben
  • JSON
  • XML

Distance Matrix API verwenden

1 Einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Einrichtungsanleitung.
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 im Leitfaden für den Einstieg unter Beispielanfragen.
3 Komplexere Anfragen erstellen Probieren Sie eine Anfrage mit mehreren Start- und Zielorten aus. Informationen zu optionalen Parametern zum Einschränken von Berechnungen, z. B. eine bestimmte Abfahrtszeit oder Routenbeschränkungen. Weitere Informationen finden Sie im Leitfaden Distance Matrix-Anfrage und -Antwort im Abschnitt Optionale Parameter.
4 Grundlagen zu Antworten Sehen Sie sich die Datenantworten an, 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 Mit diesen Daten können Sie die Entfernung und Reisezeit 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. Sie können sie von GitHub herunterladen. Dort finden Sie auch Installationsanleitungen und Beispielcode.

Nächste Schritte