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
- Zu aktivierender Dienst:
fleetengine.googleapis.com - Authentifizierung: Dienstkonto, JSON Web Token (JWT), OAuth 2.0
- Nutzungszuordnung: Optionale Betafunktion: Legen Sie den HTTP-Header
X-Goog-Maps-Experience-IDbei Aufrufen von Diensten des Mobility-Pakets auf die Mobility-Transaktions-ID (oder eine zugehörige ID, z. B. eine Sitzungs-ID) fest. Trennen Sie mehrere IDs durch Kommas. Übergeben Sie alle zugehörigen IDs inrelated_ids, wenn Sie die Transaktion melden. - Erste Schritte: Fleet Engine-Dienst einrichten
- Referenz: Fleet Engine-Dienstreferenz
- Richtlinien: Richtlinien für den Fleet Engine-Dienst
- Versionshinweise: Versionshinweise zum Fleet Engine-Dienst
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 Service: ähnliche Produkte
- Häufig verwendet mit: Driver SDK for Android, Driver SDK for iOS, Consumer SDK for Android, Consumer SDK for iOS, JavaScript Consumer SDK, Route Optimization API
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_FOUNDbei 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.setTotalTimeoutfürVehicleServiceSettingsim 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
ReportBillableTripals 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 dieReportBillableTrip-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:UpdateVehicleinVehicleService. 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:SearchVehiclesinVehicleService. 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:GetTaskTrackingInfoinDeliveryService. Symptom: Am 1. Februar 2024 eingestellt; im Mai 2024 außer Betrieb genommen. ReportBillableTripnach 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 APIreportBillableEvent. 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.
- Abrechenbare Fleet Engine-Fahrten melden
- Erstellt eine neue Fleet Engine-Fahrt und gibt sie zurück.
- Informationen zu einer Fleet Engine-Fahrt zurückgeben
- Eine Liste aller Fleet Engine-Fahrten für ein bestimmtes Fahrzeug zurückgeben
- Fahrtdaten für eine Fleet Engine-Fahrt aktualisieren
- In Fleet Engine ein neues Fahrzeug instanziieren, das einem On-Demand-Fahrten- oder -Lieferdienst zugeordnet ist.
- Fahrzeug aus dem Fleet Engine-Dienst zurückgeben
- Gibt eine paginierte Liste von Fahrzeugen in Fleet Engine zurück, die mit einem Anbieter verknüpft sind und die angegebenen Kriterien erfüllen.
- Gibt eine Liste von Fahrzeugen in Fleet Engine zurück, die den angegebenen Kriterien entsprechen.
- Fahrzeugdaten für ein Fahrzeug in Fleet Engine aktualisieren
- Fahrzeugattribute für ein Fahrzeug in Fleet Engine aktualisieren
- Fahrtinformationen für ein Fahrzeug vom Fleet Engine-Dienst zurückgeben