แนวทาง
เพื่อให้ Fleet Engine ทำงานได้ดีที่สุด ให้ส่งสตรีมข้อมูลอัปเดตตำแหน่งยานพาหนะอย่างน้อย 1 ครั้งทุกๆ 1 นาที และไม่เกิน 1 ครั้งทุกๆ 5 วินาที โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้เพื่อส่งข้อมูลอัปเดต
- **ใช้ Driver SDK**: ตัวเลือกที่ง่ายที่สุด
- ใช้โค้ดที่กำหนดเอง: มีประโยชน์ในกรณีที่ส่งต่อตำแหน่งผ่านแบ็กเอนด์ของคุณ หรือหากคุณใช้อุปกรณ์ที่ไม่ใช่ Android หรือ iOS เอกสารนี้จะครอบคลุมแนวทางดังกล่าว
ไม่ว่าคุณจะส่งข้อมูลอัปเดตตำแหน่งยานพาหนะด้วยวิธีใดก็ตาม แบ็กเอนด์ของคุณมีหน้าที่อัปเดต Fleet Engine เมื่อยานพาหนะสำหรับจัดส่งกำลังเดินทางไปยังจุดแวะพักและเมื่อยานพาหนะมาถึงจุดแวะพัก ซึ่งรวมถึงคลังสินค้าด้วย Fleet Engine จะไม่ตรวจหาเหตุการณ์เหล่านี้โดยอัตโนมัติ
ตัวอย่างการอัปเดตตำแหน่งยานพาหนะ
หากต้องการอัปเดตตำแหน่งของยานพาหนะใน Fleet Engine คุณสามารถใช้ ไลบรารี gRPC ของ Java หรือ REST ดังที่แสดงในตัวอย่างต่อไปนี้ ดูรายชื่อภาษาที่รองรับทั้งหมดได้ที่ ไลบรารีของไคลเอ็นต์สำหรับบริการงานที่กำหนดเวลาไว้
Java
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 myDeliveryVehicle = DeliveryVehicle.newBuilder()
.setLastLocation(DeliveryVehicleLocation.newBuilder()
.setSupplementalLocation(LatLng.newBuilder()
.setLatitude(37.3382)
.setLongitude(121.8863))
.setSupplementalLocationTime(now())
.setSupplementalLocationSensor(DeliveryVehicleLocationSensor.CUSTOMER_SUPPLIED_LOCATION)
.setSupplementalLocationAccuracy(DoubleValue.of(15.0))) // Optional
.build();
// DeliveryVehicle request
UpdateDeliveryVehicleRequest updateDeliveryVehicleRequest =
UpdateDeliveryVehicleRequest.newBuilder() // No need for the header
.setName(vehicleName)
.setDeliveryVehicle(myDeliveryVehicle)
.setUpdateMask(FieldMask.newBuilder()
.addPaths("last_location"))
.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=last_location
รายละเอียดคำขอ
ส่วนเนื้อหาของคำขอต้องมีเอนทิตี DeliveryVehicle ที่ระบุช่องต่างๆ ดังนี้
ช่องที่ต้องระบุมีดังนี้
ช่อง ค่า lastLocation.supplementalLocationตำแหน่งของยานพาหนะ lastLocation.supplementalLocationTimeการประทับเวลาล่าสุดที่ทราบว่ายานพาหนะอยู่ที่ตำแหน่งนี้ lastLocation.supplementalLocationSensorควรป้อนข้อมูลด้วย CUSTOMER_SUPPLIED_LOCATIONช่องที่ไม่บังคับมีดังนี้
ช่อง ค่า lastLocation.supplementalLocationAccuracyความแม่นยำของตำแหน่งที่ระบุเป็นเมตร
# 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
{
"lastLocation": {
"supplementalLocation": {"latitude": 12.1, "longitude": 14.5},
"supplementalLocationTime": "$(date -u --iso-8601=seconds)",
"supplementalLocationSensor": "CUSTOMER_SUPPLIED_LOCATION",
"supplementalLocationAccuracy": 15
}
}
EOM