Distance Matrix API (Legacy) – Ü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 Reisezeit zurückgegeben.

Gründe für die Verwendung der Distance Matrix API (Legacy)

Mit der Distance Matrix API (Legacy) können Sie die effizientesten Reiserouten zwischen mehreren möglichen Start- und Zielorten ermitteln. So können Sie beispielsweise herausfinden, welche Mitarbeiter zu den Arbeitsorten geschickt werden sollen oder von welchen Lagern aus Pakete versendet werden sollen.

Möglichkeiten mit der Distance Matrix API (Legacy)

Mit der Distance Matrix API (Legacy) können Sie die Entfernung und Reisezeit für eine Matrix aus Start- und Zielorten angeben. Sie können verschiedene Optionen festlegen, z. B. die Mobilitätsform wie Autofahren, Radfahren, öffentliche Verkehrsmittel oder Zu Fuß sowie öffentliche Verkehrsmittel wie Bus, U-Bahn, Zug, Straßenbahn oder Bahn.

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

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

Karte mit Start- und Zielorten und API-Antwort

Funktionsweise der Distance Matrix API (Legacy)

Die Distance Matrix API (Legacy) 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 beispielsweise in Ihrer Anfrage A und B als Startorte und C und D als Zielorte angeben, werden die Entfernungen und Reisezeiten in dieser Reihenfolge zurückgegeben:

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

Im folgenden Beispiel wird eine Anfrage für zwei Startorte (Washington, D.C. und Boston) mit einem Zielort (New York City, NY) im JSON-Format dargestellt:

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 (Legacy) 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- und Längengradkoordinaten an.

  • Entfernung und Reisezeit zwischen jedem Start- und jedem Zielort
  • Reisezeit im Verkehr, wenn Sie die Mobilitätsform „Autofahren“ und eine Abfahrtszeit angegeben haben
  • JSON
  • XML

Verwendung der Distance Matrix API (Legacy)

1 Einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Einrichtungsanleitung.
2 Distanzmatrix-Anfrage testen Sobald Sie einen API-Schlüssel haben, können Sie die Distance Matrix API (Legacy) direkt in Ihrem Browser testen. Beispiele finden Sie unter Beispielanfragen in der Anleitung Erste Schritte.
3 Komplexere Anfrage erstellen Testen Sie eine Anfrage mit mehreren Start- und Zielorten. Informationen zu optionalen Parametern zur Einschränkung von Berechnungen, z. B. eine bestimmte Abfahrtszeit oder Routenbeschränkungen, finden Sie unter Optionale Parameter. Weitere Informationen finden Sie unter Optionale Parameter in der Anleitung Distance Matrix (Legacy)-Anfrage und -Antwort.
4 Grundlagen der Antwort verstehen Sehen Sie sich die Datenantworten an, um sich auf die Verwendung von Distanzmatrix-Daten für Ihre App vorzubereiten. Weitere Informationen finden Sie unter Distanzmatrix-Antworten.
5 Distanzmatrix-Daten in Ihre eigene App einbinden Mit diesen Daten können Sie die Entfernung und Reisezeit berechnen.

Verfügbare Clientbibliotheken

Sie können diese API in der gewünschten Sprache über eine der folgenden Clientbibliotheken aufrufen:

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