ডেলিভারি যানবাহন তালিকা

এই দস্তাবেজটি বর্ণনা করে যে কীভাবে ডেলিভারি গাড়ির তালিকা করতে হয়।

পরিবেশ এবং সীমাবদ্ধতা

আপনি একটি সার্ভার বা ব্রাউজার পরিবেশ থেকে বিতরণ যানবাহন তালিকা করতে পারেন. ড্রাইভার SDK ডেলিভারি যানবাহন তালিকাভুক্ত করা সমর্থন করে না।

ডেলিভারি যানবাহন তালিকাভুক্ত করা ডেলিভারি যানবাহনগুলিতে বিস্তৃত অ্যাক্সেসের অনুরোধ করে এবং শুধুমাত্র বিশ্বস্ত ব্যবহারকারীদের জন্য উদ্দেশ্যে করা হয়। ডেলিভারি ফ্লিট রিডার বা ফ্লিট ইঞ্জিন ডেলিভারি অ্যাডমিন টোকেন ব্যবহার করুন যখন তালিকা ডেলিভারি যানবাহন অনুরোধ করুন।

তালিকাভুক্ত ডেলিভারি যানবাহনগুলির প্রতিক্রিয়া আকারের উপর প্রভাবের কারণে নিম্নলিখিত ক্ষেত্রগুলি সংশোধন করা হয়েছে:

• CurrentRouteSegment
• RemainingVehicleJourneySegments

ব্যবহার

আপনি বৈশিষ্ট্য ফিল্টার এবং ভিউপোর্ট সীমানা দ্বারা যানবাহন তালিকা করতে পারেন. আপনি কোনো ফিল্টার বা ভিউপোর্ট উল্লেখ না করলে, প্রতিক্রিয়ায় সমস্ত ডেলিভারি গাড়ি অন্তর্ভুক্ত থাকে।

বৈশিষ্ট্য ফিল্টার সহ তালিকা

আপনি তাদের attributes বৈশিষ্ট্য ব্যবহার করে ফিল্টার দ্বারা বিতরণ যানবাহন তালিকা করতে পারেন। উদাহরণস্বরূপ, my_key কী এবং my_value মান দিয়ে একটি অ্যাট্রিবিউট জিজ্ঞাসা করতে, attributes.my_key = my_value ব্যবহার করুন। একাধিক অ্যাট্রিবিউটের জন্য ক্যোয়ারী করতে, attributes.key1 = value1 AND attributes.key2 = value2 হিসাবে লজিক্যাল AND এবং OR অপারেটর ব্যবহার করে কোয়েরিতে যোগ দিন। ফিল্টার কোয়েরি সিনট্যাক্সের সম্পূর্ণ বিবরণের জন্য AIP-160 দেখুন। আপনি যদি ভিউপোর্ট বাউন্ডের সাথে ফিল্টার একত্রিত করেন, তাহলে ফিল্টারটি ভিউপোর্ট বাউন্ডে AND অপারেটর হিসেবে কাজ করে। বিশদ বিবরণের জন্য যানবাহনের বৈশিষ্ট্য ফিল্টার প্রশ্নগুলি দেখুন।

ভিউপোর্ট সীমা সহ তালিকা

আপনি viewport অনুরোধ পরামিতি ব্যবহার করে অবস্থান অনুসারে তালিকাভুক্ত ডেলিভারি যানবাহন ফিল্টার করতে পারেন। viewport রিকোয়েস্ট প্যারামিটার দুটি বাউন্ডিং স্থানাঙ্ক ব্যবহার করে ভিউপোর্টকে সংজ্ঞায়িত করে: একটি high (উত্তরপূর্ব) এবং low (দক্ষিণ-পশ্চিম) অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক জোড়া। অনুরোধগুলি প্রত্যাখ্যান করা হয় যদি সেগুলিতে উচ্চ অক্ষাংশ থাকে যা ভৌগলিকভাবে নিম্ন অক্ষাংশের চেয়ে কম।

তালিকা প্রতিক্রিয়া

