Method: providers.deliveryVehicles.list

নির্দিষ্ট ফিল্টারিং মানদণ্ড পূরণ করে এমন সমস্ত DeliveryVehicle পায়৷

HTTP অনুরোধ

GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/deliveryVehicles

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
parent

string

প্রয়োজন। ফর্ম্যাট providers/{provider} হতে হবে। provider অবশ্যই Google ক্লাউড প্রকল্প আইডি হতে হবে। উদাহরণস্বরূপ, sample-cloud-project

ক্যোয়ারী প্যারামিটার

পরামিতি
header

object ( DeliveryRequestHeader )

ঐচ্ছিক। স্ট্যান্ডার্ড ডেলিভারি API অনুরোধ শিরোনাম।

pageSize

integer

ঐচ্ছিক। ফেরার জন্য সর্বাধিক সংখ্যক যানবাহন। পরিষেবাটি এই সংখ্যার চেয়ে কম ফেরত দিতে পারে। আপনি যদি এই নম্বরটি নির্দিষ্ট না করেন, তাহলে সার্ভার ফলাফলের সংখ্যা নির্ধারণ করে।

pageToken

string

ঐচ্ছিক। একটি পৃষ্ঠা টোকেন, একটি পূর্ববর্তী deliveryVehicles.list কল থেকে প্রাপ্ত। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করার জন্য আপনাকে অবশ্যই এটি প্রদান করতে হবে।

পেজিনেটিং করার সময়, deliveryVehicles.list এ প্রদত্ত অন্যান্য সমস্ত প্যারামিটার অবশ্যই পেজ টোকেন প্রদানকারী কলের সাথে মেলে।

filter

string

ঐচ্ছিক। ডেলিভারি গাড়ির তালিকা করার সময় আবেদন করার জন্য একটি ফিল্টার ক্যোয়ারী। ফিল্টার সিনট্যাক্সের উদাহরণের জন্য http://aip.dev/160 দেখুন। আপনি যদি একটি মান নির্দিষ্ট না করেন, বা যদি আপনি ফিল্টারের জন্য একটি খালি স্ট্রিং নির্দিষ্ট করেন, তাহলে সমস্ত ডেলিভারি যান ফেরত দেওয়া হয়৷

উল্লেখ্য যে deliveryVehicles.list এর জন্য সমর্থিত একমাত্র প্রশ্নগুলি গাড়ির বৈশিষ্ট্য (উদাহরণস্বরূপ, attributes.<key> = <value> বা attributes.<key1> = <value1> AND attributes.<key2> = <value2> )। এছাড়াও, সমস্ত বৈশিষ্ট্য স্ট্রিং হিসাবে সংরক্ষণ করা হয়, তাই বৈশিষ্ট্যগুলির সাথে শুধুমাত্র সমর্থিত তুলনাগুলি হল স্ট্রিং তুলনা। সংখ্যা বা বুলিয়ান মানের সাথে তুলনা করার জন্য, স্ট্রিং হিসাবে বিবেচনা করার জন্য মানগুলিকে স্পষ্টভাবে উদ্ধৃত করতে হবে (উদাহরণস্বরূপ, attributes.<key> = "10" বা attributes.<key> = "true" )।

একটি ফিল্টার ক্যোয়ারীতে অনুমোদিত সীমাবদ্ধতার সর্বাধিক সংখ্যা 50৷ একটি সীমাবদ্ধতা হল ফর্ম attribute.<KEY> <COMPARATOR> <VALUE> , উদাহরণস্বরূপ attributes.foo = bar হল 1টি সীমাবদ্ধতা৷

viewport

object ( Viewport )

ঐচ্ছিক। একটি ফিল্টার যা ভিউপোর্ট দ্বারা সংজ্ঞায়িত আয়তক্ষেত্রাকার এলাকায় যাদের সর্বশেষ পরিচিত অবস্থান ছিল তাদের কাছে ফিরে আসা যানবাহনগুলিকে সীমাবদ্ধ করে৷

শরীরের অনুরোধ

অনুরোধের বডি খালি হতে হবে।

প্রতিক্রিয়া শরীর

deliveryVehicles.list প্রতিক্রিয়া বার্তা।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "deliveryVehicles": [
    {
      object (DeliveryVehicle)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
ক্ষেত্র
deliveryVehicles[]

object ( DeliveryVehicle )

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

nextPageToken

string

আপনি ফলাফল তালিকা চালিয়ে যেতে ListDeliveryVehiclesRequest এ এই টোকেনটি পাস করতে পারেন। যখন সমস্ত ফলাফল ফিরে আসে, তখন এই ক্ষেত্রটি প্রতিক্রিয়াতে থাকবে না, বা এটি একটি খালি স্ট্রিং হবে।

totalSize

string ( int64 format)

সমস্ত পৃষ্ঠা জুড়ে অনুরোধের মানদণ্ডের সাথে মেলে এমন ডেলিভারি গাড়ির মোট সংখ্যা৷

ভিউপোর্ট

একটি অক্ষাংশ-দ্রাঘিমাংশ ভিউপোর্ট, দুটি তির্যক বিপরীত low এবং high বিন্দু হিসাবে উপস্থাপিত। একটি ভিউপোর্টকে একটি বন্ধ অঞ্চল হিসাবে বিবেচনা করা হয়, অর্থাৎ এটি এর সীমানা অন্তর্ভুক্ত করে। অক্ষাংশের সীমাগুলি অবশ্যই -90 থেকে 90 ডিগ্রী সহ, এবং দ্রাঘিমাংশের সীমাগুলি অবশ্যই -180 থেকে 180 ডিগ্রী সহ এর মধ্যে হতে হবে৷ বিভিন্ন ক্ষেত্রে অন্তর্ভুক্ত:

  • low = high হলে, ভিউপোর্টটি সেই একক বিন্দু নিয়ে গঠিত।

  • low.longitude > high.longitude হলে, দ্রাঘিমাংশের সীমাটি উল্টানো হয় (ভিউপোর্টটি 180 ডিগ্রি দ্রাঘিমাংশের রেখা অতিক্রম করে)।

  • low.longitude = -180 ডিগ্রি এবং high.longitude = 180 ডিগ্রি হলে, ভিউপোর্টে সমস্ত দ্রাঘিমাংশ অন্তর্ভুক্ত থাকে।

  • low.longitude = 180 ডিগ্রি এবং high.longitude = -180 ডিগ্রি হলে, দ্রাঘিমাংশের পরিসর খালি।

  • low.latitude > high.latitude হলে, অক্ষাংশ পরিসর খালি থাকে।

low এবং high উভয়ই জনবসতিপূর্ণ হতে হবে এবং উপস্থাপিত বাক্সটি খালি হতে পারে না (উপরের সংজ্ঞা দ্বারা নির্দিষ্ট করা হয়েছে)। একটি খালি ভিউপোর্ট একটি ত্রুটির কারণ হবে.

উদাহরণস্বরূপ, এই ভিউপোর্টটি সম্পূর্ণরূপে নিউ ইয়র্ক সিটিকে ঘিরে রেখেছে:

{ "নিম্ন": { "অক্ষাংশ": 40.477398, "দ্রাঘিমাংশ": -74.259087 }, "উচ্চ": { "অক্ষাংশ": 40.91618, "দ্রাঘিমাংশ": -73.70018 } }

JSON প্রতিনিধিত্ব
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
ক্ষেত্র
low

object ( LatLng )

প্রয়োজন। ভিউপোর্টের নিম্ন পয়েন্ট।

high

object ( LatLng )

প্রয়োজন। ভিউপোর্টের উচ্চ বিন্দু।