Method: providers.vehicles.list

অনুরোধের বিকল্পগুলির সাথে মেলে এমন একটি প্রদানকারীর সাথে যুক্ত যানবাহনের একটি পৃষ্ঠাযুক্ত তালিকা প্রদান করে।

HTTP অনুরোধ

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

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

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

পরামিতি
parent

string

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

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

পরামিতি
header

object ( RequestHeader )

স্ট্যান্ডার্ড ফ্লিট ইঞ্জিন অনুরোধ শিরোনাম।

pageSize

integer

ফেরার জন্য সর্বাধিক সংখ্যক যানবাহন। ডিফল্ট মান: 100।

pageToken

string

nextPageToken এর মান vehicles.list এ পূর্ববর্তী কল দ্বারা প্রদত্ত যাতে আপনি যানবাহনের গোষ্ঠীর মাধ্যমে পৃষ্ঠাটি করতে পারেন। যদি অনুরোধের ফিল্টারের মানদণ্ডটি vehicles.list এ আগের কলের ফিল্টারের মানদণ্ডের মতো না হয় তবে মানটি অনির্ধারিত।

minimumCapacity

integer

গাড়ির প্রয়োজনীয় ন্যূনতম ক্ষমতা নির্দিষ্ট করে। ফেরত আসা সমস্ত যানবাহনের maximumCapacity এই মানের থেকে বেশি বা সমান হবে। সেট করা হলে, অবশ্যই 0 এর বেশি বা সমান হতে হবে।

tripTypes[]

enum ( TripType )

নির্দিষ্ট ট্রিপের প্রকারের অন্তত একটিকে সমর্থন করে এমন যানবাহনগুলির প্রতিক্রিয়া সীমাবদ্ধ করে৷

maximumStaleness

string ( Duration format)

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

নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' s ' দিয়ে শেষ হয়৷ উদাহরণ: "3.5s" ।

vehicleTypeCategories[]

enum ( Category )

প্রয়োজন। নির্দিষ্ট ধরনের শ্রেণীগুলির একটি সহ যানবাহনের প্রতিক্রিয়া সীমাবদ্ধ করে৷ UNKNOWN অনুমোদিত নয়.

requiredAttributes[]

string

কলাররা requiredAttributes , requiredOneOfAttributes , এবং requiredOneOfAttributeSets ফিল্ডগুলির যেকোন সমন্বয় ব্যবহার করে জটিল লজিক্যাল অপারেশন গঠন করতে পারে৷

requiredAttributes একটি তালিকা; requiredOneOfAttributes একটি বার্তা ব্যবহার করে যা তালিকার একটি তালিকার অনুমতি দেয়। সংমিশ্রণে, দুটি ক্ষেত্র এই অভিব্যক্তিটির রচনার অনুমতি দেয়:

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(requiredOneOfAttributes[0][0] OR requiredOneOfAttributes[0][1] OR
...)
AND
(requiredOneOfAttributes[1][0] OR requiredOneOfAttributes[1][1] OR
...)

নির্দিষ্ট বৈশিষ্ট্য সহ যানবাহনগুলির প্রতিক্রিয়া সীমাবদ্ধ করে। এই ক্ষেত্রটি একটি সংযোগ/এন্ড অপারেশন। সর্বাধিক 50টি প্রয়োজনীয় বৈশিষ্ট্য অনুমোদিত। এটি একটি গাড়িতে অনুমোদিত সর্বাধিক সংখ্যক বৈশিষ্ট্যের সাথে মেলে। প্রতিটি পুনরাবৃত্তি করা স্ট্রিং "কী:মান" বিন্যাসের হওয়া উচিত।

requiredOneOfAttributes[]

string

প্রতিটি VehicleAttributeList এ অন্তত একটি নির্দিষ্ট বৈশিষ্ট্য সহ যানবাহনের প্রতিক্রিয়া সীমিত করে। প্রতিটি তালিকার মধ্যে, একটি গাড়ির অন্তত একটি বৈশিষ্ট্যের সাথে মেলে। এই ক্ষেত্রটি প্রতিটি VehicleAttributeList এ একটি অন্তর্ভুক্তিমূলক বিচ্ছিন্নতা/বা অপারেশন এবং VehicleAttributeList এর সংগ্রহ জুড়ে একটি সংযোগ/AND অপারেশন। প্রতিটি পুনরাবৃত্তি করা স্ট্রিং "key1:value1|key2:value2|key3:value3" বিন্যাসের হওয়া উচিত।

