تعديل الموقع الجغرافي لمركبة التسليم

الأساليب

للحصول على أفضل أداء مع Fleet Engine، يجب تزويده بسلسلة من تعديلات الموقع الجغرافي للمركبة مرة واحدة على الأقل كل دقيقة ومرة واحدة على الأكثر كل 5 ثوانٍ. يمكنك استخدام إحدى الطريقتَين التاليتَين لتقديم هذه التعديلات:

  • استخدام حزمة تطوير البرامج (SDK) للسائق: هذا هو الخيار الأبسط.
  • استخدام رمز مخصّص: يكون هذا الخيار مفيدًا إذا تم نقل المواقع الجغرافية من خلال الواجهة الخلفية، أو إذا كنت تستخدم أجهزة غير Android أو iOS. يتناول هذا المستند هذا النهج.

بغض النظر عن طريقة تقديم إشعارات بشأن الموقع الجغرافي للمركبة، فإنّ الخلفية تكون مسؤولة عن إبلاغ Fleet Engine عندما تكون مركبة التوصيل في طريقها إلى محطة وعند وصولها إلى محطة. ويشمل ذلك المستودع نفسه. لا يرصد Fleet Engine هذه الأحداث تلقائيًا.

أمثلة على تعديل الموقع الجغرافي للمركبة

لتعديل الموقع الجغرافي لمركبة في Fleet Engine، يمكنك استخدام مكتبة Java gRPC أو REST، كما هو موضّح في المثال التالي. للاطّلاع على قائمة كاملة باللغات المتاحة، يُرجى مراجعة مكتبات العملاء لخدمات المهام المُجدوَلة.

جافا

  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

الخطوات التالية