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

طُرق التعامل

للحصول على أفضل أداء من 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

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