เอกสารนี้ถือว่าคุณคุ้นเคยกับสิ่งต่อไปนี้
- สร้างงานการจัดส่ง
- ข้อมูลเบื้องต้นเกี่ยวกับงานที่กำหนดเวลาไว้ ซึ่งครอบคลุมความสัมพันธ์ ระหว่างงาน จุดจอด และยานพาหนะโดยละเอียด
ดังที่ระบุไว้ในงานที่กำหนดเวลาไว้ในข้อควรทราบเกี่ยวกับ Fleet Engine คุณสร้างงานและเชื่อมโยงงานกับจุดจอดของยานพาหนะเพื่อจำลองความสัมพันธ์ในโลกจริงระหว่างงานกับสถานที่ที่คาดว่ายานพาหนะจะจอด เพื่อให้คนขับสามารถทำงานให้เสร็จสมบูรณ์ได้
จากนั้นคุณจะจัดการความคืบหน้าของงานตลอดวงจรได้โดย ส่งข้อมูลอัปเดตไปยัง Fleet Engine เพื่อให้ Fleet Engine ทำการกำหนดเส้นทางและอัปเดตสถานะ ได้ดีที่สุดตลอดเส้นทางของงาน วิธีสำคัญในการทำเช่นนี้คือการอัปเดต ป้ายรถเมื่อรถเข้าใกล้ มาถึง และออกจากป้าย ซึ่งจะช่วยให้สามารถรายงานและวิเคราะห์ความคืบหน้าของงานสำหรับทั้ง ผู้ให้บริการฟลีทและผู้ใช้ปลายทาง การอัปเดตสถานะมีดังนี้
- ระหว่างทาง:
STATE
enum สำหรับVehicleStop
ใช้ENROUTE
เพื่อ ระบุว่าป้ายจอดรถเป็นป้ายถัดไปในรายการกำหนดการเดินทางของยานพาหนะ ในมุมมองของงาน หมายความว่างานใดก็ตามที่เชื่อมโยงกับจุดแวะพักจะอยู่ถัดไปในรายการที่ต้องทำให้เสร็จ - มาถึงแล้ว:
STATE
enum สำหรับVehicleStop
ใช้ARRIVED
เพื่อระบุ ว่ายานพาหนะมาถึงป้ายจอดแล้ว จากมุมมองของงาน หมายความว่าระบบจะหยุดทำงานใดๆ ที่เชื่อมโยงกับจุดแวะพัก - เสร็จสิ้น: คุณทำเครื่องหมายว่าจุดแวะพักเสร็จสิ้นโดยนำออกจากรายการ จุดแวะพักสำหรับยานพาหนะ เมื่อดำเนินการนี้ Fleet Engine จะทำเครื่องหมาย งานที่เกี่ยวข้องทั้งหมดเป็น "ปิดแล้ว" โดยอัตโนมัติ ดูรายละเอียดเพิ่มเติมเกี่ยวกับการปิดงานได้ที่หัวข้อ ปิดงาน
เอกสารนี้อธิบายวิธีอัปเดตสถานะหยุดโดยใช้แนวทางฝั่งเซิร์ฟเวอร์ คุณยังทำสิ่งนี้จากแอปคนขับได้ด้วยหากให้สิทธิ์คนขับในการ จัดการงานโดยใช้อุปกรณ์ที่เชื่อถือได้ ใช้เพียงวิธีเดียวเพื่อหลีกเลี่ยงการแข่งขัน และรักษาแหล่งข้อมูลที่ถูกต้องเพียงแห่งเดียว
รถกำลังเดินทางไปยังป้าย
ระบบควรแจ้ง Fleet Engine เมื่อยานพาหนะเริ่มนำทางไปยัง จุดจอดถัดไป ซึ่งจะช่วยปรับปรุงการคำนวณเวลาถึงโดยประมาณและเส้นทาง
ฟิลด์ที่ต้องกรอกสำหรับการอัปเดตป้ายหยุดรถ
Fleet Engine จะไม่สนใจฟิลด์อื่นๆ ทั้งหมดในเอนทิตีสำหรับการแจ้งเตือน
ช่อง | ค่า |
---|---|
remainingVehicleJourneySegments
|
รายการจุดจอดรถที่เหลือพร้อมสถานะที่ทำเครื่องหมายเป็น State.NEW |
ตัวอย่างเส้นทางไปยังป้ายจอดรถ
ตัวอย่างต่อไปนี้แสดงวิธีแจ้ง Fleet Engine ว่ายานพาหนะกำลัง
เดินทางไปยังจุดจอดถัดไป โดยใช้ไลบรารี gRPC ของ Java หรือการเรียกใช้ HTTP
REST ไปยัง UpdateDeliveryVehicle
ส่วนจุดจอดอื่นๆ ทั้งหมดจะทำเครื่องหมายเป็นใหม่
gRPC
static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String VEHICLE_ID = "vehicle-8241890";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Vehicle settings
DeliveryVehicle deliveryVehicle = DeliveryVehicle.newBuilder()
// Next stop marked as ENROUTE
.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.ENROUTE)))
// All other stops marked as 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 updateDeliveryVehicleRequest =
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": "ENROUTE",
"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
ยานพาหนะมาถึงป้ายจอดรถ
ต้องแจ้งให้ Fleet Engine ทราบเมื่อยานพาหนะมาถึงป้ายจอด
ฟิลด์ที่ต้องกรอกสำหรับการอัปเดตป้ายหยุดรถ
Fleet Engine จะไม่สนใจฟิลด์อื่นๆ ทั้งหมดในเอนทิตีสำหรับการแจ้งเตือน
ช่อง | ค่า |
---|---|
remainingVehicleJourneySegments
|
รายการจุดจอดรถที่เหลือพร้อมสถานะที่ทำเครื่องหมายเป็น State.NEW |
ตัวอย่างการมาถึงป้ายจอดรถ
ตัวอย่างต่อไปนี้แสดงวิธีแจ้งให้ Fleet Engine ทราบว่ายานพาหนะมาถึง
ป้ายจอดแล้ว โดยใช้ไลบรารี gRPC ของ Java หรือการเรียกใช้ HTTP REST ไปยัง
UpdateDeliveryVehicle
ส่วนป้ายหยุดรถอื่นๆ ทั้งหมดจะทำเครื่องหมายว่าใหม่
gRPC
static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String VEHICLE_ID = "vehicle-8241890";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Vehicle settings
String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
DeliveryVehicle deliveryVehicle = DeliveryVehicle.newBuilder()
// Marking the arrival at stop.
.addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder()
.setStop(VehicleStop.newBuilder()
.setPlannedLocation(LocationInfo.newBuilder()
.setPoint(LatLng.newBuilder()
.setLatitude(37.7749)
.setLongitude(122.4194)))
.addTasks(TaskInfo.newBuilder().setTaskId(TASK1_ID))
.setState(VehicleStop.State.ARRIVED)))
// All other remaining stops marked as 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))) // Remaining stops must be NEW.
.build();
// DeliveryVehicle request
UpdateDeliveryVehicleRequest updateDeliveryVehicleRequest =
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": "ARRIVED",
"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
ยานพาหนะหยุด
ต้องแจ้งให้ Fleet Engine ทราบเมื่อยานพาหนะจอดรถเสร็จแล้ว ซึ่งจะทำให้ งานทั้งหมดที่เชื่อมโยงกับการหยุดทำงานถูกตั้งค่าเป็นสถานะปิด
ฟิลด์ที่ต้องกรอกสำหรับการอัปเดตป้ายหยุดรถ
Fleet Engine จะไม่สนใจฟิลด์อื่นๆ ทั้งหมดในเอนทิตีสำหรับการแจ้งเตือน
ช่อง | ค่า |
---|---|
remainingVehicleJourneySegments |
รายการจุดจอดรถที่เหลือพร้อมสถานะที่ทำเครื่องหมายเป็น State.NEW จุดแวะพักแรกในรายการต้องมีสถานะเป็น State.ENROUTE |
ตัวอย่างการหยุดที่เสร็จสมบูรณ์
ตัวอย่างต่อไปนี้แสดงวิธีแจ้งให้ Fleet Engine ทราบว่ายานพาหนะมาถึง
ป้ายจอดแล้ว โดยใช้ไลบรารี gRPC ของ Java หรือการเรียกใช้ HTTP REST ไปยัง
UpdateDeliveryVehicle
ส่วนป้ายหยุดรถอื่นๆ ทั้งหมดจะทำเครื่องหมายว่าใหม่
gRPC
static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String VEHICLE_ID = "vehicle-8241890";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Vehicle settings
String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
DeliveryVehicle deliveryVehicle = DeliveryVehicle.newBuilder()
// This stop has been completed and is commented out to indicate it
// should be removed from the list of vehicle journey segments.
// .addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder()
// .setStop(VehicleStop.newBuilder()
// .setPlannedLocation(LocationInfo.newBuilder()
// .setPoint(LatLng.newBuilder()
// .setLatitude(37.7749)
// .setLongitude(122.4194)))
// .addTasks(TaskInfo.newBuilder().setTaskId(TASK1_ID))
// .setState(VehicleStop.State.ARRIVED)))
// All other remaining stops marked as NEW.
// The next stop could be marked as ENROUTE if the vehicle has begun
// its journey to the next stop.
.addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder() // Next 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 updateDeliveryVehicleRequest =
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=remaining_vehicle_journey_segments`
- <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.3382,
"longitude": 121.8863
}
},
"tasks": [
{
"taskId": "${TASK2_ID}"
}
]
}
}
]
}
EOM