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

দ্রষ্টব্য: যানবাহনের অনুরোধ তৈরি করার আগে , ভূমিকার অধীনে যানবাহনের অনুরোধ সংক্রান্ত প্রয়োজনীয়তাগুলো পড়ুন।

পদ্ধতি

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

• ড্রাইভার এসডিকে ব্যবহার করুন : এটিই সবচেয়ে সহজ উপায়।
• কাস্টম কোড ব্যবহার করুন : এটি তখন উপযোগী যখন আপনার ব্যাকএন্ডের মাধ্যমে অবস্থান জানানো হয়, অথবা আপনি অ্যান্ড্রয়েড বা আইওএস ছাড়া অন্য ডিভাইস ব্যবহার করেন। এই ডকুমেন্টটিতে সেই পদ্ধতিটি আলোচনা করা হয়েছে।

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

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

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

এরপর কী?

• একটি ডেলিভারি গাড়ি নিন