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