In diesem Dokument wird davon ausgegangen, dass Sie den Einführungsleitfaden zu [Geplanten Aufgaben][1] im Abschnitt Einführung in die Fleet Engine sowie [Was ist eine geplante Aufgabe?][2] in diesem Abschnitt gelesen haben.
Fleet Engine für geplante Aufgaben bietet verschiedene allgemeine Kategorien von Aufgaben:
- Versandaufgaben: Verwenden Sie diese Option für Fahraufgaben, einschließlich Abholung und Lieferung von Sendungen.
- Aufgaben für Nichtverfügbarkeit: Verwenden Sie diese Option für Zeiten, in denen Fahrer nicht verfügbar sind, z. B. bei erforderlichen Pausen.
- Geplante Stoppaufgaben: Verwenden Sie diese Option für Aufgaben, die nicht mit dem Fahren zusammenhängen, z. B. an Abgabestellen oder Kundenstandorten, z. B. die Zeit, die benötigt wird, um ein Gebäude zu betreten oder einen Lieferort zu finden.
In diesem Dokument wird beschrieben, wie Sie Lieferaufgaben auf Ihrem Server erstellen. Informationen zu anderen Aufgabentypen finden Sie unter Andere Aufgabentypen erstellen.
Felder für Versandaufgaben
In diesem Abschnitt werden die Aufgabenfelder beschrieben, die sowohl für Abhol- als auch für Lieferaufgaben erforderlich sind.
Erforderliche Aufgabenfelder
Für jede Aufgabe, die Sie in der Fleet Engine erstellen, müssen Sie die erforderlichen Felder angeben. Sie können auch optionale Felder angeben. Die Fleet Engine ignoriert alle anderen Felder und löst eine Ausnahme aus, wenn eine Anfrage zum Erstellen einer Aufgabe eine zugewiesene deliveryVehicleId enthält. Verwenden Sie UpdateDeliveryVehicleRequest, um einem Fahrzeug Aufgaben zuzuweisen. Weitere Informationen finden Sie unter Aufgaben aktualisieren.
| Feld | Wert |
|---|---|
type |
Legen Sie den Typ fest, der dem Aufgabentyp entspricht. Dies ist einer der folgenden:
|
state |
State.OPEN |
task_id |
Eindeutige Aufgaben-ID. Dies darf nicht die Sendungsnummer der Sendung sein. Wenn Sie keine Aufgaben-IDs in Ihrem System haben, können Sie einen Universally Unique Identifier (UUID) generieren. Weitere Informationen finden Sie unter Aufgaben-IDs. |
tracking_id |
Nur für PICKUP- oder DELIVERY-Aufgaben:
Die Nummer oder Kennung, die Sie zum Verfolgen einer Sendung verwenden. Geben Sie dieses Feld nicht für Aufgaben an, die keine Lieferungen sind. |
planned_location |
Nur PICKUP-, DELIVERY- oder SCHEDULED_STOP-Aufgaben: Der Ort, an dem die Aufgabe ausgeführt werden soll. Nicht erforderlich für UNAVAILABLE-Aufgaben. |
task_duration |
Die erwartete Zeit, die für die Erledigung der Aufgabe benötigt wird. Beispielsweise, um einen Parkplatz zu suchen oder zum Übergabeort zu gehen. |
Optionale Felder für Lieferaufgaben
| Feld | Wert |
|---|---|
target_time_window |
Das Zeitfenster, in dem die Aufgabe erledigt werden soll. Dieses Feld hat keinen Einfluss auf das Routingverhalten. |
task_tracking_view_config |
Nur PICKUP- oder DELIVERY-Aufgaben:
Die Konfiguration für das Aufgaben-Tracking, die festlegt, welche Datenelemente unter welchen Umständen für die Endnutzer sichtbar sind. |
attributes |
Eine Liste benutzerdefinierter Aufgabenattribute. Jedes Attribut muss einen eindeutigen Schlüssel haben. |
Aufgabe für die Abholung einer Sendung erstellen
Wenn Sie die Fleet Engine verwenden möchten, um die Aktivität eines Fahrers zu verfolgen, der eine Sendung abholt, erstellen Sie eine Aufgabe zur Abholung einer Sendung. Dazu wird das Attribut für den Aufgabentyp auf PICKUP gesetzt. Das folgende Beispiel zeigt eine Sendungsabholung in der Grand Indonesia East Mall.
Die folgenden Beispiele zeigen, wie Sie mit der [Java gRPC-Bibliothek][4] eine Abholaufgabe für eine Sendung erstellen oder eine HTTP-REST-Anfrage an [CreateTask][5] senden.
gRPC
static final String PROJECT_ID = "my-delivery-co-gcp-project";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Task settings
String parent = "providers/" + PROJECT_ID;
Task task = Task.newBuilder()
.setType(Task.Type.PICKUP)
.setState(Task.State.OPEN)
.setTrackingId("my-tracking-id")
.setPlannedLocation( // Grand Indonesia East Mall
LocationInfo.newBuilder().setPoint(
LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
.setTaskDuration(
Duration.newBuilder().setSeconds(2 * 60))
.setTargetTimeWindow(
TimeWindow.newBuilder()
.setStartTime(Timestamp.newBuilder().setSeconds(1680123600))
.setEndTime(Timestamp.newBuilder().setSeconds(1680130800)))
.addAttributes(TaskAttribute.newBuilder().setKey("foo").setStringValue("value"))
.addAttributes(TaskAttribute.newBuilder().setKey("bar").setNumberValue(10))
.addAttributes(TaskAttribute.newBuilder().setKey("baz").setBoolValue(false))
.build();
// Task request
CreateTaskRequest createTaskRequest =
CreateTaskRequest.newBuilder() // No need for the header
.setParent(parent) // Avoid using auto-incrementing IDs for the taskId
.setTaskId("task-8241890") // Task ID assigned by the Provider
.setTask(task) // Initial state
.build();
// Error handling
// If Fleet Engine does not have a task with that ID and the credentials of the
// requestor pass, the service creates the task successfully.
try {
Task createdTask = deliveryService.createTask(createTaskRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}
REST
Wenn Sie eine Aufgabe zur Abholung einer Sendung aus einer Serverumgebung erstellen möchten, senden Sie einen HTTP-REST-Aufruf an CreateTask:
POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id><id> ist eine eindeutige Kennung für die Aufgabe.
Der Anfrageheader muss ein Feld Authorization mit dem Wert Bearer <token> enthalten, wobei <token> von Ihrem Server gemäß den Richtlinien ausgestellt wird, die unter [Dienstkontorollen][6] und [JSON Web Tokens][7] beschrieben sind.
Der Anfragetext muss eine Task-Entität mit den entsprechenden Feldern enthalten, die unter [Felder für Versandaufgaben][8] beschrieben sind.
Beispiel eines curl-Befehls:
# Set $JWT, $PROJECT_ID, $TRACKING_ID, and $TASK_ID in the local
# environment
curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks?taskId=${TASK_ID}" \
-H "Content-type: application/json" \
-H "Authorization: Bearer ${JWT}" \
--data-binary @- << EOM
{
"type": "PICKUP",
"state": "OPEN",
"trackingId": "${TRACKING_ID}",
"plannedLocation": {
"point": {
"latitude": -6.195139,
"longitude": 106.820826
}
},
"taskDuration": "90s",
"targetTimeWindow": {
"startTime": "2023-03-29T21:00:00Z",
"endTime": "2023-03-29T23:00:00Z"
}
}
EOMLieferaufgabe für eine Sendung erstellen
Wenn Sie die Fleet Engine verwenden möchten, um die Aktivität eines Fahrers zu verfolgen, der eine Sendung ausliefert, erstellen Sie eine Aufgabe für die Lieferung einer Sendung. Dazu wird das Attribut „task_type“ auf DELIVERY gesetzt. Das folgende Beispiel zeigt eine Lieferung an die Grand Indonesia East Mall.
Die folgenden Beispiele zeigen, wie Sie mit der [Java gRPC-Bibliothek][4] eine Abholaufgabe für eine Sendung erstellen oder eine HTTP-REST-Anfrage an [CreateTask][5] senden.
gRPC
static final String PROJECT_ID = "my-delivery-co-gcp-project";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Task settings
String parent = "providers/" + PROJECT_ID;
Task task = Task.newBuilder()
.setType(Task.Type.DELIVERY)
.setState(Task.State.OPEN)
.setTrackingId("my-tracking-id")
.setPlannedLocation( // Grand Indonesia East Mall
LocationInfo.newBuilder().setPoint(
LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
.setTaskDuration(
Duration.newBuilder().setSeconds(2 * 60))
.setTargetTimeWindow(
TimeWindow.newBuilder()
.setStartTime(Timestamp.newBuilder().setSeconds(1680123600))
.setEndTime(Timestamp.newBuilder().setSeconds(1680130800)))
.addAttributes(TaskAttribute.newBuilder().setKey("foo").setStringValue("value"))
.addAttributes(TaskAttribute.newBuilder().setKey("bar").setNumberValue(10))
.addAttributes(TaskAttribute.newBuilder().setKey("baz").setBoolValue(false))
.build();
// Task request
CreateTaskRequest createTaskRequest =
CreateTaskRequest.newBuilder() // No need for the header
.setParent(parent) // Avoid using auto-incrementing IDs for the taskId
.setTaskId("task-8241890") // Task ID assigned by the Provider
.setTask(task) // Initial state
.build();
// Error handling
// If Fleet Engine does not have task with that ID and the credentials of the
// requestor pass, the service creates the task successfully.
try {
Task createdTask = deliveryService.createTask(createTaskRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}
REST
Wenn Sie eine Aufgabe zur Abholung einer Sendung aus einer Serverumgebung erstellen möchten, senden Sie einen HTTP-REST-Aufruf an CreateTask:
POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id><id> ist eine eindeutige Kennung für die Aufgabe.
Der Anfrageheader muss ein Feld Authorization mit dem Wert Bearer <token> enthalten, wobei <token> von Ihrem Server gemäß den Richtlinien ausgestellt wird, die unter [Dienstkontorollen][6] und [JSON Web Tokens][7] beschrieben sind.
Der Anfragetext muss eine Task-Entität enthalten:
Beispiel eines curl-Befehls:
# Set $JWT, $PROJECT_ID, $TRACKING_ID, and $TASK_ID in the local
# environment
curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks?taskId=${TASK_ID}" \
-H "Content-type: application/json" \
-H "Authorization: Bearer ${JWT}" \
--data-binary @- << EOM
{
"type": "DELIVERY",
"state": "OPEN",
"trackingId": "${TRACKING_ID}",
"plannedLocation": {
"point": {
"latitude": -6.195139,
"longitude": 106.820826
}
},
"taskDuration": "90s",
"targetTimeWindow": {
"startTime": "2023-03-29T21:00:00Z",
"endTime": "2023-03-29T23:00:00Z"
}
}
EOM
```placeidtrips1: /maps/documentation/mobility/fleet-engine/reference/tasks/rpc/maps.fleetengine.delivery.v1.html#locationinfo placeidtrips2: /maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/LocationInfo.html placeidtrips3: /maps/documentation/mobility/fleet-engine/reference/tasks/rpc/maps.fleetengine.delivery.v1.html#maps.fleetengine.delivery.v1.LocationInfo.FIELDS.string.maps.fleetengine.delivery.v1.LocationInfo.place placeidtrips4: /maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/LocationInfo.html#FIELDS.place
Nächste Schritte
- [Andere Aufgabentypen erstellen][13]
- [Aufgaben aktualisieren][3]
[1]: /maps/documentation/mobility/fleet-engine/essentials/tasks-intro [2]: /maps/documentation/mobility/fleet-engine/journeys/tasks [3]: update-tasks [4]: /maps/documentation/mobility/fleet-engine/essentials/client-libraries-tasks#java [5]: /maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/providers.tasks/create [6]: /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/service-accounts [7]: /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/jwt [8]: /maps/documentation/mobility/fleet-engine/journeys/tasks/create-shipment-tasks#shipment_task_fields [13]: /maps/documentation/mobility/fleet-engine/journeys/tasks/create-other-tasks