ডেলিভারি গাড়ির অবস্থান আপডেট করুন

পন্থা

ফ্লিট ইঞ্জিনের সাথে সেরা পারফরম্যান্সের জন্য, এটিকে প্রতি মিনিটে অন্তত একবার এবং প্রতি 5 সেকেন্ডে একবারে গাড়ির অবস্থান আপডেটের একটি স্ট্রীম সরবরাহ করুন। এই আপডেটগুলি প্রদান করার জন্য নিম্নলিখিত উপায়গুলির মধ্যে একটি ব্যবহার করুন:

  • ড্রাইভার SDK ব্যবহার করুন : সহজ বিকল্প।
  • কাস্টম কোড ব্যবহার করুন : আপনার ব্যাকএন্ডের মাধ্যমে অবস্থানগুলি রিলে করা হলে বা আপনি যদি Android বা iOS ছাড়া অন্য ডিভাইসগুলি ব্যবহার করেন তাহলে দরকারী৷ এই নথিটি সেই পদ্ধতিকে কভার করে।

আপনি গাড়ির অবস্থানের আপডেটগুলি যেভাবে প্রদান করেন না কেন, আপনার ব্যাকএন্ড ফ্লিট ইঞ্জিন আপডেট করার জন্য দায়ী যখন একটি ডেলিভারি গাড়ি স্টপে যাওয়ার পথে থাকে এবং যখন এটি একটি স্টপে আসে। এর মধ্যে ডিপো নিজেই অন্তর্ভুক্ত। ফ্লিট ইঞ্জিন এই ইভেন্টগুলি স্বয়ংক্রিয়ভাবে সনাক্ত করে না।

গাড়ির অবস্থানের উদাহরণ আপডেট করুন

আপনি ফ্লিট ইঞ্জিনে গাড়ির অবস্থান আপডেট করতে 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;
  }

বিশ্রাম

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

এরপর কি