Directions API – Übersicht

Die Directions API ist ein Dienst, der eine HTTP-Anfrage akzeptiert und Wegbeschreibungen zwischen Orten im JSON- oder XML-Format zurückgibt.

Vorteile der Directions API

Mit der Directions API können Sie Wegbeschreibungen für verschiedene Mobilitätsformen wie öffentliche Verkehrsmittel, das Auto, zu Fuß oder mit dem Fahrrad abrufen.

Was kann ich mit der Directions API tun?

Mit der Directions API können Sie Wegbeschreibungen zwischen Orten berechnen, einschließlich der folgenden Details:

  • Wegbeschreibungen für verschiedene Verkehrsmittel, einschließlich öffentlicher Verkehrsmittel, Auto, zu Fuß oder Fahrrad
  • Mehrteilige Wegbeschreibungen mit einer Reihe von Wegpunkten.
  • Start- und Zielorte sowie Wegpunkte können auf unterschiedliche Weise angegeben werden, z. B. als Textstrings (z. B. „Chicago, IL“ oder „Darwin, NT, Australien“), Orts-IDs oder Breiten-/Längengradkoordinaten.

Funktionsweise der Directions API

Die Directions API gibt die effizientesten Routen zurück, wenn Wegbeschreibungen berechnet werden. Bei der Bestimmung der effizientesten Route werden die folgenden Reiseelemente berücksichtigt:

  • Reisezeit (primär)
  • Entfernung
  • Anzahl der Umdrehungen

Die folgende Beispielanfrage gibt eine Wegbeschreibung von Toronto, Ontario, nach Montreal, Quebec, im JSON-Format zurück:

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

Ressourcen

In der folgenden Tabelle sind die über die Directions API verfügbaren Ressourcen sowie die zurückgegebenen Daten zusammengefasst.

Datenressourcen Zurückgegebene Daten Rückgabeformat
Directions

Geben Sie Start- und Zielorte in Form von Orts-IDs, Adressen oder Breiten- und Längengradkoordinaten an. Weitere Informationen finden Sie unter Erforderliche Parameter.

Detaillierte Wegbeschreibungen, unterteilt in Routen, Abschnitte und Schritte. Weitere Informationen finden Sie unter Antworten auf Wegbeschreibungsanfragen.
  • JSON
  • XML

Verwendung der Directions API

1 Einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung.
2 Demo ausprobieren Sobald Sie einen API-Schlüssel und ein Cloud-Projekt haben, können Sie die Demo für Wegbeschreibungen kostenlos ausprobieren. Demo der Directions API
3 Anfrage erstellen Sehen Sie sich die Beispielanfragen an und informieren Sie sich über die verfügbaren Optionen, die Sie angeben können, z. B. Mobilitätsformen, Wegpunkte und Routenbeschränkungen. Beispiele für Wegbeschreibungen
4 Grundlegendes zu Antworten Sehen Sie sich die Datenantworten an, um sich auf die Verwendung von Wegbeschreibungsdaten für Ihre App vorzubereiten. Weitere Informationen finden Sie unter Wegbeschreibungsantworten.
5 Wegbeschreibungsdaten in Ihre eigene App einbinden Anhand dieser 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 auf GitHub herunterladen. Dort finden Sie auch Installationsanleitungen und Beispielcode.

Nächste Schritte