กำหนดค่างาน

เอกสารนี้ถือว่าคุณเข้าใจวิธีสร้างและใช้งานงาน โดยจะแสดงตัวอย่างเฉพาะสำหรับการกำหนดค่างานการจัดส่งด้วยวิธีต่อไปนี้

• กำหนดกรอบเวลาเป้าหมายสำหรับงานการจัดส่ง: กำหนดกรอบเวลา ที่ต้องทำงานให้เสร็จ

• ปรับแต่งระดับการมองเห็นงาน: ปรับแต่งระดับการมองเห็นกิจกรรมของงานเพื่อแสดงต่อลูกค้าหรือผู้ให้บริการยานพาหนะ

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

กำหนดกรอบเวลาเป้าหมาย

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

กรอบเวลาเป้าหมายประกอบด้วยเวลาเริ่มต้นและเวลาสิ้นสุด และสามารถตั้งค่าในงานประเภทใดก็ได้ กรอบเวลาเป้าหมายไม่ส่งผลต่อลักษณะการทำงานของการกำหนดเส้นทาง

ตัวอย่างต่อไปนี้แสดงวิธีตั้งค่ากรอบเวลาโดยใช้ไลบรารี Java 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)
    .setTargetTimeWindow(
      TimeWindow.newBuilder()
        .setStartTime(Timestamp.newBuilder().setSeconds(1680123600))
        .setEndTime(Timestamp.newBuilder().setSeconds(1680130800)))
    .build();

  // Task request
  UpdateTaskRequest updateTaskRequest =
    UpdateTaskRequest.newBuilder()  // No need for the header
        .setTask(task)
        .setUpdateMask(FieldMask.newBuilder().addPaths("targetTimeWindow"))
        .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

หากต้องการตั้งค่ากรอบเวลาของงานโดยใช้ HTTP ให้เรียก PATCH และใช้ updateMask เพื่ออัปเดตพารามิเตอร์ targetTimeWindow

PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<id>?updateMask=targetTimeWindow

โดย <id> คือตัวระบุที่ไม่ซ้ำกันของงาน ส่วนหัวของคำขอ ต้องมีช่อง Authorization ที่มีค่า Bearer <token>, โดย <token> ออกโดยเซิร์ฟเวอร์ของคุณตามหลักเกณฑ์ ที่อธิบายไว้ใน บทบาทบัญชีบริการ และ JSON Web Token

# 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=targetTimeWindow" \
    -H "Content-type: application/json" \
    -H "Authorization: Bearer ${JWT}" \
    --data-binary @- << EOM
  {
    "targetTimeWindow": {
      "startTime": "2023-03-29T21:00:00Z",
      "endTime": "2023-03-29T23:00:00Z"
    }
  }
  EOM

ปรับแต่งระดับการเข้าถึงงาน

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

ส่วนนี้อธิบายกฎการมองเห็นสำหรับออบเจ็กต์ที่ติดตามบนแผนที่ กฎเหล่านี้มีผลกับออบเจ็กต์ 2 หมวดหมู่ ได้แก่

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

หมายเหตุ: คุณยังปรับแต่งการกำหนดค่าระดับการเข้าถึงเริ่มต้นสำหรับ โปรเจ็กต์ได้โดย ติดต่อทีมสนับสนุน

กฎการมองเห็นเครื่องหมายระบุตำแหน่ง

Fleet Engine จะแสดงเครื่องหมายระบุตำแหน่งสำหรับสถานที่จัดส่งที่แสดงบนแผนที่ ไม่ว่าสถานะการจัดส่งจะเป็นอย่างไร

กฎระดับการเข้าถึงข้อมูลงาน

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

คุณจะปรับแต่งงานต่อไปนี้ไม่ได้

• จุดแวะพักที่กำหนดเวลาไว้
• งานไม่พร้อมให้บริการ
• งานยานพาหนะที่ไม่ได้ใช้งาน

กฎระดับการเข้าถึงงานไม่พร้อมให้บริการ

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

ระดับการเข้าถึงงานยานพาหนะที่ใช้งานอยู่

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

คุณสามารถปรับแต่งการกำหนดค่าระดับการเข้าถึงตามงานแต่ละรายการได้โดยการตั้งค่า TaskTrackingViewConfig ในงานเมื่อสร้างหรืออัปเดตงานภายใน Fleet Engine ซึ่งจะสร้างกฎเพื่อให้องค์ประกอบข้อมูลแต่ละรายการพร้อมใช้งาน

ตารางต่อไปนี้แสดงช่องที่คุณสามารถใช้กฎระดับการเข้าถึงได้

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

ตารางนี้แสดงตัวเลือกการเข้าถึงที่ใช้ได้สำหรับช่องที่ระบุไว้ข้างต้น

ตัวเลือกการเข้าถึง
จำนวนจุดแวะพักที่เหลือ ระยะเวลาจนกว่าจะถึงเวลาถึงโดยประมาณ ระยะทางขับขี่ที่เหลือ แสดงเสมอ ไม่แสดง

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

กฎระดับการเข้าถึงเส้นประกอบเส้นทางและตำแหน่งยานพาหนะ

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

