Einführung: Fahrzeuge entwickeln

Allgemeine Informationen zur Funktionsweise von Fahrzeugen in Fleet Engine finden Sie in den folgenden Anleitungen 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 echten Betrieb widerzuspiegeln. Die Fahrzeuge in der Fleet Engine sollten außerdem mit denen in Ihrem Backendsystem übereinstimmen, das Sie für die Fahrzeugzuweisung 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.

Fahrten auf Abruf

Geplante Aufgaben

Fahrzeuganfragen

Sowohl für On-Demand- als auch für geplante Aufgaben erstellen und aktualisieren Sie ein Fahrzeug, indem Sie eine Anfragenachricht mit den folgenden Feldern senden:

  1. Übergeordnetes Element: Ein String, der mit Ihrer Google Cloud-Projekt-ID verknüpft ist und zum Ausfüllen des Namensfelds der Fahrzeuginstanz verwendet wird.

  2. Die ID für das Fahrzeug: Ein eindeutiger String, der zum Ausfüllen des Felds name 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. Entsprechende Details finden Sie in den jeweiligen Anleitungen.

Authentifizierungs- und Autorisierungs-Tokens

Anfragen an Fleet Engine müssen außerdem die richtigen Zugriffsdaten enthalten. Bei den Beispielen in diesem Leitfaden werden die folgenden Annahmen getroffen:

  • In den gRPC-Beispielen wird die Verwendung der Autorisierungsbibliothek für Java vorausgesetzt.
  • In den REST-Beispielen wird ein HTTP-Anfrageheader dargestellt, der das Feld Authorization mit dem Wert Bearer <token> enthalten muss. Dabei ist <token> ein von dir ausgestelltes JSON-Webtoken.

Weitere Informationen finden Sie in den Anleitungen zum Einrichten der Fleet Engine.

Felder für Fahrzeugressourcen

Eine Fahrzeugressource hat die folgenden Arten von Feldern:

  • 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 gemäß den Google AIP-Richtlinien für vom Nutzer angegebene IDs alle angegebenen Werte für das Feld name des Fahrzeugs. Wenn Sie Werte für diese Felder angeben, gibt Fleet Engine einen Fehler zurück.
  • Pflichtfelder Bei Fahrzeugen, die im Dienst für Fahrten auf Abruf erstellt werden, müssen beim Erstellen bestimmte Felder festgelegt werden. Fahrzeuge, die im Dienst für geplante Aufgaben erstellt wurden, haben keine erforderlichen Felder für Fahrzeugressourcen.
  • Optionale Felder Beide Dienste haben Felder, die Sie beim Erstellen oder danach festlegen können. Sie finden sie in der jeweiligen Referenzanleitung für den von Ihnen verwendeten Dienst.

Name des Fahrzeugs (nur Ausgabe)

Das Feld name ist für Fahrten auf Abruf und geplante Aufgabendienste genau gleich. Fleet Engine definiert das Feld beim Erstellen des Fahrzeugs anhand von zwei Feldern, die Sie bei der Fahrzeugerstellung festlegen:

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

    Das hier angegebene Cloud-Projekt muss auch die Rollen für das Fleet Engine-Dienstkonto 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 und ein gültiger Unicode-String sein muss. Das ist die Ressourcen-ID des Fahrzeugs. Sowohl bei Fahrten auf Abruf als auch bei geplanten Haltestellen wird damit eine Fahrt oder Aufgabe mit dem Fahrzeug verknüpft, das sie ausführt.

In Google Cloud-basierten Diensten müssen alle APIs Ressourcen als Strings darstellen. Weitere Informationen finden Sie unter Ressourcenbenennung in der Fleet Engine.

Eindeutige Entitäts-IDs

Format und Wert der eindeutigen Entitäts-IDs, 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 Haltestellen für einen bestimmten Fahrplan abgefahren hat, kann es in Fleet Engine noch sieben Tage lang wiederverwendet werden. 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, wird die Verfügbarkeit in Fleet Engine zurückgesetzt. Der 7-tägige Countdown beginnt dann von vorn.

Um ein Fahrzeug in Fleet Engine verfügbar zu halten, sollten Sie seinen Standort in regelmäßigen Abständen aktualisieren. Aktualisierungen der meisten anderen Felder in der Entität Vehicle verlängern die Lebensdauer ebenfalls, sofern sich der neue Feldwert vom vorhandenen unterscheidet.

HINWEIS: Einige Felder der Entität Vehicle, z. B. device_settings, enthalten nur Informationen zur Fehlerbehebung, die nicht von der Fleet Engine gespeichert werden. Durch die Aktualisierung wird die Lebensdauer der Vehicle-Entität nicht verlängert.

Für bessere Systemanalysen sollten Sie die Fahrer-Fahrzeug-ID jeden Tag wiederverwenden. Verwenden Sie dazu dieselbe Fahrzeug-ID, die dem Fahrer für vorherige planmäßige Haltestellen oder Fahrten auf Abruf zugewiesen wurde.

Nächste Schritte