Directions API – Kurzübersicht

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/directions aufruft.
  • 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

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 LegacyApiNotActivatedMapError fehl. 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 Status ZERO_RESULTS führen. Lösung: Verwenden Sie Zwischenstopp-Wegpunkte (ohne Präfix via:), 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 Standortmodifikatoren side_of_road oder heading werden 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 Sie optimize:true, departure_time (für Autofahrten), side_of_road und heading weg, 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_time nicht in der Vergangenheit liegen. Die Anfrage schlägt dann mit INVALID_REQUEST fehl. Ohne departure_time werden für Route und Dauer durchschnittliche, zeitunabhängige Verkehrsdaten verwendet und es wird kein duration_in_traffic zurückgegeben. Lösung: Legen Sie departure_time auf now oder einen zukünftigen Zeitpunkt mit mode=driving fest, um duration_in_traffic zu erhalten. Anfragen, die duration_in_traffic zurückgeben, werden über die SKU „Directions Advanced (Pro)“ abgerechnet. Weitere Informationen finden Sie unter /maps/documentation/directions/get-directions.