Dieses Produkt oder diese Funktion hat den Status „Legacy“. Weitere Informationen zum Legacy-Status und zur Migration von Legacy- zu neueren Diensten finden Sie unter
Legacy-Produkte und ‑Funktionen.
Directions API (alte Version) – Übersicht
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Entwickler im Europäischen Wirtschaftsraum (EWR)
Die Directions API (Legacy) 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 Verkehrsmittel abrufen, z. B. für öffentliche Verkehrsmittel, das Auto, Fußwege oder Fahrradrouten.
Was kann ich mit der Directions API tun?
Mit der Directions API können Sie Routen zwischen Orten berechnen, einschließlich der folgenden Details:
- Routen für verschiedene Verkehrsmittel, darunter öffentliche Verkehrsmittel, Auto, Fußweg oder Fahrrad.
- Mehrteilige Wegbeschreibungen mit einer Reihe von Wegpunkten.
- Sie können Start- und Zielorte sowie Wegpunkte auf verschiedene Arten angeben, 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 bei der Berechnung von Routen die effizientesten Routen zurück. Bei der Ermittlung der effizientesten Route berücksichtigt das Produkt die folgenden Reiseelemente:
- Reisezeit (primär)
- Entfernung
- Anzahl der Windungen
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 zusammen mit den 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 für Wegbeschreibungen.
|
|
Directions API verwenden
| 1 |
Einrichtung |
Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Einrichtungsanleitung. |
| 2 |
Demo ausprobieren |
Sobald Sie einen API-Schlüssel und ein Cloud-Projekt haben, können Sie die Demo für Wegbeschreibungen kostenlos ausprobieren. Directions API-Demo
|
| 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 |
Grundlagen von Antworten |
Sehen Sie sich die Datenantworten an, um die Verwendung von Routendaten für Ihre App vorzubereiten. Weitere Informationen finden Sie unter Routenantworten.
|
| 5 |
Routeninformationen 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
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-31 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-31 (UTC)."],[[["\u003cp\u003eThe Directions API provides route information between locations using various transportation modes like driving, walking, transit, or bicycling.\u003c/p\u003e\n"],["\u003cp\u003eYou can customize your requests by specifying origins, destinations, waypoints, and travel preferences.\u003c/p\u003e\n"],["\u003cp\u003eThe API calculates the most efficient routes based on travel time, distance, and the number of turns.\u003c/p\u003e\n"],["\u003cp\u003eResults are available in JSON or XML format and include detailed directions, routes, legs, and steps.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries are available in Java, Python, Go, and Node.js for easy integration into your applications.\u003c/p\u003e\n"]]],[],null,["# Directions API (Legacy) overview\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nThe Directions API (Legacy) is a service that accepts an HTTP request and returns JSON or XML-formatted directions between locations.\n\nWhy use the Directions API\n--------------------------\n\nWith the Directions API, you can get directions for several modes of\ntransportation, such as transit, driving, walking, or bicycling.\n\nWhat you can do with the Directions API?\n----------------------------------------\n\nWith the Directions API, you can calculate directions between locations,\nincluding the following details:\n\n- Directions for several modes of transportation, including transit, driving, walking or bicycling.\n- Multipart directions using a series of waypoints.\n- Specify origins, destinations, and waypoints in multiple ways, including as text strings (for example, \"Chicago, IL\" or \"Darwin, NT, Australia\"), place IDs, or latitude/longitude coordinates.\n\nHow the Directions API works\n----------------------------\n\nThe Directions API returns the most efficient routes when\ncalculating directions. The product factors in the following travel elements\nwhen determining the most efficient route:\n\n- Travel time (primary)\n- Distance\n- Number of turns\n\nThe following example request returns driving directions from Toronto, Ontario to Montreal, Quebec in JSON format: \n\n```scdoc\nhttps://maps.googleapis.com/maps/api/directions/json\n ?destination=Montreal\n &origin=Toronto\n &key=YOUR_API_KEY\n```\n\n### Resources\n\nThe following table summarizes the resources available through the\nDirections API along with the data it returns.\n\n\u003cbr /\u003e\n\n| Data resources | Data returned | Return format |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| [Directions](/maps/documentation/directions/get-directions#DirectionsRequests) Supply origins and destinations in the form of place IDs, addresses, or latitude/longitude coordinates. See [required parameters](/maps/documentation/directions/get-directions#required-parameters) for details. | Detailed directions, broken into routes, legs, and steps. See [Directions responses](/maps/documentation/directions/get-directions#DirectionsResponses) for details. | - JSON - XML |\n\n\u003cbr /\u003e\n\nHow to use the Directions API\n-----------------------------\n\n|---|---------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up.** | Start with [Set up your Google Cloud project](/maps/documentation/directions/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Try the demo** | Once you have an API key and a cloud project you try out the directions demo at no charge. See [The Directions API demo](/maps/documentation/directions/start). |\n| 3 | **Build a request** | See the example requests and learn about the available options you can supply, such as travel modes, waypoints, and route restrictions. See [Directions examples](/maps/documentation/directions/get-directions#ExampleRequests). |\n| 4 | **Understand response basics** | Explore the data responses to prepare to use directions data for your app. See [Directions responses](/maps/documentation/directions/get-directions#DirectionsResponses) for details. |\n| 5 | **Incorporate direction data into your own app!** | You can use this data to calculate travel distance and time. |\n\n#### Available client libraries\n\nCall this API in the language of\nyour choice through one of the following client libraries:\n\n- [Java\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client\n for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nThe Java Client, Python Client, Go Client and Node.js Client for Google Maps\nServices are community-supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\nDownload them from GitHub, where you can also find installation instructions and sample code.\n\nWhat's next\n-----------\n\n- **Start using the Directions API** : Go to [Get started](/maps/documentation/directions/start).\n- **Start making Directions requests** : Go to [Get\n directions](/maps/documentation/directions/get-directions).\n- **Follow best practices** : Go to [Web service best\n practices](/maps/documentation/directions/web-service-best-practices)."]]
