Einführung: Fahrzeuge entwickeln

Allgemeine Informationen zur Funktionsweise von Fahrzeugen in Fleet Engine finden Sie in den folgenden Leitfäden im Abschnitt „Grundlagen von Fleet Engine“:

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 mit den Fahrzeugen in Ihrem Back-End-System übereinstimmen, das Sie für die Fahrzeugzuweisung und Routenplanung verwenden.

Sie verwenden eine Erstellungsmethode, um eine Fahrzeugressource zu erstellen, entweder mit gRPC oder REST. Die Feldnamen in diesem Leitfaden verwenden aus Gründen der Einfachheit die gRPC-Notation.

On-Demand-Fahrten

Geplante Aufgaben

Fahrzeuganfragen

Für On-Demand- und geplante Aufgaben erstellen und aktualisieren Sie ein Fahrzeug, indem Sie eine Anfragenachricht mit Feldern senden, die wie folgt zusammengefasst sind:

  1. Das übergeordnete Element: Ein String, der mit Ihrer Google Cloud-Projekt-ID verknüpft ist und zum Ausfüllen des Felds „Name“ der Fahrzeuginstanz verwendet wird.

  2. Die ID für das Fahrzeug: Ein eindeutiger String, der zum Ausfüllen des name Felds des Fahrzeugs verwendet wird.

  3. 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 Autorisierungstokens

Für Anfragen an Fleet Engine müssen auch die richtigen Zugangsdaten angegeben werden. Die Beispiele in diesem Leitfaden basieren auf den folgenden Annahmen:

Weitere Informationen finden Sie in den Leitfäden zum Einrichten von Fleet Engine.

Felder der Fahrzeugressource

Eine Fahrzeugressource hat die folgenden Feldtypen:

  • Felder, die nur ausgegeben werden. 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 alle angegebenen Werte für das name Feld des 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 wurden, müssen bei der Erstellung bestimmte Felder festgelegt werden. Für Fahrzeuge, die im Dienst für geplante Aufgaben erstellt wurden, sind keine Pflichtfelder für Fahrzeugressourcen vorhanden.
  • Optionale Felder. Beide Dienste haben Felder, die Sie bei der Erstellung oder später festlegen können. Diese finden Sie im jeweiligen Referenzleitfaden für den verwendeten Dienst.

Fahrzeugname (nur Ausgabe)

Das Feld name ist für On-Demand-Fahrten und geplante Aufgaben genau gleich. Fleet Engine definiert das Feld, wenn Sie das Fahrzeug erstellen, basierend auf zwei Feldern, die Sie bei der Fahrzeugerstellung festlegen:

  • Das übergeordnete Element: Ein String, der mit Ihrer Google Cloud-Projekt-ID im Format providers/{provider} verknüpft ist, wobei {provider} die ID Ihres Cloud Projekts ist. Jedes Fahrzeug, das Sie für ein bestimmtes Projekt erstellen, hat denselben übergeordneten Pfad.

    Das hier referenzierte Cloud-Projekt muss auch die Fleet Engine-Dienstkontorollen für den von Ihnen verwendeten Dienst enthalten. Eine Liste dieser Dienstkonten finden Sie unter Dienstkonten für Fleet Engine unterstützt keinen Zugriff von mehreren Google Cloud-Projekten.

  • Die ID für das Fahrzeug, die für alle Fahrzeuge in Ihrer Flotte eindeutig und ein gültiger Unicode-String sein muss. Dies ist die Ressourcen-ID für das Fahrzeug. Sowohl On-Demand-Fahrten als auch geplante Haltepunkte verwenden diese ID, um eine Fahrt oder Aufgabe mit dem Fahrzeug zu verknüpfen, 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äts-IDs

Das Format und der Wert der eindeutigen Entitäts-IDs, die in Ressourcenaufrufen verwendet werden, sind für Fleet Engine nicht sichtbar. Achten Sie darauf, dass die ID keine personenidentifizierbaren Informationen wie die Telefonnummer des Fahrers enthält.

Fahrzeug wiederverwenden

Nachdem ein Fahrzeug alle Haltepunkte für eine bestimmte Route abgeschlossen hat, bleibt es in Fleet Engine 7 Tage lang zur Wiederverwendung verfügbar. Das bedeutet, dass Sie ein Fahrzeug an nachfolgenden Arbeitstagen wiederverwenden können, ohne ein neues erstellen zu müssen. Jedes Mal, wenn Sie ein Fahrzeug wiederverwenden, setzt Fleet Engine seine Verfügbarkeit zurück. Dann beginnt der 7-Tage-Countdown von Neuem.

Die empfohlene Methode, 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-Entität wie device_settings enthalten reine Debug-Informationen, die von Fleet Engine nicht gespeichert werden. Durch das Aktualisieren dieser Felder wird die Lebensdauer der Vehicle-Entität nicht verlängert.

Für eine bessere Systemanalyse empfiehlt es sich, dieselbe Fahrer-Fahrzeug-ID-Paarung von Tag zu Tag wiederzuverwenden. Verwenden Sie dazu dieselbe Fahrzeug-ID, die dem Fahrer für frühere geplante Haltepunkte oder On-Demand-Fahrten zugewiesen wurde.

Nächste Schritte