เอกสารนี้ถือว่าคุณเข้าใจวิธีสร้างและใช้งานงาน โดยจะแสดงตัวอย่างเฉพาะสำหรับการสรุปงานการจัดส่งดังนี้
ปิดงาน: การปิดงานการจัดส่งจะเปลี่ยนสถานะเป็น
CLOSEDและ ระบุว่างานนั้นไม่ทำงานอีกต่อไปตั้งค่าผลลัพธ์ของงาน: เมื่อปิดงานแล้ว ให้สรุปงานโดย ตั้งค่าผลลัพธ์เป็น
SUCCEEDEDหรือFAILEDซึ่งเป็นส่วนสำคัญของการสรุปงานเพื่อแสดงผลลัพธ์การจัดส่งในการแชร์การเดินทางและเพื่อให้แน่ใจว่ามีการเรียกเก็บเงินที่ถูกต้องสำหรับบริการ Fleet Engine
ปิดงาน
คุณสามารถปิดงานได้ด้วยวิธีต่อไปนี้
- อัปเดตสถานะการหยุดของยานพาหนะ คุณนำการหยุดออกจากยานพาหนะ ซึ่งจะปิดงานทั้งหมดที่เกี่ยวข้องกับการหยุดนั้น ดูรายละเอียดได้ที่ อัปเดตสถานะการหยุด
- นำงานออกจากรายการการหยุดของยานพาหนะ ซึ่งเกี่ยวข้องกับการอัปเดตรายการงานสำหรับการหยุด แต่ไม่มีงานที่ปิดแล้วอยู่ในรายการ ดูอัปเดตลำดับงานได้ที่อัปเดตงาน
- ตั้งค่าสถานะงานเป็น
CLOSEDซึ่งทำได้เฉพาะกับงานที่ไม่ได้มอบหมายให้กับยานพาหนะ ส่วนนี้จะแสดงแนวทางนี้
เมื่อปิดงานแล้ว คุณจะเปิดงานอีกครั้งไม่ได้
การปิดงานไม่ได้บ่งบอกถึงความสำเร็จหรือความล้มเหลวของงาน แต่บ่งบอกว่าระบบจะไม่พิจารณางานนั้นว่าอยู่ในระหว่างดำเนินการอีกต่อไป หากต้องการระบุผลลัพธ์ที่แท้จริงของงานและแสดงผลลัพธ์นั้นเพื่อวัตถุประสงค์ในการติดตามกองยานพาหนะและการแชร์การเดินทาง คุณต้องระบุผลลัพธ์ที่แท้จริงของงาน ดู ตั้งค่าผลลัพธ์ของงานด้านล่าง
ช่องงานสำหรับการปิดงาน
ส่วนนี้จะอธิบายช่องที่ต้องตั้งค่าเมื่อปิดงาน Fleet Engine จะไม่สนใจช่องอื่นๆ ทั้งหมดในเอนทิตีสำหรับการอัปเดต
| ช่องที่ต้องกรอก | ค่า |
|---|---|
state |
State.CLOSED |
ปิดงานโดยตรง
ตัวอย่างต่อไปนี้แสดงวิธีตั้งค่างานที่ไม่ได้มอบหมายเป็นสถานะปิด ไม่ว่าจะใน gRPC หรือใช้การเรียกคำขอ HTTP REST ไปยัง UpdateTask
gRPC
static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String TASK_ID = "task-8241890";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Task settings
String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
Task task = Task.newBuilder()
.setName(taskName)
.setState(Task.State.CLOSED) // You can only directly CLOSE a
.build(); // task that is NOT assigned to a vehicle.
// Task request
UpdateTaskRequest updateTaskRequest =
UpdateTaskRequest.newBuilder() // No need for the header
.setTask(task)
.setUpdateMask(FieldMask.newBuilder().addPaths("state"))
.build();
try {
Task updatedTask = deliveryService.updateTask(updateTaskRequest);
} 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>/tasks/<id>?updateMask=state
- <id> คือตัวระบุที่ไม่ซ้ำกันสำหรับงาน
- ส่วนหัวของคำขอต้องมีช่อง Authorization ที่มีค่า Bearer <token> โดย <token> ออกโดยเซิร์ฟเวอร์ของคุณ ตามหลักเกณฑ์ที่อธิบายไว้ใน บทบาทบัญชีบริการ และ JSON Web Token
- คุณต้องรวมเอนทิตี
Taskไว้ในเนื้อหาคำขอ
ตัวอย่างคำสั่ง curl
# Set JWT, PROJECT_ID, and TASK_ID in the local environment
curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}?updateMask=state,taskOutcome,taskOutcomeTime" \
-H "Content-type: application/json" \
-H "Authorization: Bearer ${JWT}" \
--data-binary @- << EOM
{
"state": "CLOSED",
"taskOutcome": "SUCCEEDED",
"taskOutcomeTime": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
}
EOMตั้งค่าผลลัพธ์ของงาน
หากต้องการระบุผลลัพธ์ที่แท้จริงของงาน ให้ตั้งค่าผลลัพธ์สำหรับงานที่ปิดแล้วเป็น SUCCEEDED หรือ FAILED คุณต้องปิดงานก่อนจึงจะตั้งค่าผลลัพธ์ได้ Fleet Engine จะเรียกเก็บเงินเฉพาะงานการจัดส่งที่มีสถานะเป็น SUCCEEDED
รายละเอียดผลลัพธ์ของงาน
งานยังมีรายละเอียดเพิ่มเติมเกี่ยวกับผลลัพธ์ของงานด้วย คุณสามารถตั้งค่ารายละเอียดเหล่านี้ได้โดยตรงและ Fleet Engine จะพิจารณาการตั้งค่าของคุณ
- ตำแหน่งผลลัพธ์ของงาน: Fleet Engine จะป้อนตำแหน่งผลลัพธ์ของงานด้วยตำแหน่งสุดท้ายที่ทราบของยานพาหนะโดยอัตโนมัติ คุณระบุตำแหน่งนี้แทนได้หากต้องการ
- เวลาผลลัพธ์ของงาน: Fleet Engine จะไม่ป้อนข้อมูลในช่องนี้ แต่ คุณสามารถตั้งค่าได้
คุณสามารถใช้วิธีการต่อไปนี้เพื่อตั้งค่า task_outcome_location และ task_outcome_time
- อัปเดตในคำขอเดียวกัน ที่ตั้งค่าผลลัพธ์ของงาน
- อัปเดตในภายหลัง หลังจากตั้งค่าผลลัพธ์ของงานแล้ว
- แก้ไขอีกครั้ง หลังจากตั้งค่าแล้ว
Fleet Engine จะป้องกันการอัปเดตต่อไปนี้ที่เกี่ยวข้องกับผลลัพธ์ของงาน
- คุณแก้ไขผลลัพธ์ของงานไม่ได้เมื่อตั้งค่า เป็น
SUCCEEDEDหรือFAILED - คุณตั้งค่าตำแหน่งหรือเวลาผลลัพธ์ของงานไม่ได้ สำหรับงานที่ไม่ได้ตั้งค่าผลลัพธ์
ช่องงานสำหรับการตั้งค่าผลลัพธ์
ส่วนนี้จะอธิบายช่องที่ต้องกรอกและช่องที่ไม่บังคับซึ่งต้องตั้งค่าเมื่อตั้งค่าผลลัพธ์ของงาน Fleet Engine จะไม่สนใจช่องอื่นๆ ในเอนทิตีสำหรับการอัปเดต
| ช่องที่ต้องกรอก | ค่า |
|---|---|
taskOutcome |
Outcome.SUCCEEDED หรือ Outcome.FAILED |
| ช่องที่ไม่บังคับ | ค่า |
|---|---|
taskOutcomeLocation |
ตำแหน่งที่งานเสร็จสมบูรณ์ หากไม่ได้ตั้งค่า Fleet Engine จะตั้งค่านี้เป็นตำแหน่งสุดท้ายของยานพาหนะโดยค่าเริ่มต้น |
taskOutcomeTime |
การประทับเวลาของเวลาที่งานเสร็จสมบูรณ์ |
ตัวอย่างผลลัพธ์ของงาน
ตัวอย่างต่อไปนี้แสดงวิธีใช้ ไลบรารี gRPC ของ Java และการเรียก HTTP
REST ไปยัง UpdateTask เพื่อตั้งค่าผลลัพธ์ของงานเป็น SUCCEEDED และตั้งค่า
ตำแหน่งที่งานเสร็จสมบูรณ์
gRPC
static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String TASK_ID = "task-8241890";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Task settings
String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
Task task = Task.newBuilder()
.setName(taskName)
.setTaskOutcome(TaskOutcome.SUCCEEDED)
.setTaskOutcomeTime(now())
.setTaskOutcomeLocation( // Grand Indonesia East Mall
LocationInfo.newBuilder().setPoint(
LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
.build();
// Task request
UpdateTaskRequest updateTaskRequest =
UpdateTaskRequest.newBuilder() // No need for the header
.setTask(task)
.setUpdateMask(FieldMask.newBuilder().addPaths("task_outcome", "task_outcome_time", "task_outcome_location"))
.build();
try {
Task updatedTask = deliveryService.updateTask(updateTaskRequest);
} 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>/tasks/<id>?updateMask=taskOutcome,taskOutcomeTime,taskOutcomeLocation
- <id> คือตัวระบุที่ไม่ซ้ำกันสำหรับงาน
- ส่วนหัวของคำขอต้องมีช่อง Authorization ที่มีค่า Bearer <token> โดย <token> ออกโดยเซิร์ฟเวอร์ของคุณ ตามหลักเกณฑ์ที่อธิบายไว้ใน บทบาทบัญชีบริการ และ JSON Web Token
- เนื้อหาคำขอต้องมีเอนทิตี
Task
# Set JWT, PROJECT_ID, and TASK_ID in the local environment
curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}?updateMask=taskOutcome,taskOutcomeTime,taskOutcomeLocation" \
-H "Content-type: application/json" \
-H "Authorization: Bearer ${JWT}" \
--data-binary @- << EOM
{
"taskOutcome": "SUCCEEDED",
"taskOutcomeTime": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
"taskOutcomeLocation": {
"point": {
"latitude": -6.195139,
"longitude": 106.820826
}
}
}
EOM