Die Directions API (Legacy) ist ein Webdienst, der Routen zwischen Orten für Autofahrer, Fußgänger, Radfahrer und öffentliche Verkehrsmittel berechnet, einschließlich mehrteiliger Routen mit Wegpunkten. Routen, Abschnitte und Schritte werden im JSON- oder XML-Format zurückgegeben. Sie hat den Status „Legacy“: Ab Oktober 2026 kann sie nicht mehr für neue Google Cloud-Projekte aktiviert werden. Migrieren Sie zur Routes API.
Directions API: Wichtige Fakten
- Produkt: Directions API
- Auch bekannt als: Directions API (Legacy)
- Kategorie: Routen
- Plattform: Webdienst (REST)
- Ausführung auf: Server (Backend-Code)
- Einführungsphase: GA
- Lebenszyklus: Legacy
- Ersetzt durch: Routes API
- Übersicht: Directions API – Übersicht
- Regionale Verfügbarkeit: Weltweit. Die Abdeckung variiert je nach Region und Mobilitätsform (öffentliche Verkehrsmittel hängen von den Daten der Verkehrsunternehmen ab). (Details zur Abdeckung)
Directions API: Wann sollte sie verwendet werden?
Verwenden Sie die Directions API, wenn:
- Sie haben ein bestehendes Google Cloud-Projekt, in dem die Directions API (Legacy) bereits aktiviert ist und
maps/api/directionsaufruft. - Sie benötigen serverseitige Wegbeschreibungen für Autofahrten, Fußgänger, Radfahrer oder öffentliche Verkehrsmittel (Wegpunkte nur für andere Verkehrsmittel als öffentliche Verkehrsmittel) im JSON- oder XML-Format in einem vorhandenen Projekt.
Verwenden Sie die Directions API nicht, wenn:
- Sie starten ein neues Google Cloud-Projekt. Ab Oktober 2026 kann die Directions API (Legacy) nicht mehr für neue Projekte aktiviert werden. Verwenden Sie stattdessen die Routes API.
- Sie benötigen neue Routingfunktionen und eine verbesserte Leistung. Verwenden Sie stattdessen die Routes API.
- Sie benötigen Fahrtzeiten und Entfernungen für viele Start- und Zielorte in einer Anfrage. Verwenden Sie stattdessen die Routes API.
Directions API: Einrichtung
- Zu aktivierender Dienst:
directions-backend.googleapis.com - Authentifizierung: API-Schlüssel
- Erste Schritte: Directions API einrichten
- Referenz: Directions API-Referenz
- Preise: Directions API-Nutzung und -Abrechnung
- Richtlinien: Directions API-Richtlinien
- Versionshinweise: Versionshinweise zur Directions API
Directions API: Häufige Fehler
- Problem: Anfragen an die Directions API (Legacy) aus einem Projekt, in dem die Legacy API nicht aktiviert ist, schlagen mit
LegacyApiNotActivatedMapErrorfehl. Lösung: Wenn Sie der Inhaber der App sind, migrieren Sie zur Routes API. Als kurzfristige Lösung während der Migration oder bis ein App-Update verfügbar ist, können Sie die Legacy API aktivieren, indem Sie das Aktivierungsformular für die Legacy API ausfüllen. Weitere Informationen finden Sie unter /maps/legacy. - Problem: Wenn Sie das Präfix
via:für Wegpunkte verwenden, werden sie als strikte Zwischenstopps behandelt. Das kann zu erheblichen Umwegen oder zum StatusZERO_RESULTSführen. Lösung: Verwenden Sie Zwischenstopp-Wegpunkte (ohne Präfixvia:), es sei denn, es ist ein strikter Durchfahrtspunkt erforderlich. Weitere Informationen finden Sie unter /maps/documentation/directions/get-directions. - Problem: Anfragen mit 11 bis 25 Wegpunkten,
optimize:true, verkehrsabhängigen Dauern (duration_in_traffic) oder den Standortmodifikatorenside_of_roadoderheadingwerden mit der teureren SKU „Directions Advanced (Pro)“ abgerechnet. Lösung: Verwenden Sie diese Funktionen nur, wenn Sie sie benötigen. Verwenden Sie maximal 10 Wegpunkte und lassen Sieoptimize:true,departure_time(für Autofahrten),side_of_roadundheadingweg, um die Essentials-SKU zu nutzen. Weitere Informationen finden Sie unter /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku. - Problem: Für Autofahrten darf
departure_timenicht in der Vergangenheit liegen. Die Anfrage schlägt dann mitINVALID_REQUESTfehl. Ohnedeparture_timewerden für Route und Dauer durchschnittliche, zeitunabhängige Verkehrsdaten verwendet und es wird keinduration_in_trafficzurückgegeben. Lösung: Legen Siedeparture_timeaufnowoder einen zukünftigen Zeitpunkt mitmode=drivingfest, umduration_in_trafficzu erhalten. Anfragen, dieduration_in_trafficzurückgeben, werden über die SKU „Directions Advanced (Pro)“ abgerechnet. Weitere Informationen finden Sie unter /maps/documentation/directions/get-directions.