Phương pháp
Để Fleet Engine đạt được hiệu suất tốt nhất, hãy cung cấp cho nó một luồng xe cập nhật vị trí ít nhất một lần mỗi phút và tối đa 5 giây một lần. Bạn có thể sử dụng một trong các cách sau để cung cấp các thông tin cập nhật này:
- Sử dụng SDK trình điều khiển: Lựa chọn đơn giản nhất.
- Sử dụng mã tuỳ chỉnh: hữu ích nếu vị trí được chuyển tiếp thông qua phần phụ trợ, hoặc nếu bạn dùng các thiết bị khác hệ điều hành Android hoặc iOS. Tài liệu này đề cập đến phương pháp tiếp cận.
Bất kể bạn cung cấp thông tin cập nhật vị trí xe bằng cách nào, phần phụ trợ của bạn vẫn chịu trách nhiệm cập nhật Fleet Engine khi xe giao hàng đang trên đường đến dừng và khi đến điểm dừng. Điều này bao gồm cả kho chứa. Động cơ đội tàu không tự động phát hiện các sự kiện này.
Cập nhật ví dụ về vị trí của xe
Bạn có thể dùng thư viện Java gRPC để cập nhật vị trí của xe trong Fleet Engine hoặc sử dụng 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;
}
Kiến trúc chuyển trạng thái đại diện (REST)
PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<id>?updateMask=last_location
Thông tin chi tiết về yêu cầu
Nội dung yêu cầu phải chứa thực thể DeliveryVehicle
chỉ định
các trường như sau:
Các trường bắt buộc:
Trường Giá trị lastLocation.supplementalLocation
Vị trí của xe. lastLocation.supplementalLocationTime
Dấu thời gian xác định gần đây nhất của chiếc xe tại vị trí này. lastLocation.supplementalLocationSensor
Phải được điền bằng CUSTOMER_SUPPLIED_LOCATION
.Các trường không bắt buộc:
Trường Giá trị lastLocation.supplementalLocationAccuracy
Độ chính xác của vị trí đã cung cấp, tính bằng mét.
# 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