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 und 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-/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 Anfragen zu Wegbeschreibungen.
  • JSON
  • XML

Directions API verwenden

1 Jetzt 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 In den Beispielanfragen erfahren Sie mehr über die verfügbaren Optionen, die Sie angeben können, z. B. Mobilitätsformen, Wegpunkte und Routenbeschränkungen. Beispiele für Wegbeschreibungen
4 Grundlagen von 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 Fügen Sie Wegbeschreibungsdaten in Ihre eigene App ein. Anhand dieser Daten können Sie die Entfernung und die Fahrtzeit berechnen.

Verfügbare Clientbibliotheken

Sie können diese API in der Sprache Ihrer Wahl ü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 eine Installationsanleitung und Beispielcode.

Nächste Schritte