Method: providers.vehicles.search

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

HTTP অনুরোধ

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

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

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

পরামিতি
parent

string

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

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

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "header": {
    object (RequestHeader)
  },
  "pickupPoint": {
    object (TerminalLocation)
  },
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "pickupRadiusMeters": integer,
  "count": integer,
  "minimumCapacity": integer,
  "tripTypes": [
    enum (TripType)
  ],
  "maximumStaleness": string,
  "vehicleTypes": [
    {
      object (VehicleType)
    }
  ],
  "requiredAttributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "requiredOneOfAttributes": [
    {
      object (VehicleAttributeList)
    }
  ],
  "requiredOneOfAttributeSets": [
    {
      object (VehicleAttributeList)
    }
  ],
  "orderBy": enum (VehicleMatchOrder),
  "includeBackToBack": boolean,
  "tripId": string,
  "currentTripsPresent": enum (CurrentTripsPresent),
  "filter": string
}
ক্ষেত্র
header

object ( RequestHeader )

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

pickupPoint

object ( TerminalLocation )

প্রয়োজন। কাছাকাছি অনুসন্ধান করার জন্য পিকআপ পয়েন্ট.

dropoffPoint

object ( TerminalLocation )

গ্রাহকের উদ্দিষ্ট ড্রপঅফ অবস্থান। যদি tripTypes TripType.SHARED থাকে তাহলে ক্ষেত্রটি প্রয়োজনীয়।

pickupRadiusMeters

integer

প্রয়োজন। পিকআপ পয়েন্টের চারপাশে গাড়ির অনুসন্ধান ব্যাসার্ধ সংজ্ঞায়িত করে। শুধুমাত্র অনুসন্ধান ব্যাসার্ধের মধ্যে যানবাহন ফেরত দেওয়া হবে. মান অবশ্যই 400 এবং 10000 মিটারের মধ্যে হতে হবে (অন্তর্ভুক্ত)।

count

integer

প্রয়োজন। ফেরার জন্য সর্বাধিক সংখ্যক যানবাহন নির্দিষ্ট করে। মান অবশ্যই 1 থেকে 50 এর মধ্যে হতে হবে (অন্তর্ভুক্ত)।

minimumCapacity

integer

প্রয়োজন। ভ্রমণের জন্য বিবেচনা করা যাত্রীদের সংখ্যা নির্দিষ্ট করে৷ মান অবশ্যই একটির থেকে বেশি বা সমান হতে হবে৷ চালককে ক্ষমতার মান বিবেচনা করা হয় না।

tripTypes[]

enum ( TripType )

প্রয়োজন। প্রস্তাবিত ট্রিপের প্রকারের প্রতিনিধিত্ব করে। ঠিক এক প্রকার অন্তর্ভুক্ত করতে হবে। UNKNOWN_TRIP_TYPE অনুমোদিত নয়৷ অনুসন্ধানটি শুধুমাত্র সেই যানবাহনগুলিতে সীমাবদ্ধ করে যা সেই ট্রিপের ধরণকে সমর্থন করতে পারে৷

maximumStaleness

string ( Duration format)

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

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

vehicleTypes[]

object ( VehicleType )

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

requiredAttributes[]

object ( VehicleAttribute )

কলাররা 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[]

object ( VehicleAttributeList )

প্রতিটি VehicleAttributeList এ অন্তত একটি নির্দিষ্ট বৈশিষ্ট্য সহ শুধুমাত্র সেই যানবাহনগুলিতে অনুসন্ধান সীমাবদ্ধ করে৷ প্রতিটি তালিকার মধ্যে, একটি গাড়ির অন্তত একটি বৈশিষ্ট্যের সাথে মেলে। এই ক্ষেত্রটি প্রতিটি VehicleAttributeList এ একটি অন্তর্ভুক্তিমূলক বিচ্ছিন্নতা/বা অপারেশন এবং VehicleAttributeList এর সংগ্রহ জুড়ে একটি সংযোগ/AND অপারেশন।

requiredOneOfAttributeSets[]

object ( VehicleAttributeList )

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 এর সংগ্রহ জুড়ে অন্তর্ভুক্ত বিচ্ছিন্নতা/বা অপারেশন।

orderBy

enum ( VehicleMatchOrder )

প্রয়োজন। ফলাফলের জন্য পছন্দসই ক্রম মানদণ্ড নির্দিষ্ট করে।

includeBackToBack

boolean

এটি নির্দেশ করে যে একক সক্রিয় ট্রিপ সহ যানবাহন এই অনুসন্ধানের জন্য যোগ্য কিনা। এই ক্ষেত্রটি শুধুমাত্র তখনই ব্যবহৃত হয় যখন currentTripsPresent অনির্দিষ্ট থাকে। যখন currentTripsPresent অনির্দিষ্ট থাকে এবং এই ক্ষেত্রটি false হয়, নির্ধারিত ট্রিপ সহ যানবাহনগুলি অনুসন্ধান ফলাফল থেকে বাদ দেওয়া হয়৷ যখন currentTripsPresent অনির্দিষ্ট থাকে এবং এই ক্ষেত্রটি true হয়, অনুসন্ধানের ফলাফলে ENROUTE_TO_DROPOFF স্ট্যাটাস আছে এমন একটি সক্রিয় ট্রিপ সহ যানবাহন অন্তর্ভুক্ত করতে পারে। যখন currentTripsPresent নির্দিষ্ট করা হয়, তখন এই ক্ষেত্রটি সত্যে সেট করা যাবে না।

ডিফল্ট মান false .

tripId

string

এই SearchVehicleRequest এর সাথে যুক্ত ট্রিপ নির্দেশ করে।

currentTripsPresent

enum ( CurrentTripsPresent )

এটি নির্দেশ করে যে সক্রিয় ট্রিপ সহ যানবাহন এই অনুসন্ধানের জন্য যোগ্য কিনা। এটি অবশ্যই CURRENT_TRIPS_PRESENT_UNSPECIFIED ছাড়া অন্য কিছুতে সেট করতে হবে যদি tripType SHARED অন্তর্ভুক্ত থাকে।

filter

string

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

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

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

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

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

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

সফল হলে, রেসপন্স বডিতে SearchVehiclesResponse এর একটি উদাহরণ থাকে।