Route Optimization API – Kurzübersicht

Die Route Optimization API weist einer Fahrzeugflotte Aufgaben und Routen zu und optimiert sie anhand der von Ihnen angegebenen Ziele und Einschränkungen, z. B. Zeitfenster, Fahrzeugkapazität, Fahrerarbeitszeiten und Kosten. Sie rufen sie über REST, gRPC oder Clientbibliotheken auf. Sie gibt Besuchshierarchien, Sendungszuweisungen, geschätzte Zeiten und Routenmesswerte zurück.

Route Optimization API: Wichtige Fakten

  • Produkt: Route Optimization API
  • Alias: GMPRO
  • Kategorie: Routen
  • Plattform: Webdienst (REST)
  • Ausführung auf: Server (Backend-Code)
  • Einführungsphase: GA
  • Lebenszyklus: Aktiv
  • Übersicht: Route Optimization API – Übersicht

Route Optimization API: Wann sollte sie verwendet werden?

Verwenden Sie die Route Optimization API, wenn:

  • Sie müssen Sendungen oder Aufgaben mehreren Fahrzeugen zuweisen und dabei Zeitfenster, Fahrzeugkapazität, Arbeitszeiten der Fahrer und Kosten berücksichtigen.
  • Sie benötigen die beste Stoppreihenfolge für ein Fahrzeug mit mehreren Abholungen, Lieferungen oder Terminen.
  • Sie müssen aktive Routen für neue Aufträge (z. B. On-Demand-Versand) mit injectedFirstSolutionRoutes oder injectedSolutionConstraint neu optimieren.
  • Sie benötigen Routentokens für jeden Abschnitt eines optimierten Plans, die Sie an das Navigation SDK übergeben können.

Verwenden Sie die Route Optimization API nicht, wenn:

  • Sie benötigen ein Live-Tracking der Fahrer, um zu sehen, wie sie den Plan umsetzen. Die API gibt geplante Polylinien zurück, keine Echtzeitrouten der Fahrzeuge. Verwenden Sie stattdessen den Fleet Engine-Dienst.
  • Sie benötigen eine detaillierte Routenführung in der App für Fahrer entlang der optimierten Route. Verwenden Sie stattdessen das Navigation SDK for Android.
  • Sie benötigen eine detaillierte Routenführung in der App für Fahrer unter iOS entlang der optimierten Route. Verwenden Sie stattdessen das Navigation SDK for iOS.

Route Optimization API: Einrichtung

Offizielle Route Optimization API-Pakete:

  • npm: @googlemaps/routeoptimization
  • pypi: google-maps-routeoptimization
  • go: cloud.google.com/go/maps
  • Maven: com.google.maps:google-maps-routeoptimization

Route Optimization API: Häufige Fehler

  • Problem: Bei REST-Aufrufen an den blockierenden OptimizeTours-Endpunkt überschreibt die standardmäßige Frist von 60 Sekunden alle timeout-Werte im Anfragetext, die größer als 60 Sekunden sind. Lösung: Legen Sie den Header X-Server-Timeout (Sekunden, ohne Suffix „s“) fest, um die Frist zu verlängern. Clientbibliotheken und gRPC sind standardmäßig auf 3.600 Sekunden eingestellt. Weitere Informationen finden Sie unter /maps/documentation/route-optimization/timeouts.
  • Problem: timeout- und Fristwerte sind auf 1.800 Sekunden begrenzt. Lösung: Setzen Sie allowLargeDeadlineDespiteInterruptionRisk auf true, um bis zu 3.600 Sekunden zuzulassen. Dabei besteht ein höheres Risiko für Unterbrechungsfehler. Weitere Informationen finden Sie unter /maps/documentation/route-optimization/timeouts.
  • Problem: Ohne Kostenparameter (z. B. costPerHour oder costPerKilometer) behandelt der Optimierer alle Lösungen gleich. Lösung: Definieren Sie Kostenparameter für Fahrzeuge, die Ihre Geschäftskosten widerspiegeln. Weitere Informationen finden Sie unter /maps/documentation/route-optimization/make-first-request.
  • Problem: Mit einem API-Schlüssel authentifizierte Anfragen schlagen fehl. Für jede Anfrage ist ein OAuth-Token erforderlich. Lösung: Verwenden Sie ein OAuth-Token mit dem Bereich https://www.googleapis.com/auth/cloud-platform, z. B. über Standardanmeldedaten für Anwendungen oder ein Dienstkonto. Weitere Informationen finden Sie unter /maps/documentation/route-optimization/cloud-setup#create-an-oauth-token.

Möglichkeiten mit der Route Optimization API

In den unten verlinkten Anleitungen finden Sie Informationen zu den einzelnen Aufgaben. Sie können die Produkte auch im Capabilities Explorer vergleichen.