الطرق
للحصول على أفضل أداء باستخدام Fleet Engine، يجب تزويدها بدفق من تعديلات الموقع الجغرافي للمركبة مرة واحدة على الأقل كل دقيقة ومرة واحدة على الأكثر كل 5 ثوانٍ. يمكنك تقديم هذه التعديلات بإحدى الطريقتَين التاليتَين:
- استخدام Driver SDK: هذا هو الخيار الأسهل.
- استخدام رمز مخصّص: يكون هذا الخيار مفيدًا إذا تم نقل المواقع الجغرافية من خلال الخلفية، أو إذا كنت تستخدم أجهزة غير Android أو iOS. يتناول هذا المستند هذا النهج.
بغض النظر عن الطريقة التي تقدّم بها تحديثات الموقع الجغرافي للمركبة، يكون الخلفية مسؤولة عن تعديل 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