สรุปงาน

เอกสารนี้จะจะถือว่าคุณเข้าใจวิธีสร้างและใช้งานงาน ซึ่งมี ตัวอย่างที่เจาะจงเกี่ยวกับวิธีดำเนินงานจัดส่งให้เสร็จสิ้นมีดังนี้

  • ปิดงาน: การปิดงานการจัดส่งจะเปลี่ยนสถานะเป็น 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

  • &lt;id&gt; เป็นตัวระบุที่ไม่ซ้ำสำหรับงาน
  • ส่วนหัวของคำขอต้องมีช่อง 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เท่านั้น

รายละเอียดของผลลัพธ์งาน

Tasks จะให้รายละเอียดเพิ่มเติมเกี่ยวกับผลลัพธ์ของงานด้วย คุณสามารถตั้งค่า โดยตรงและ Fleet Engine จะดำเนินการตามการตั้งค่าของคุณ ดังนี้

  • สถานที่ตั้งของผลลัพธ์ของงาน: เครื่องมือจัดการยานพาหนะจะป้อนสถานที่ตั้งของผลลัพธ์ของงานโดยอัตโนมัติด้วยตำแหน่งยานพาหนะที่ทราบล่าสุด คุณสามารถระบุ แทน หากต้องการ
  • เวลาผลลัพธ์งาน: Fleet Engine จะไม่กรอกข้อมูลในช่องนี้ แต่ ซึ่งคุณสามารถตั้งค่าได้

คุณสามารถใช้วิธีใดก็ได้ต่อไปนี้ในการตั้งค่า task_outcome_location และ task_outcome_time:

  • อัปเดตเหตุการณ์เหล่านั้นในคำขอเดียวกันซึ่งจะกำหนดผลลัพธ์ของงาน
  • อัปเดตในภายหลัง หลังจากที่คุณกำหนดผลลัพธ์ของงานแล้ว
  • แก้ไขอีกครั้งหลังจากตั้งค่าแล้ว

เครื่องมือของ Fleet จะป้องกันไม่ให้อัปเดตต่อไปนี้ที่เกี่ยวข้องกับผลลัพธ์ของงาน

  • คุณจะแก้ไขผลลัพธ์ของงานไม่ได้เมื่อตั้งค่าเป็น 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

ขั้นตอนถัดไป