กำหนดค่างาน

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

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

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

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

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

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

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

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

  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;
  }

# 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 ซึ่งจะสร้างกฎสำหรับองค์ประกอบข้อมูลแต่ละรายการให้พร้อมใช้งาน

ตารางต่อไปนี้แสดงช่องที่คุณใช้กฎการมองเห็นได้

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

กฎการแสดงผลเส้นหลายเหลี่ยมของเส้นทางและตำแหน่งยานพาหนะ

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

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

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

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

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

เพื่อให้เป็นไปตามกฎ ค่าสำหรับระดับการมองเห็นของเส้นหลายเส้นของเส้นทางต้องน้อยกว่าหรือเท่ากับค่าที่ตั้งไว้สำหรับการมองเห็นยานพาหนะ ในตัวอย่างนี้ มีการตั้งค่าเกณฑ์จุดแวะพักที่เหลือสำหรับเส้นหลายจุดเป็น 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

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;
}

# 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

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

• ลบงาน