Allgemeine Informationen zur Funktionsweise von Fahrzeugen in Fleet Engine finden Sie in den folgenden Leitfäden im Abschnitt „Fleet Engine – Grundlagen“:
In der Dokumentation in diesem Abschnitt wird beschrieben, wie Sie Fahrzeuge in Fleet Engine erstellen und verwalten. Sie erstellen Fahrzeuge in der Fleet Engine-Serverumgebung, um die tatsächlichen Fahrzeuge in Ihrem realen Betrieb abzubilden. Ihre Fleet Engine-Fahrzeuge sollten auch den Fahrzeugen in Ihrem Backend-System entsprechen, das Sie für die Zuweisung von Fahrzeugen und das Routing verwenden.
Sie verwenden eine Create-Methode, um eine Fahrzeugressource zu erstellen, entweder mit gRPC oder REST. Die Feldnamen in diesem Leitfaden verwenden der Einfachheit halber die gRPC-Notation.
On-Demand-Fahrten
CreateVehicleRequest(gRPC)providers.vehicle.create(REST)Vehicle-Ressource (REST, gRPC)
Geplante Aufgaben
CreateDeliveryVehicleRequest(gRPC)providers.deliveryVehicles.create(REST)DeliveryVehicle(REST, gRPC)
Fahrzeuganfragen
Sowohl für On-Demand- als auch für geplante Aufgaben erstellen und aktualisieren Sie ein Fahrzeug, indem Sie eine Anfragenachricht mit Feldern senden, die so zusammengefasst werden:
- Das übergeordnete Element: Ein String, der mit Ihrer Google Cloud-Projekt-ID verknüpft ist und zum Ausfüllen des Namensfelds der Fahrzeuginstanz verwendet wird.
Die ID für das Fahrzeug: ein eindeutiger String, mit dem das Feld
namedes Fahrzeugs ausgefüllt wird.Eine Fahrzeuginstanz mit den erforderlichen Feldern. Diese Felder hängen von der verwendeten Fleet Engine-Funktion ab.
Die Informationen im Anfragetext variieren je nach Art der Anfrage. Weitere Informationen finden Sie in den entsprechenden Leitfäden.
Authentifizierungs- und Autorisierungs-Tokens
Für Anfragen an Fleet Engine müssen auch die richtigen Anmeldedaten angegeben werden. Bei den Beispielen in diesem Leitfaden wird Folgendes vorausgesetzt:
- In den gRPC-Beispielen wird die Verwendung der Autorisierungsbibliothek für Java vorausgesetzt.
- REST-Beispiele veranschaulichen einen HTTP-Anfrageheader, der das Feld
Authorizationmit dem WertBearer <token>enthalten muss, wobei<token>ein von Ihnen ausgegebenes JSON-Webtoken ist.
Weitere Informationen finden Sie in den Anleitungen Fleet Engine einrichten.
Felder für Fahrzeugressourcen
Eine Fahrzeugressource hat die folgenden Feldtypen:
- Nur Ausgabefelder: Felder, die vom Dienst als Ausgabe einer anderen Methode festgelegt werden und nicht direkt festgelegt werden können. Ein wichtiges Feld dieses Typs ist das Feld
name. Fleet Engine ignoriert jeden angegebenen Wert für das Feldnamedes Fahrzeugs gemäß den Google AIP-Richtlinien für nutzerdefinierte IDs. Wenn Sie Werte für diese Felder angeben, gibt Fleet Engine einen Fehler zurück. - Pflichtfelder: Für Fahrzeuge, die im On-Demand-Fahrtdienst erstellt werden, müssen beim Erstellen bestimmte Felder festgelegt werden. Für Fahrzeuge, die im Dienst für geplante Aufgaben erstellt werden, sind keine erforderlichen Fahrzeugressourcenfelder vorhanden.
- Optionale Felder: Beide Dienste haben Felder, die Sie bei der Erstellung oder später festlegen können. Sie finden sie in der jeweiligen Referenzanleitung für den von Ihnen verwendeten Dienst.
Fahrzeugname (nur Ausgabe)
Das Feld name ist für On-Demand-Fahrten und geplante Aufgaben genau gleich. Fleet Engine definiert das Feld beim Erstellen des Fahrzeugs basierend auf zwei Feldern, die Sie beim Erstellen des Fahrzeugs festlegen:
Das übergeordnete Element: Ein String, der mit der Google Cloud-Projekt-ID Ihres Projekts verknüpft ist, in der Form
providers/{provider}, wobei{provider}die ID Ihres Cloud-Projekts ist. Jedes Fahrzeug, das Sie für ein bestimmtes Projekt erstellen, hat denselben übergeordneten Pfad.Das Cloud-Projekt, auf das Sie hier verweisen, muss auch die Fleet Engine-Dienstkontorollen für den von Ihnen verwendeten Dienst enthalten. Eine Liste dieser Dienstkonten finden Sie unter Dienstkonten. Fleet Engine unterstützt keinen Zugriff über mehrere Google Cloud-Projekte.
Die ID für das Fahrzeug, die für alle Fahrzeuge in Ihrer Flotte eindeutig sein muss und ein gültiger Unicode-String sein muss. Dies ist die Ressourcen-ID für das Fahrzeug. Sowohl bei On-Demand-Fahrten als auch bei geplanten Stopps wird damit eine Fahrt oder Aufgabe dem Fahrzeug zugewiesen, das sie ausführt.
In Google Cloud-basierten Diensten müssen alle APIs Ressourcen als Strings darstellen. Weitere Informationen finden Sie unter Ressourcennamen in Fleet Engine.
Eindeutige Entitätskennungen
Das Format und der Wert der eindeutigen Entitätskennungen, die in Ressourcenaufrufen verwendet werden, sind für Fleet Engine nicht transparent. Die Kennung darf keine personenidentifizierbaren Informationen wie die Telefonnummer des Fahrers enthalten.
Wiederverwendung von Fahrzeugen
Nachdem ein Fahrzeug alle Stopps für eine bestimmte Route abgeschlossen hat, bleibt es 7 Tage lang in Fleet Engine verfügbar. Das bedeutet, dass Sie ein Fahrzeug an den folgenden Arbeitstagen wiederverwenden können, ohne ein neues erstellen zu müssen. Jedes Mal, wenn Sie ein Fahrzeug wiederverwenden, setzt Fleet Engine die Verfügbarkeit zurück. Dann beginnt der 7‑Tage-Countdown von Neuem.
Die empfohlene Vorgehensweise, um ein Fahrzeug in Fleet Engine verfügbar zu halten, besteht darin, seinen Standort in regelmäßigen Abständen zu aktualisieren. Durch Aktualisierungen der meisten anderen Felder in der Vehicle-Entität wird auch die Lebensdauer verlängert, sofern sich der neue Feldwert vom vorhandenen unterscheidet.
HINWEIS: Einige Felder in der Vehicle-Einheit, z. B. device_settings, sind reine Debugging-Informationen, die von Fleet Engine nicht beibehalten werden. Durch das Aktualisieren wird die Lebensdauer der Vehicle-Entität nicht verlängert.
Für eine verbesserte Systemanalyse ist es am besten, jeden Tag dieselbe Fahrer-Fahrzeug-ID-Kombination zu verwenden. Verwenden Sie dazu dieselbe Fahrzeug-ID, die dem Fahrer für zuvor geplante Haltestellen oder On-Demand-Fahrten zugewiesen wurde.