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 von 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 Einsatzorten oder von welchen Lagern entsendet werden sollen Pakete.

<ph type="x-smartling-placeholder">

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 Endpunkt. 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 den einzelnen Elementen zurück. Startort und alle angeforderten Ziele, beginnend mit dem ersten Startort in und mit dem nächsten Schritt fortfahren.

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 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 und die 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 Jetzt einrichten Beginnen Sie mit Das Google Cloud-Projekt und schließen Sie die Einrichtung ab. befolgen Sie die Anleitung.
2 Distance Matrix-Anfrage verwenden 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 Anfrage erstellen Versuchen Sie es mit einer Anfrage mit mehreren Start- und Zielorten. Weitere Informationen über optionale Parameter zur Einschränkung von Berechnungen wie Abfahrtszeit oder Routenbeschränkungen sein. Siehe Optionale Parameter im Distance Matrix-Leitfaden zu 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öchten. 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 von GitHub herunterladen. Dort finden Sie auch Installationsanleitungen und Beispielcode.

Nächste Schritte