เอกสารนี้ถือว่าคุณคุ้นเคยกับสิ่งต่อไปนี้
- สร้างงานการจัดส่ง
- ข้อมูลเบื้องต้นเกี่ยวกับงานที่กำหนดเวลาไว้ ซึ่งครอบคลุมความสัมพันธ์ ระหว่างงาน จุดจอด และยานพาหนะโดยละเอียด
ในสถานการณ์การนำส่งจริง ธุรกิจจะมอบหมายงานการจัดส่งให้แก่ คนขับรถ ซึ่งจะใช้ยานพาหนะนำส่งไปยังผู้รับ ณ สถานที่ที่วางแผนไว้ เช่น ที่พักอาศัยหรือห้องนำส่งในอาคาร คุณ สร้างโมเดลนี้ใน Fleet Engine ได้โดยการสร้างงานและส่งคำขออัปเดตยานพาหนะนำส่ง ซึ่งจะอัปเดตเอนทิตียานพาหนะด้วยรายการจุดแวะพักที่จะ เดินทาง คุณกำหนดรายการงานที่จะดำเนินการที่จุดแวะพักแต่ละแห่ง
คุณอัปเดตงานของยานพาหนะได้ทุกเมื่อ แต่โดยทั่วไปแล้วคุณจะทำเพื่อวัตถุประสงค์ต่อไปนี้
- ตั้งเวลางานให้รถยนต์ดำเนินการ คุณทำได้โดย ใช้คำขออัปเดตที่เพิ่มจุดแวะใหม่ให้กับยานพาหนะ หรือใช้คำขออัปเดต ที่เพิ่มงานใหม่ไปยังจุดแวะที่มีอยู่
- อัปเดตลำดับของงานที่มีอยู่ซึ่งเชื่อมโยงกับการหยุดรถที่ระบุ
- เปลี่ยนสถานที่ที่ดำเนินการงานให้เสร็จสมบูรณ์ โดยค่าเริ่มต้น Fleet Engine จะทำเครื่องหมายสถานที่ทำงานให้เสร็จสมบูรณ์เป็นสถานที่เดียวกับจุดจอดรถ ที่เชื่อมโยงกับงาน หากต้องการ คุณสามารถระบุสถานที่ตั้งที่เฉพาะเจาะจง สำหรับแต่ละงานได้ เช่น คุณอาจมีรถยนต์จอดที่คอมเพล็กซ์ขนาดใหญ่เพื่อนำส่งพัสดุจำนวนมาก ซึ่งแต่ละพัสดุจะได้รับมอบหมายให้ส่งไปยังห้องนำส่งพัสดุที่เฉพาะเจาะจง
- ปิดงานที่มอบหมายไว้ก่อนหน้าเพื่อไม่ให้งานเหล่านั้นรวมอยู่ในการจัดลำดับที่อัปเดต ดูรายละเอียดได้ที่สรุปงาน
กำหนดเวลาหรือเปลี่ยนงานการนำส่ง
คุณสามารถตั้งเวลาหรือเปลี่ยนงานที่มอบหมายให้กับยานพาหนะได้จากสภาพแวดล้อมของเซิร์ฟเวอร์ หรือโดยใช้ Driver SDK หากคุณให้สิทธิ์คนขับในการจัดการงานโดยใช้อุปกรณ์ที่เชื่อถือได้ ใช้เพียงวิธีเดียวเพื่อหลีกเลี่ยงการแข่งขัน และรักษาแหล่งข้อมูลที่ถูกต้องเพียงแห่งเดียว
หากต้องการเปลี่ยนการนำส่งจากยานพาหนะหนึ่งไปยังอีกคัน ให้ปิดงานเดิม แล้วสร้างงานใหม่ก่อนที่จะมอบหมายให้ยานพาหนะคันอื่น หากอัปเดต ยานพาหนะนำส่งให้รวมงานที่กำหนดให้กับยานพาหนะอื่นอยู่แล้ว คุณจะได้รับข้อผิดพลาด
ช่องที่ต้องกรอกสำหรับการอัปเดตงาน
ส่วนนี้จะบันทึกฟิลด์ที่จำเป็นต้องตั้งค่าเมื่ออัปเดตงานสำหรับ ยานพาหนะ ไม่ได้ระบุช่องที่ไม่บังคับ Fleet Engine จะไม่สนใจฟิลด์อื่นๆ ทั้งหมด ในเอนทิตีสำหรับการอัปเดต
ช่องที่ต้องกรอก | ค่า |
---|---|
remainingVehicleJourneySegments |
รายการกลุ่มเส้นทางสําหรับงานตามลําดับที่ควรดําเนินการ ระบบจะเรียกใช้งานแรกในรายการก่อน |
remainingVehicleJourneySegments[i].stop |
จุดจอดสำหรับงาน i ในรายการ |
remainingVehicleJourneySegments[i].stop.plannedLocation |
สถานที่ที่วางแผนไว้สำหรับป้ายจอดรถ |
remainingVehicleJourneySegments[i].stop.tasks |
รายการงานที่จะดำเนินการที่จุดจอดรถนี้ |
remainingVehicleJourneySegments[i].stop.state |
State.NEW |
ตัวอย่างการมอบหมายงาน
ตัวอย่างต่อไปนี้แสดงวิธีใช้ไลบรารี gRPC ของ Java และการเรียก HTTP
REST ไปยัง UpdateDeliveryVehicle
เพื่อเพิ่มงานใหม่ 2 งานสำหรับยานพาหนะ
gRPC
static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String VEHICLE_ID = "vehicle-8241890";
static final String TASK1_ID = "task-756390";
static final String TASK2_ID = "task-849263";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Vehicle settings
String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
DeliveryVehicle deliveryVehicle = DeliveryVehicle.newBuilder()
.addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder() // 1st stop
.setStop(VehicleStop.newBuilder()
.setPlannedLocation(LocationInfo.newBuilder()
.setPoint(LatLng.newBuilder()
.setLatitude(37.7749)
.setLongitude(122.4194)))
.addTasks(TaskInfo.newBuilder().setTaskId(TASK1_ID))
.setState(VehicleStop.State.NEW)))
.addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder() // 2nd stop
.setStop(VehicleStop.newBuilder()
.setPlannedLocation(LocationInfo.newBuilder()
.setPoint(LatLng.newBuilder()
.setLatitude(37.3382)
.setLongitude(121.8863)))
.addTasks(TaskInfo.newBuilder().setTaskId(TASK2_ID))
.setState(VehicleStop.State.NEW)))
.build();
// DeliveryVehicle request
UpdateDeliveryVehicleRequest updateDeliveryRequest =
UpdateDeliveryVehicleRequest.newBuilder() // No need for the header
.setName(vehicleName)
.setDeliveryVehicle(deliveryVehicle)
.setUpdateMask(FieldMask.newBuilder().addPaths("remaining_vehicle_journey_segments"))
.build();
try {
DeliveryVehicle updatedDeliveryVehicle =
deliveryService.updateDeliveryVehicle(updateDeliveryVehicleRequest);
} 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>/deliveryVehicles/<id>?updateMask=remainingVehicleJourneySegments`
<id> คือตัวระบุที่ไม่ซ้ำกันสำหรับยานพาหนะนำส่งในกองยานพาหนะ ที่คุณต้องการอัปเดตลำดับงาน ซึ่งเป็นตัวระบุที่คุณระบุเมื่อสร้างยานพาหนะ
ส่วนหัวของคำขอต้องมีฟิลด์ Authorization ที่มีค่าเป็น Bearer <token> โดยที่ <token> ออกโดยเซิร์ฟเวอร์ของคุณ ตามหลักเกณฑ์ที่อธิบายไว้ในบทบาทของบัญชีบริการและ โทเค็นเว็บ JSON
เนื้อหาของคำขอต้องมีเอนทิตี
DeliveryVehicle
ตัวอย่างคำสั่ง curl
# Set JWT, PROJECT_ID, VEHICLE_ID, TASK1_ID, and TASK2_ID in the local
# environment
curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}?updateMask=remainingVehicleJourneySegments" \
-H "Content-type: application/json" \
-H "Authorization: Bearer ${JWT}" \
--data-binary @- << EOM
{
"remainingVehicleJourneySegments": [
{
"stop": {
"state": "NEW",
"plannedLocation": {
"point": {
"latitude": 37.7749,
"longitude": -122.084061
}
},
"tasks": [
{
"taskId": "${TASK1_ID}"
}
]
}
},
{
"stop": {
"state": "NEW",
"plannedLocation": {
"point": {
"latitude": 37.3382,
"longitude": 121.8863
}
},
"tasks": [
{
"taskId": "${TASK2_ID}"
}
]
}
}
]
}
EOM