สร้างงานประเภทอื่นๆ

เอกสารจะถือว่าคุณได้อ่านคู่มือแนะนำไปแล้ว งานที่กําหนดเวลาไว้ในส่วนข้อมูลเบื้องต้นเกี่ยวกับ Fleet Engine ด้วย ว่างานที่กำหนดเวลาไว้คืออะไรในส่วนนี้

เครื่องมือจัดการฟลีทสำหรับงานที่กำหนดเวลาไว้มีงานในหมวดหมู่ต่างๆ ดังนี้

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

เอกสารนี้ครอบคลุมถึงวิธีสร้างงานที่ไม่มีการจัดส่งในเซิร์ฟเวอร์ สำหรับ ประเภทงานการจัดส่ง โปรดดูหัวข้อสร้างงานการจัดส่ง

ช่องงานสำหรับงานที่ไม่ใช่การขับรถ

ส่วนนี้แสดงช่องงานที่จำเป็นสำหรับทั้งความไม่พร้อมใช้งาน และงานที่กำหนดเวลาไว้

ช่องงานที่จำเป็น

สำหรับทุกงานที่คุณสร้างใน Fleet Engine คุณต้องให้ข้อมูลที่จำเป็น และอาจระบุช่องที่ไม่บังคับด้วย เครื่องยนต์ในยานพาหนะ เพิกเฉยต่อช่องอื่นๆ ทั้งหมด และจะส่งข้อยกเว้นหากการสร้างงาน คำขอระบุ deliveryVehicleId ที่มอบหมาย หากต้องการมอบหมายงานให้กับยานพาหนะ ให้ใช้ UpdateDeliveryVehicleRequest ดูข้อมูลเพิ่มเติมได้ที่อัปเดตงาน

ช่องค่า
type

ตั้งค่าเป็นประเภทที่ตรงกับประเภทงาน ซึ่งได้แก่

  • PICKUP
  • DELIVERY
  • SCHEDULED_STOP
  • UNAVAILABLE
state State.OPEN
task_id รหัสงานที่ซ้ำกัน หมายเลขนี้ต้องไม่ใช่หมายเลขติดตามของการจัดส่ง หากคุณ ไม่มีรหัสงานในระบบ คุณอาจสร้างรหัสงานที่ไม่ซ้ำกันทั้งหมด (UUID) โปรดดูรายละเอียดที่หัวข้อ รหัสงาน
tracking_id เฉพาะ PICKUP หรือ DELIVERY งานเท่านั้น: หมายเลขหรือตัวระบุที่คุณใช้ในการติดตามการจัดส่ง ห้าม ให้ฟิลด์นี้สำหรับงานที่ไม่มีการจัดส่ง
plannedLocation PICKUP, DELIVERY หรือ SCHEDULED_STOP งานเท่านั้น: ตำแหน่งที่ทํางานให้เสร็จ ไม่จำเป็นสำหรับ UNAVAILABLE งาน
taskDuration เวลาที่คาดว่าจะเพิ่มเพื่อให้งานเสร็จสมบูรณ์ ตัวอย่างเช่น หากต้องการดู เพื่อหาที่จอดรถ หรือเดินไปที่จุดส่งต่อ

ช่องงานการจัดส่งที่ไม่บังคับ

ช่องค่า
targetTimeWindow กรอบเวลาที่งานควรเสร็จสิ้น ฟิลด์นี้ จะไม่ส่งผลต่อการทำงานของการกำหนดเส้นทาง
task_tracking_view_config เฉพาะ PICKUP หรือ DELIVERY งานเท่านั้น: การกำหนดค่าสำหรับการติดตามงานที่ระบุว่าองค์ประกอบข้อมูลใด ปรากฏต่อผู้ใช้ปลายทางไม่ว่าในกรณีใด
attributes รายการแอตทริบิวต์งานที่กำหนดเอง แอตทริบิวต์แต่ละรายการต้องมีคีย์ที่ไม่ซ้ำกัน

สร้างงานที่ไม่พร้อมใช้งาน

คุณสร้างงานที่ระบุว่าไม่พร้อมให้บริการได้ เช่น ช่วงพักของผู้ขับ หากต้องการสร้างงานที่ไม่พร้อมใช้งาน ให้ใช้หลักเกณฑ์ต่อไปนี้

  • ตั้งค่าประเภทงานเป็น UNAVAILABLE
  • อย่าใส่รหัสติดตาม
  • แม้ว่าคุณจะไม่ต้องระบุตำแหน่งสำหรับงานที่ไม่พร้อมให้บริการ ซึ่งจะทำให้การคำนวณเวลาถึงโดยประมาณได้รับการปรับปรุงตลอดทั้งวัน