requiredOneOfAttributeSets[]

string

requiredOneOfAttributeSets অতিরিক্ত কার্যকারিতা প্রদান করে।

requiredOneOfAttributes এর মতই, requiredOneOfAttributeSets একটি বার্তা ব্যবহার করে যা তালিকার একটি তালিকার অনুমতি দেয়, এটির মত অভিব্যক্তিকে অনুমতি দেয়:

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(
  (requiredOneOfAttributeSets[0][0] AND
  requiredOneOfAttributeSets[0][1] AND
  ...)
  OR
  (requiredOneOfAttributeSets[1][0] AND
  requiredOneOfAttributeSets[1][1] AND
  ...)
)

একটি VehicleAttributeList এর সমস্ত বৈশিষ্ট্যের সাথে মেলে এমন যানবাহনের প্রতিক্রিয়া সীমিত করে। প্রতিটি তালিকার মধ্যে, একটি গাড়ির সমস্ত বৈশিষ্ট্যের সাথে মেলে। এই ক্ষেত্রটি প্রতিটি VehicleAttributeList এর একটি সংযোজন/AND ক্রিয়াকলাপ এবং VehicleAttributeList এর সংগ্রহ জুড়ে অন্তর্ভুক্ত বিচ্ছিন্নতা/বা অপারেশন। প্রতিটি পুনরাবৃত্তি করা স্ট্রিং "key1:value1|key2:value2|key3:value3" বিন্যাসের হওয়া উচিত।

vehicleState

enum ( VehicleState )

এই যানবাহন অবস্থা আছে যে যানবাহন প্রতিক্রিয়া সীমিত.

onTripOnly

boolean

শুধুমাত্র বর্তমান ট্রিপ(গুলি) সহ যানবাহনগুলি ফেরত দিন।

filter

string

ঐচ্ছিক। যানবাহন তালিকাভুক্ত করার সময় আবেদন করার জন্য একটি ফিল্টার প্রশ্ন। ফিল্টার সিনট্যাক্সের উদাহরণের জন্য http://aip.dev/160 দেখুন।

এই ক্ষেত্রটি requiredAttributes , requiredOneOfAttributes , এবং required_one_of_attributes_sets ক্ষেত্রগুলিকে প্রতিস্থাপন করার জন্য ডিজাইন করা হয়েছে৷ যদি একটি অ-খালি মান এখানে নির্দিষ্ট করা হয়, তাহলে নিম্নলিখিত ক্ষেত্রগুলি অবশ্যই খালি থাকতে হবে: requiredAttributes , requiredOneOfAttributes , এবং required_one_of_attributes_sets ।

এই ফিল্টারটি অন্যান্য সীমাবদ্ধতার সাথে একটি AND ক্লজ হিসাবে কাজ করে, যেমন vehicleState বা onTripOnly ।

মনে রাখবেন যে শুধুমাত্র গাড়ির অ্যাট্রিবিউটে সমর্থিত প্রশ্নগুলি (উদাহরণস্বরূপ, attributes.<key> = <value> বা attributes.<key1> = <value1> AND attributes.<key2> = <value2> )। ফিল্টার ক্যোয়ারীতে অনুমোদিত সীমাবদ্ধতার সর্বাধিক সংখ্যা 50।

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

viewport

object ( Viewport )

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

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

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

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

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

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

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

object ( Vehicle )

অনুরোধের মানদণ্ডের সাথে মিলে যাওয়া যানবাহন। ফেরত দেওয়া যানবাহনের সর্বোচ্চ সংখ্যা অনুরোধে pageSize ক্ষেত্র দ্বারা নির্ধারিত হয়।

nextPageToken

string

যানবাহনের পরবর্তী পৃষ্ঠা পুনরুদ্ধার করার জন্য টোকেন, বা অনুরোধের মানদণ্ড পূরণ করে এমন আর কোনো যানবাহন না থাকলে খালি।

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 )

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