เอกสารนี้ถือว่าคุณเข้าใจวิธีสร้างและใช้งานงานแล้ว โดยมี ตัวอย่างที่เฉพาะเจาะจงเกี่ยวกับวิธีทำงานการจัดส่งให้เสร็จสมบูรณ์ดังนี้
- ปิดงาน: การปิดงานการจัดส่งจะเปลี่ยนสถานะเป็น - 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
- คุณต้องรวมเอนทิตี 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
- เนื้อหาของคำขอต้องมีเอนทิตี 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