Kurzreferenz zum Fleet Engine-Dienst

Die Fleet Engine ist ein Backend-Dienst, der Ihre reale Fahrzeugflotte modelliert und Routen, voraussichtliche Ankunftszeiten, Verkehrsinformationen und Statusaktualisierungen für On-Demand-Fahrten und geplante Aufgaben bereitstellt. Es verwendet Standort- und Routendaten aus dem Driver SDK und funktioniert mit dem Consumer SDK und anderen Google Maps Platform APIs.

Fleet Engine-Dienst: Wichtige Fakten

  • Produkt: Fleet Engine-Dienst
  • Auch bekannt als: Fleet Engine, Fleet Engine API, Local Rides and Deliveries API
  • Kategorie: Routen
  • Plattform: Webdienst (REST)
  • Ausführung auf: Server (Backend-Code)
  • Einführungsphase: GA
  • Lebenszyklus: Aktiv
  • Übersicht: Fleet Engine-Dienst – Übersicht

Fleet Engine-Dienst: Wann sollte er verwendet werden?

Verwenden Sie den Fleet Engine-Dienst in den folgenden Fällen:

  • Sie benötigen ein Backend, das Fahrzeuge und On-Demand-Fahrten (Abholung, Wegpunkte, Absetzen) modelliert, einschließlich Fahrten mit mehreren Zielen, aufeinanderfolgenden Fahrten oder Fahrten mit mehreren Fahrgästen.
  • Sie müssen geplante Liefer- oder Serviceaufgaben modellieren, die Fahrzeugen zugewiesen sind, und deren Stopps, Ergebnisse und voraussichtliche Ankunftszeiten verfolgen.
  • Sie müssen Fahrzeuge in einer Region suchen oder auflisten, um sie angeforderten Fahrten zuzuordnen.
  • Sie benötigen die Nachverfolgung von Fahrten oder Lieferungen für Verbraucher und die Nachverfolgung für Flottenbetreiber, die durch Standortaktualisierungen des Driver SDK gespeist werden.

Verwenden Sie den Fleet Engine-Dienst nicht in den folgenden Fällen:

  • Sie möchten Live-GPS-Markierungen oder Asset-Pfade aus Ihrer eigenen Datenbank oder Ihrem eigenen Stream auf einer Webkarte anzeigen, ohne die Fahrten- oder Aufgabenorchestrierung der Fleet Engine zu verwenden. Verwenden Sie stattdessen die Maps JavaScript API.
  • Sie möchten Live-Markierungen oder -Pfade aus Ihren eigenen Daten in einer Android-App anzeigen, ohne die Fahrten- oder Aufgabenorchestrierung der Fleet Engine zu verwenden. Verwenden Sie stattdessen das Maps SDK for Android.
  • Sie möchten Live-Markierungen oder -Pfade aus Ihren eigenen Daten in einer iOS-App anzeigen, ohne die Fahrten- oder Aufgabenorchestrierung der Fleet Engine zu verwenden. Verwenden Sie stattdessen das Maps SDK for iOS.
  • Sie müssen optimierte Routenpläne für die gesamte Flotte berechnen. Die Fleet Engine akzeptiert nur Routenpläne von einem von Ihnen bereitgestellten Solver. Verwenden Sie stattdessen die Route Optimization API.

Fleet Engine-Dienst: Einrichtung

Offizielle Fleet Engine-Dienstpakete:

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

Fleet Engine-Dienst: Häufige Fehler

  • Problem: Anfragen an die Fleet Engine können gelegentlich fehlschlagen. Nach einem Fehler sind Entitäten wie Fahrzeuge möglicherweise nicht mehr vorhanden (NOT_FOUND bei Aktualisierung). Lösung: Implementieren Sie Wiederholungsversuche mit Backoff (Clientbibliotheken wiederholen standardmäßig) und erstellen Sie fehlende Fahrzeuge oder Aufgaben in ihrem aktuellen Zustand neu. Weitere Informationen finden Sie unter /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Problem: DEADLINE_EXCEEDED-Fehler treten auf, wenn eine Anfrage länger dauert als das Standardzeitlimit der Clientbibliothek. Lösung: Passen Sie die RPC-Wiederholungseinstellungen an (z. B. setTotalTimeout für VehicleServiceSettings im Java-Client). Weitere Informationen finden Sie unter /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Problem: PERMISSION_DENIED (HTTP 403), wenn im JWT die richtigen Anforderungen fehlen oder das Signaturdienstkonto nicht die erforderliche Fleet Engine-IAM-Rolle hat (z. B. „JWT does not contain a matching scope for requested trip“). Lösung: Prüfen Sie die Dienstkontorollen und achten Sie darauf, dass die JWT-Anforderungen Bereiche für das Fahrzeug, die Fahrt oder die Aufgabe enthalten, auf die zugegriffen wird. Weitere Informationen finden Sie unter /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot.
  • Problem: Bei der Migration von On-Demand Rides and Deliveries zu einem Mobility-Paket oder von der Last Mile Fleet Solution zu Mobility Activate oder Optimize geben Mobility Billing API-Anfragen HTTP 202 zurück, bis die Migration abgeschlossen ist. Es erfolgt keine Abrechnung. Lösung: Rufen Sie sowohl die Fleet Engine ReportBillableTrip als auch die Mobility Billing API von einigen Tagen vor bis zu einigen Tagen nach der Migration auf, vergleichen Sie die Anzahl der Anfragen in Cloud Logging und entfernen Sie dann die ReportBillableTrip-Aufrufe. Weitere Informationen finden Sie unter /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration.

Fleet Engine-Dienst: Legacy- und verworfene Funktionen

  • Methode UpdateVehicleLocation: Seit dem 01.05.2024 außer Betrieb genommen. Ersatz: UpdateVehicle in VehicleService. Symptom: Am 1. Februar 2024 eingestellt; im Mai 2024 außer Betrieb genommen.
  • Methode SearchFuzzedVehicles: Seit dem 01.05.2024 außer Betrieb genommen. Ersatz: SearchVehicles in VehicleService. Symptom: Am 1. Februar 2024 eingestellt; im Mai 2024 außer Betrieb genommen.
  • Methode SearchTasks: Seit dem 01.05.2024 außer Betrieb genommen. Ersatz: GetTaskTrackingInfo in DeliveryService. Symptom: Am 1. Februar 2024 eingestellt; im Mai 2024 außer Betrieb genommen.
  • ReportBillableTrip nach der Migration zu einem Mobility-Paket (On-Demand Rides and Deliveries zu einem beliebigen Paket oder Last Mile Fleet Solution zu Activate oder Optimize): Legacy. Ersatz: Mobility Billing API reportBillableEvent. Symptom: Vertragsspezifisch, keine API-Einstellung. Nach der Migration können Aufrufe die Meldung „Ungültiger Vertrag: Dieses Projekt […] ist nicht berechtigt, die Fleet Engine zu verwenden.“ zurückgeben. Weitere Informationen finden Sie in der Migrationsanleitung.

Möglichkeiten mit dem Fleet Engine-Dienst

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