גישות
כדי לקבל את הביצועים הטובים ביותר מ-Fleet Engine, צריך לספק לו עדכונים על מיקום הרכב לפחות פעם בדקה ולכל היותר פעם ב-5 שניות. אפשר לספק את העדכונים האלה באחת מהדרכים הבאות:
- שימוש ב-Driver SDK: האפשרות הפשוטה ביותר.
- שימוש בקוד בהתאמה אישית: שימושי אם המיקומים מועברים דרך ה-Backend, או אם משתמשים במכשירים שאינם Android או iOS. במסמך הזה מתואר הגישה הזו.
לא משנה איך אתם מספקים עדכונים לגבי מיקום הרכב, ה-backend שלכם אחראי לעדכן את Fleet Engine כשכלי רכב למשלוחים נמצא בדרך לעצירה וכשהוא מגיע לעצירה. כולל המחסן עצמו. Fleet Engine לא מזהה את האירועים האלה באופן אוטומטי.
דוגמאות לעדכון מיקום הרכב
אפשר להשתמש בספריית Java gRPC כדי לעדכן את המיקום של כלי רכב ב-Fleet Engine, או להשתמש ב-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