একটি যুক্তিসঙ্গত পৃষ্ঠার আকার ব্যবহার করে ডেলিভারি গাড়ির তালিকাগুলি ডিফল্টরূপে পৃষ্ঠাযুক্ত করা হয়। আপনি যদি একটি পৃষ্ঠার আকার নির্দিষ্ট করেন, অনুরোধটি শুধুমাত্র সীমা দ্বারা নির্দিষ্ট করা গাড়ির সংখ্যা বা তার চেয়ে কম ফেরত দেয়৷ যদি অনুরোধ করা পৃষ্ঠার আকার একটি অভ্যন্তরীণ সর্বোচ্চ মান অতিক্রম করে, তাহলে অভ্যন্তরীণ সর্বোচ্চ ব্যবহার করা হয়। ডিফল্ট এবং সর্বাধিক পৃষ্ঠা আকার উভয় 100 যানবাহন.

একটি ডেলিভারি যানবাহন তালিকা ফলাফলের পরবর্তী পৃষ্ঠা পড়ার জন্য একটি টোকেন অন্তর্ভুক্ত করতে পারে। একটি পৃষ্ঠা টোকেন শুধুমাত্র একটি প্রতিক্রিয়াতে উপস্থিত থাকে যখন ডেলিভারি গাড়ির আরও পৃষ্ঠাগুলি পুনরুদ্ধারের জন্য উপলব্ধ থাকে। কাজের পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে, একটি অনুরোধ সহ পৃষ্ঠা টোকেন ব্যবহার করুন যা অন্যথায় পূর্ববর্তী অনুরোধের সাথে অভিন্ন।

যানবাহনের উদাহরণ তালিকাভুক্ত করুন

আপনি জাভা gRPC লাইব্রেরি বা REST ব্যবহার করতে পারেন একটি নির্দিষ্ট অঞ্চলে একটি নির্দিষ্ট বৈশিষ্ট্য সহ ডেলিভারি গাড়ির তালিকা করতে। একটি সফল প্রতিক্রিয়া এখনও খালি হতে পারে। যখন এটি ঘটে, এর মানে হল যে নির্দিষ্ট বৈশিষ্ট্য সহ কোনও যানবাহন নির্দিষ্ট ভিউপোর্টে বিদ্যমান নেই।

  static final String PROJECT_ID = "my-delivery-co-gcp-project";

  DeliveryServiceBlockingStub deliveryService =
    DeliveryServiceGrpc.newBlockingStub(channel);

  // Tasks request
  String parent = "providers/" + PROJECT_ID;
  ListDeliveryVehiclesRequest listDeliveryVehiclesRequest =
    ListDeliveryVehiclesRequest.newBuilder()  // No need for the header
        .setParent(parent)
        .setViewport(
              Viewport.newBuilder()
                .setHigh(LatLng.newBuilder()
                    .setLatitude(37.45)
                    .setLongitude(-122.06)
                    .build())
                .setLow(LatLng.newBuilder()
                    .setLatitude(37.41)
                    .setLongitude(-122.11)
                    .build())
        .setFilter("attributes.my_key = my_value")
        .build();

  try {
    ListDeliveryVehiclesResponse listDeliveryVehiclesResponse =
        deliveryService.listDeliveryVehicles(listDeliveryVehiclesRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
        case NOT_FOUND:
            break;

        case PERMISSION_DENIED:
            break;
    }
    return;
  }

  # HTTP request
  html GET https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles

  # Request with a filter
  # Request sets JWT, PROJECT_ID, and VEHICLE_ID in the local environment
  curl -H "Authorization: Bearer ${JWT}" \
    "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles?filter=attributes.my_key%20%3D%20my_value%20&viewport.high.latitude=37.45&viewport.high.longitude=-122.06&viewport.low.latitude=37.41&viewport.low.longitude=-122.11"

  // JSON representation
  {
    "deliveryVehicles": [
      {
        object (DeliveryVehicle)
      }
    ],
    "nextPageToken": string,
    "totalSize": integer
  }

এরপর কি

• একটি নির্ধারিত যাত্রা তৈরি করুন