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