กฎการแสดงผลพิเศษจะมีผลกับตำแหน่งของรถเมื่ออยู่บน UNAVAILABLE งานสำหรับการแชร์เส้นทาง

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

ตัวอย่างต่อไปนี้แสดงวิธีสร้างงานที่ไม่พร้อมใช้งานที่กำหนดเวลาไว้โดยใช้ ไลบรารี Java gRPC หรือวิธีสร้างคำขอ HTTP REST เพื่อ CreateTask

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.UNAVAILABLE)
    .setState(Task.State.OPEN)
    .setTaskDuration(
      Duration.newBuilder().setSeconds(60 * 60))  // 1hr break
    .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

หากต้องการสร้างงานความพร้อมใช้งานจากสภาพแวดล้อมเซิร์ฟเวอร์ ให้เรียกใช้ HTTP REST กับ CreateTask

POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id>

&lt;id&gt; เป็นตัวระบุที่ไม่ซ้ำสำหรับงาน

ส่วนหัวของคำขอต้องมีช่อง Authorization ที่มีค่า Bearer <token> ซึ่งเซิร์ฟเวอร์ของคุณจะเป็นผู้ออก <token> ตามหลักเกณฑ์ที่อธิบายไว้ในบทบาทของบัญชีบริการ และ โทเค็นเว็บ JSON

เนื้อหาของคำขอต้องมีเอนทิตี Task ซึ่งมีช่องที่เหมาะสม ตามที่อธิบายไว้ในช่องงานสำหรับงานที่ไม่ใช่การขับรถ

ตัวอย่างคำสั่ง curl

 # Set $JWT, $PROJECT_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": "UNAVAILABLE",
   "state": "OPEN",
   "plannedLocation": {
      "point": {
         "latitude": -6.195139,
         "longitude": 106.820826
      }
   },
   "taskDuration": "300s"
 }
 EOM

สร้างงานหยุดตามกำหนดการ

คุณสามารถสร้างงานสำหรับจุดแวะที่กำหนดเวลาไว้ได้ เช่น สำหรับงานที่ไม่มีการขับรถ ณ สถานที่ของลูกค้า จุดเติมน้ำมัน หรือเมื่อคนขับไปรับ การจัดส่งจากยานพาหนะป้อนอาหาร เมื่อคุณสร้างงานที่ต้องหยุดไว้ตามกําหนดการ ให้ใช้ หลักเกณฑ์ต่อไปนี้

  • ตั้งประเภทงานเป็น
  • อย่าใส่รหัสติดตาม
  • คุณสามารถระบุสถานที่ตั้งหรือไม่ก็ได้

ตัวอย่างต่อไปนี้แสดงวิธีสร้างงานไม่พร้อมใช้งานตามกำหนดเวลาโดยใช้ไลบรารี gRPC ของ Java หรือวิธีส่งคำขอ HTTP REST ไปยัง CreateTask

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.SCHEDULED_STOP)
    .setState(Task.State.OPEN)
    .setPlannedLocation(               // Grand Indonesia East Mall
      LocationInfo.newBuilder().setPoint(
        LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
    .setTaskDuration(
      Duration.newBuilder().setSeconds(2 * 60))
    .build();

  // Task request
  CreateTaskRequest createTaskRequest =
    CreateTaskRequest.newBuilder()  // No need for the header
        .setParent(parent)
        .setTaskId("task-8241890")  // Task ID assigned by the Provider
        .setTrip(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

หากต้องการสร้างงานการหยุดที่กำหนดเวลาไว้จากสภาพแวดล้อมเซิร์ฟเวอร์ ให้สร้าง HTTP REST โทรหา CreateTask:

POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id>

&lt;id&gt; เป็นตัวระบุที่ไม่ซ้ำสำหรับงาน

ส่วนหัวของคำขอต้องมีช่อง Authorization ที่มีค่า Bearer <token> ซึ่งเซิร์ฟเวอร์ของคุณจะเป็นผู้ออก <token> ตามหลักเกณฑ์ที่อธิบายไว้ในบทบาทของบัญชีบริการ และ โทเค็นเว็บ JSON

เนื้อหาของคำขอต้องมีเอนทิตี Task

ตัวอย่างคำสั่ง curl

# Set $JWT, $PROJECT_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": "SCHEDULED_STOP",
   "state": "OPEN",
   "plannedLocation": {
      "point": {
         "latitude": -6.195139,
         "longitude": 106.820826
      }
   },
   "taskDuration": "600s"
 }
 EOM

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