โปรดส่งสตรีมการอัปเดตตำแหน่งของยานพาหนะให้ Fleet Engine เพื่อให้ทำงานได้อย่างมีประสิทธิภาพสูงสุด ใช้วิธีใดวิธีหนึ่งต่อไปนี้เพื่อส่งข้อมูลอัปเดต
- ใช้ Driver SDK: ตัวเลือกที่ง่ายที่สุด โปรดดูเอกสารประกอบของ Driver SDK สำหรับ Android หรือ iOS
- ใช้โค้ดที่กําหนดเอง: มีประโยชน์ในกรณีที่มีการส่งต่อตําแหน่งผ่านแบ็กเอนด์ หรือในกรณีที่คุณใช้อุปกรณ์ที่ไม่ใช่ Android หรือ iOS คู่มือนี้จะกล่าวถึงแนวทางดังกล่าว
หากไม่ได้ใช้ Driver SDK เพื่ออัปเดตตำแหน่งของยานพาหนะ คุณสามารถโทรหา Fleet Engine โดยตรงพร้อมตำแหน่งของยานพาหนะ สำหรับยานพาหนะที่ใช้งานอยู่ Fleet Engine จะคาดหวังการอัปเดตตำแหน่งอย่างน้อย 1 ครั้งทุกนาที และไม่เกิน 1 ครั้งทุก 5 วินาที การอัปเดตเหล่านี้ต้องใช้สิทธิ์ผู้ใช้ Fleet Engine Driver SDK เท่านั้น
ตัวอย่างการอัปเดตตำแหน่งยานพาหนะ
Java
static final String PROJECT_ID = "project-id";
static final String VEHICLE_ID = "vid-8241890";
VehicleServiceBlockingStub vehicleService = VehicleService.newBlockingStub(channel);
String vehicleName = "providers/" + PROJECT_ID + "/vehicles/" + VEHICLE_ID;
Vehicle updatedVehicle = Vehicle.newBuilder()
.setLastLocation(VehicleLocation.newBuilder()
.setSupplementalLocation(LatLng.newBuilder()
.setLatitude(37.3382)
.setLongitude(121.8863))
.setSupplementalLocationTime(now())
.setSupplementalLocationSensor(LocationSensor.CUSTOMER_SUPPLIED_LOCATION)
.setSupplementalLocationAccuracy(DoubleValue.of(15.0))) // Optional
.build();
UpdateVehicleRequest updateVehicleRequest = UpdateVehicleRequest.newBuilder()
.setName(vehicleName)
.setVehicle(updatedVehicle)
.setUpdateMask(FieldMask.newBuilder()
.addPaths("last_location"))
.build();
try {
Vehicle updatedVehicle =
vehicleService.updateVehicle(updateVehicleRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND:
// Most implementations will call CreateVehicle in this case
break;
case PERMISSION_DENIED:
break;
}
return;
}
// If no Exception, Vehicle updated successfully.
REST
curl -X PUT \
"https://fleetengine.googleapis.com/v1/providers/project-id/vehicles/vid-8241890?updateMask=last_location" \
-H "Authorization: Bearer $JWT" \
-H "Content-Type: application/json" \
--data-binary @- << EOM
{
"supplementalLocation": {"latitude": 12.1, "longitude": 14.5},
"supplementalLocationTime": "$(date -u --iso-8601=seconds)",
"supplementalLocationSensor": "CUSTOMER_SUPPLIED_LOCATION",
"supplementalLocationAccuracy": 15
}
EOM
ดูข้อมูลอ้างอิง providers.vehicles.update