Allgemeine Informationen zur Funktionsweise von Fahrzeugen in Fleet Engine finden Sie in den Anleitungen im Abschnitt zu Fleet Engine:
In der Dokumentation in diesem Abschnitt wird beschrieben, wie Sie Fahrzeuge in Fleet Engine Sie erstellen Fahrzeuge in der Fleet Engine-Serverumgebung, Fahrzeugen im realen Betrieb wider. Ihre Fleet Engine sollten auch den in Ihrem Backend-System verwendeten Fahrzeugen entsprechen, für Fahrzeugzuweisungen und die Routenplanung verwenden.
Sie verwenden eine Erstellungsmethode, um eine Fahrzeugressource zu erstellen, entweder mit gRPC oder REST. Der Einfachheit halber verwenden die Feldnamen in diesem Leitfaden die gRPC-Notation.
On-Demand-Reisen
CreateVehicleRequest
(gRPC)providers.vehicle.create
(REST)Vehicle
-Ressource (REST, gRPC)
Geplante Aufgaben
CreateDeliveryVehicleRequest
(gRPC)providers.deliveryVehicles.create
(REST)DeliveryVehicle
(REST, gRPC)
Fahrzeuganfragen
Für On-Demand- und geplante Aufgaben erstellen und aktualisieren Sie Fahrzeug, indem eine Anfragenachricht mit Feldern ausgegeben wird, die wie folgt zusammengefasst sind:
- Übergeordnetes Element: ein mit Ihrer Google Cloud-Projekt-ID verknüpfter String, der verwendet wird um das Namensfeld der Fahrzeuginstanz zu füllen.
Die ID des Fahrzeugs: ein eindeutiger String, der zum Ausfüllen des
name
verwendet wird. Feld des Fahrzeugs.Eine Fahrzeuginstanz mit den erforderlichen Feldern. Diese Felder hängen von der Die von Ihnen genutzte Fleet Engine-Funktion.
Die Informationen im Anfragetext variieren je nach Art der Anfrage. Weitere Informationen finden Sie unter diese Details in den jeweiligen Leitfäden.
Authentifizierungs- und Autorisierungstoken
Anfragen an Fleet Engine müssen auch die richtigen Anmeldedaten bereitstellen. Bei den Beispielen in diesem Leitfaden wird von folgenden Annahmen ausgegangen:
- gRPC-Beispiele setzen voraus, dass die Autorisierungsbibliothek für Java verwendet wird.
- REST-Beispiele veranschaulichen einen HTTP-Anfrageheader, der den
Feld
Authorization
mit dem WertBearer <token>
, wobei<token>
ein Von Ihnen ausgestelltes JSON-Webtoken.
Weitere Informationen finden Sie in den Leitfäden Fleet Engine einrichten.
Felder für Fahrzeugressourcen
Eine Fahrzeugressource hat die folgenden Arten von Feldern:
- Nur Ausgabefelder: Felder, die vom Dienst als Ausgabe von festgelegt werden
und können nicht direkt festgelegt werden. Ein wichtiges Feld dieser
Typ ist das Feld
name
. Fleet Engine ignoriert alle angegebenen Werte für diename
Feld des Fahrzeugs gemäß Anleitung von Google AIP für vom Nutzer angegeben IDs: Wenn Sie Werte für diese Felder angeben, gibt einen Fehler zurück. - Pflichtfelder: Für Fahrzeuge, die im On-Demand-Fahrdienst erstellt wurden, ist ein dass bestimmte Felder bei der Erstellung festgelegt werden. In der geplanten Zeit erstellte Fahrzeuge Tasks-Dienst keine Pflichtfelder für Fahrzeugressourcen hat.
- Optionale Felder: Beide Dienste haben Felder, die Sie beim Erstellen festlegen können oder später. Diese finden Sie im entsprechenden Referenzhandbuch für die verwendet wird.
Fahrzeugname (nur Ausgabe)
Das Feld name
ist für On-Demand-Fahrten und geplante Aufgaben identisch.
. Fleet Engine definiert das Feld, wenn Sie das Fahrzeug erstellen,
zwei Felder, die Sie bei der Fahrzeugerstellung festgelegt haben:
Das übergeordnete Element: ein String, der mit Ihrer Google Cloud-Projekt-ID des Formular
providers/{provider}
, wobei{provider}
die ID Ihrer Cloud ist Projekt arbeiten. Jedes Fahrzeug, das Sie für ein bestimmtes Projekt erstellen, Parent-Path.Das Cloud-Projekt, auf das Sie hier verweisen, muss auch die Fleet Engine enthalten Dienstkontorollen für den von Ihnen verwendeten Dienst. Siehe Dienstkonten für eine Liste dieser Dienstkonten. Fleet Engine unterstützt keinen Zugriff von mehrere Google Cloud-Projekte erstellen.
Die ID des Fahrzeugs. Diese muss für alle Fahrzeuge in Ihrem Flotte und muss ein gültiger Unicode-String sein. Dies ist die Ressourcen-ID für den Fahrzeug. Sowohl bei On-Demand-Fahrten als auch bei geplanten Haltestellen wird dieser Wert verwendet, um oder eine Aufgabe mit dem Fahrzeug, das sie erledigt.
In Google Cloud-basierten Diensten müssen alle APIs Ressourcen als Strings darstellen. Weitere Informationen finden Sie unter Ressourcenbenennung in Fleet Engine.
Eindeutige Entitätskennungen
Das Format und der Wert der in Ressourcenaufrufen verwendeten eindeutigen Entitätskennungen sind für Fleet Engine undurchsichtig. Die Kennung darf keine personenidentifizierbare Informationen wie die Telefonnummer des Fahrers.
Wiederverwendung von Fahrzeugen
Wenn ein Fahrzeug alle Haltestellen für eine bestimmte Route beendet hat, bleibt es verfügbar Fleet Engine für 7 Tage, d. h. Sie können ein Fahrzeug ohne einen neuen erstellen zu müssen. Jedes Mal, wenn Sie ein Fahrzeug wiederverwendet, setzt Fleet Engine seine Verfügbarkeit zurück. Der 7-Tage-Countdown beginnt von vorn.
Um ein Fahrzeug in Fleet Engine verfügbar zu halten, wird empfohlen,
in regelmäßigen Abständen aktualisiert. Aktualisierungen der meisten anderen Felder im
Die Vehicle
-Entität verlängert ebenfalls ihre Lebensdauer, sofern der neue Feldwert
sich von der vorhandenen unterscheidet.
HINWEIS: Einige Felder in der Entität Vehicle
wie device_settings
dienen ausschließlich zur Fehlerbehebung.
Informationen, die nicht von Fleet Engine gespeichert werden. Das Aktualisieren
die Lebensdauer der Vehicle
-Entität verlängern.
Für eine verbesserte Systemanalyse empfiehlt es sich, dieselbe Fahrer-Fahrzeug-ID zu verwenden von Tag zu Tag zu wechseln. Verwenden Sie dazu die Fahrzeug-ID, die mit den Fahrer nach geplanten Haltestellen oder On-Demand-Fahrten fragen.