In diesem Dokument wird davon ausgegangen, dass Sie mit den folgenden Themen vertraut sind:
- Versandaufgaben erstellen
- Einführung in geplante Aufgaben, in der die Beziehung zwischen Aufgaben, Haltestellen und Fahrzeugen ausführlich behandelt wird
In einem realen Lieferszenario weisen Unternehmen Fahrern Lieferaufgaben zu, die dann mit einem Fahrzeug an einen geplanten Ort, z. B. eine Wohnung oder einen Lieferraum in einem Gebäudekomplex, geliefert werden. Sie modellieren dies in Fleet Engine, indem Sie eine Aufgabe erstellen und eine Anfrage zur Aktualisierung des Lieferfahrzeugs senden. Dadurch wird die Fahrzeugentität mit einer Liste der anzufahrenden Haltestellen aktualisiert. Sie weisen jeder Haltestelle eine Liste von Aufgaben zu, die an der Haltestelle erledigt werden müssen.
Sie können Fahrzeugaufgaben jederzeit aktualisieren. In der Regel tun Sie dies jedoch aus folgenden Gründen:
- Aufgaben für ein Fahrzeug planen. Sie können dies entweder mit einer Aktualisierungsanfrage tun, mit der dem Fahrzeug eine neue Haltestelle hinzugefügt wird, oder mit einer Aktualisierungsanfrage, mit der einer vorhandenen Haltestelle eine neue Aufgabe hinzugefügt wird.
- Reihenfolge vorhandener Aufgaben aktualisieren , die mit einer bestimmten Haltestelle verknüpft sind.
- Ort der Aufgabenerledigung ändern. Standardmäßig markiert Fleet Engine den Ort der Aufgabenerledigung als denselben Ort wie die Haltestelle, die mit der Aufgabe verknüpft ist. Sie können aber auch bestimmte Orte für einzelne Aufgaben angeben. Beispielsweise kann ein Fahrzeug an einem großen Komplex halten, um eine Reihe von Paketen zu liefern, denen jeweils ein bestimmter Postzustellraum zugewiesen ist.
- Alle zuvor zugewiesenen Aufgaben schließen , damit sie nicht in der aktualisierten Reihenfolge enthalten sind. Weitere Informationen finden Sie unter Aufgaben abschließen.
Lieferaufgaben planen oder ändern
Sie können Aufgaben, die einem Fahrzeug zugewiesen sind, entweder über eine Serverumgebung oder mit dem Driver SDK planen oder ändern, wenn Sie dem Fahrer die Möglichkeit geben, Aufgaben mit einem vertrauenswürdigen Gerät zu verwalten. Verwenden Sie nur eine Methode, um Race-Bedingungen zu vermeiden und eine Single Source of Truth beizubehalten.
Wenn Sie eine Lieferung von einem Fahrzeug zu einem anderen ändern möchten, schließen Sie die ursprüngliche Aufgabe und erstellen Sie sie neu, bevor Sie sie einem anderen Fahrzeug zuweisen. Wenn Sie ein Lieferfahrzeug aktualisieren, um eine Aufgabe einzubeziehen, die bereits einem anderen Fahrzeug zugewiesen ist, wird eine Fehlermeldung angezeigt.
Pflichtfelder für die Aktualisierung von Aufgaben
In diesem Abschnitt werden die Pflichtfelder beschrieben, die beim Aktualisieren einer Aufgabe für ein Fahrzeug festgelegt werden müssen. Es werden keine optionalen Felder angegeben. Fleet Engine ignoriert alle anderen Felder in der Entität für die Aktualisierung.
| Pflichtfeld | Wert |
|---|---|
remainingVehicleJourneySegments |
Eine Liste von Fahrtsegmenten für Aufgaben in der Reihenfolge, in der sie ausgeführt werden sollen. Die erste Aufgabe in der Liste wird zuerst ausgeführt. |
remainingVehicleJourneySegments[i].stop |
Die Haltestelle für Aufgabe i in der Liste. |
remainingVehicleJourneySegments[i].stop.plannedLocation |
Der geplante Ort für die Haltestelle. |
remainingVehicleJourneySegments[i].stop.tasks |
Eine Liste der Aufgaben, die an dieser Haltestelle ausgeführt werden sollen. |
remainingVehicleJourneySegments[i].stop.state |
State.NEW |
Beispiel für das Zuweisen von Aufgaben
In den folgenden Beispielen wird gezeigt, wie Sie mit der Java gRPC-Bibliothek und einem HTTP
REST-Aufruf an UpdateDeliveryVehicle zwei neue Aufgaben für das Fahrzeug hinzufügen.
gRPC
static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String VEHICLE_ID = "vehicle-8241890";
static final String TASK1_ID = "task-756390";
static final String TASK2_ID = "task-849263";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Vehicle settings
String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
DeliveryVehicle deliveryVehicle = DeliveryVehicle.newBuilder()
.addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder() // 1st stop
.setStop(VehicleStop.newBuilder()
.setPlannedLocation(LocationInfo.newBuilder()
.setPoint(LatLng.newBuilder()
.setLatitude(37.7749)
.setLongitude(122.4194)))
.addTasks(TaskInfo.newBuilder().setTaskId(TASK1_ID))
.setState(VehicleStop.State.NEW)))
.addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder() // 2nd stop
.setStop(VehicleStop.newBuilder()
.setPlannedLocation(LocationInfo.newBuilder()
.setPoint(LatLng.newBuilder()
.setLatitude(37.3382)
.setLongitude(121.8863)))
.addTasks(TaskInfo.newBuilder().setTaskId(TASK2_ID))
.setState(VehicleStop.State.NEW)))
.build();
// DeliveryVehicle request
UpdateDeliveryVehicleRequest updateDeliveryRequest =
UpdateDeliveryVehicleRequest.newBuilder() // No need for the header
.setName(vehicleName)
.setDeliveryVehicle(deliveryVehicle)
.setUpdateMask(FieldMask.newBuilder().addPaths("remaining_vehicle_journey_segments"))
.build();
try {
DeliveryVehicle updatedDeliveryVehicle =
deliveryService.updateDeliveryVehicle(updateDeliveryVehicleRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND:
break;
case PERMISSION_DENIED:
break;
}
return;
}
REST
PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<id>?updateMask=remainingVehicleJourneySegments`
<id> ist eine eindeutige Kennung für ein Lieferfahrzeug in Ihrer Flotte für das Sie die Aufgabenreihenfolge aktualisieren möchten. Es ist die Kennung, die Sie beim Erstellen des Fahrzeugs angegeben haben.
Der Anfrageheader muss ein Feld Authorization mit dem Wert Bearer <token> enthalten, wobei <token> von Ihrem Server gemäß den Richtlinien ausgegeben wird, die unter Rollen von Dienstkonten und JSON-Web-Tokens beschrieben sind.
Der Anfragetext muss eine
DeliveryVehicle-Entität enthalten.
Beispiel für einen curl-Befehl:
# Set JWT, PROJECT_ID, VEHICLE_ID, TASK1_ID, and TASK2_ID in the local
# environment
curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}?updateMask=remainingVehicleJourneySegments" \
-H "Content-type: application/json" \
-H "Authorization: Bearer ${JWT}" \
--data-binary @- << EOM
{
"remainingVehicleJourneySegments": [
{
"stop": {
"state": "NEW",
"plannedLocation": {
"point": {
"latitude": 37.7749,
"longitude": -122.084061
}
},
"tasks": [
{
"taskId": "${TASK1_ID}"
}
]
}
},
{
"stop": {
"state": "NEW",
"plannedLocation": {
"point": {
"latitude": 37.3382,
"longitude": 121.8863
}
},
"tasks": [
{
"taskId": "${TASK2_ID}"
}
]
}
}
]
}
EOM