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