ทำตามกฎต่อไปนี้เพื่อระบุการผสมผสานระดับการเข้าถึงเส้นประกอบเส้นทาง / ตำแหน่งยานพาหนะที่ถูกต้อง

เส้นประกอบเส้นทางและตำแหน่งยานพาหนะระบุตัวเลือกการมองเห็นเดียวกัน

ในสถานการณ์นี้ ทั้งเส้นประกอบและตำแหน่งยานพาหนะจะตั้งค่าตัวเลือกเดียวกัน ซึ่งรวมถึง

• จำนวนจุดแวะพักที่เหลือ
• ระยะเวลาจนกว่าจะถึงเวลาถึงโดยประมาณ
• ระยะทางขับขี่ที่เหลือ

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

```js
"taskTrackingViewConfig": {
  "routePolylinePointsVisibility": {
    "remainingStopCountThreshold": 3
  },
  "vehicleLocationVisibility": {
    "remainingStopCountThreshold": 5
  },
}
```

เส้นประกอบเส้นทางและตำแหน่งยานพาหนะระบุตัวเลือกการมองเห็นที่แตกต่างกัน

เมื่อเส้นประกอบเส้นทางและตำแหน่งยานพาหนะมีตัวเลือกการแสดงผลที่แตกต่างกัน ตำแหน่งยานพาหนะจะแสดงก็ต่อเมื่อเป็นไปตามตัวเลือกการแสดงผลทั้ง 2 รายการ อีกครั้งที่ระดับการเข้าถึงเส้นประกอบขึ้นอยู่กับกฎระดับการเข้าถึงของยานพาหนะ ดังนี้

• แสดงเสมอ: เส้นประกอบเส้นทางต้องใช้ตัวเลือกการมองเห็น แสดงเสมอ เมื่อตำแหน่งยานพาหนะมีตัวเลือกการมองเห็น แสดงเสมอ เดียวกัน
• ไม่แสดง: เส้นประกอบเส้นทางต้องใช้ตัวเลือกการแสดงผล ไม่แสดง เมื่อตำแหน่งยานพาหนะใช้ตัวเลือกการแสดงผล ไม่แสดง

ตัวอย่างมีดังนี้

  "taskTrackingViewConfig": {
    "routePolylinePointsVisibility": {
      "remainingStopCountThreshold": 3
    },
    "vehicleLocationVisibility": {
      "remainingDrivingDistanceMetersThreshold": 3000
    },
  }

ในตัวอย่างนี้ ตำแหน่งยานพาหนะจะแสดงก็ต่อเมื่อจำนวนจุดแวะพักที่เหลือมีอย่างน้อย 3 จุด และ ระยะทางขับขี่ที่เหลือมีอย่างน้อย 3, 000 เมตร

ตัวอย่างการปรับแต่งระดับการเข้าถึงงาน

ตัวอย่างต่อไปนี้แสดงวิธีตั้งค่างานที่มีกฎระดับการเข้าถึงต่อไปนี้

• แสดงเส้นประกอบเส้นทางหากยานพาหนะอยู่ห่างออกไปไม่เกิน 3 จุดแวะพัก
• แสดงเวลาถึงโดยประมาณหากระยะทางขับขี่ที่เหลือน้อยกว่า 5,000 เมตร
• ไม่แสดงจำนวนจุดแวะพักที่เหลือ
• ช่องอื่นๆ แต่ละช่องจะยังคงระดับการเข้าถึงเริ่มต้นที่แสดงเมื่อยานพาหนะอยู่ห่างจากงานไม่เกิน 5 จุดแวะพัก

ดู TaskTrackingViewConfig สำหรับ gRPC หรือ REST

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)
  .setTaskTrackingViewConfig(
    TaskTrackingViewConfig.newBuilder()
      .setRoutePolylinePointsVisibility(
        VisibilityOption.newBuilder().setRemainingStopCountThreshold(3))
      .setEstimatedArrivalTimeVisibility(
        VisibilityOption.newBuilder().remainingDrivingDistanceMetersThreshold(5000))
      .setRemainingStopCountVisibility(
        VisibilityOption.newBuilder().setNever(true)))
  .build();

// Task request
UpdateTaskRequest updateTaskRequest =
  UpdateTaskRequest.newBuilder()  // No need for the header
      .setTask(task)
      .setUpdateMask(FieldMask.newBuilder().addPaths("taskTrackingViewConfig"))
      .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

หากต้องการตั้งค่ากรอบเวลาการกำหนดค่ามุมมองการติดตามงานโดยใช้ HTTP ให้เรียก PATCH และใช้ updateMask เพื่ออัปเดตพารามิเตอร์ taskTrackingViewConfig

PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<id>?updateMask=taskTrackingViewConfig

เช่น

# 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=taskTrackingViewConfig" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer ${JWT}" \
  --data-binary @- << EOM
{
  "taskTrackingViewConfig": {
    "routePolylinePointsVisibility": {
      "remainingStopCountThreshold": 3
    },
    "estimatedArrivalTimeVisibility": {
      "remainingDrivingDistanceMetersThreshold": 5000
    },
    "remainingStopCountVisibility": {
      "never": true
    }
  }
}
EOM

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

• ลบงาน