- HTTP অনুরোধ
- পাথ প্যারামিটার
- শরীরের অনুরোধ
- প্রতিক্রিয়া শরীর
- VehicleAttributelist
- যানবাহন ম্যাচ অর্ডার
- বর্তমান ট্রিপ বর্তমান
- যানবাহন ম্যাচ
- ওয়েপয়েন্ট
- VehicleMatchType
অনুরোধের বিকল্পগুলির সাথে মেলে এমন যানবাহনের একটি তালিকা প্রদান করে৷
HTTP অনুরোধ
POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles:search
URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
পাথ প্যারামিটার
পরামিতি | |
---|---|
parent | প্রয়োজন। ফর্ম্যাট |
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
JSON প্রতিনিধিত্ব |
---|
{ "header": { object ( |
ক্ষেত্র | |
---|---|
header | স্ট্যান্ডার্ড ফ্লিট ইঞ্জিন অনুরোধ শিরোনাম। |
pickupPoint | প্রয়োজন। কাছাকাছি অনুসন্ধান করার জন্য পিকআপ পয়েন্ট. |
dropoffPoint | গ্রাহকের উদ্দিষ্ট ড্রপঅফ অবস্থান। যদি |
pickupRadiusMeters | প্রয়োজন। পিকআপ পয়েন্টের চারপাশে গাড়ির অনুসন্ধান ব্যাসার্ধ সংজ্ঞায়িত করে। শুধুমাত্র অনুসন্ধান ব্যাসার্ধের মধ্যে যানবাহন ফেরত দেওয়া হবে. মান অবশ্যই 400 এবং 10000 মিটারের মধ্যে হতে হবে (অন্তর্ভুক্ত)। |
count | প্রয়োজন। ফেরার জন্য সর্বাধিক সংখ্যক যানবাহন নির্দিষ্ট করে। মান অবশ্যই 1 থেকে 50 এর মধ্যে হতে হবে (অন্তর্ভুক্ত)। |
minimumCapacity | প্রয়োজন। ভ্রমণের জন্য বিবেচনা করা যাত্রীদের সংখ্যা নির্দিষ্ট করে৷ মান অবশ্যই একটির থেকে বেশি বা সমান হতে হবে৷ চালককে ক্ষমতার মান বিবেচনা করা হয় না। |
tripTypes[] | প্রয়োজন। প্রস্তাবিত ট্রিপের প্রকারের প্রতিনিধিত্ব করে। ঠিক এক প্রকার অন্তর্ভুক্ত করতে হবে। |
maximumStaleness | নির্দিষ্ট সময়ের মধ্যে ফ্লিট ইঞ্জিনে অবস্থান আপডেট পাঠানো হয়েছে এমন যানবাহনগুলিতে অনুসন্ধান সীমাবদ্ধ করে৷ স্থির যানবাহনগুলি এখনও তাদের অবস্থানগুলিকে ট্রান্সমিট করে বাসি বলে বিবেচিত হয় না৷ যদি এই ক্ষেত্রটি সেট করা না থাকে, সার্ভারটি ডিফল্ট মান হিসাবে পাঁচ মিনিট ব্যবহার করে। নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' |
vehicleTypes[] | প্রয়োজন। নির্দিষ্ট ধরনের একটির সাথে যানবাহনে অনুসন্ধান সীমাবদ্ধ করে। অন্তত একটি গাড়ির ধরন নির্দিষ্ট করতে হবে। |
requiredAttributes[] | কলাররা
নির্দিষ্ট বৈশিষ্ট্য সহ শুধুমাত্র সেই যানবাহনগুলিতে অনুসন্ধান সীমাবদ্ধ করে৷ এই ক্ষেত্রটি একটি সংযোগ/এন্ড অপারেশন। সর্বাধিক 50টি প্রয়োজনীয় বৈশিষ্ট্য অনুমোদিত। এটি একটি গাড়িতে অনুমোদিত সর্বাধিক সংখ্যক বৈশিষ্ট্যের সাথে মেলে। |
requiredOneOfAttributes[] | প্রতিটি |
requiredOneOfAttributeSets[] |
একটি |
orderBy | প্রয়োজন। ফলাফলের জন্য পছন্দসই ক্রম মানদণ্ড নির্দিষ্ট করে। |
includeBackToBack | এটি নির্দেশ করে যে একক সক্রিয় ট্রিপ সহ যানবাহন এই অনুসন্ধানের জন্য যোগ্য কিনা। এই ক্ষেত্রটি শুধুমাত্র তখনই ব্যবহৃত হয় যখন ডিফল্ট মান |
tripId | এই |
currentTripsPresent | এটি নির্দেশ করে যে সক্রিয় ট্রিপ সহ যানবাহন এই অনুসন্ধানের জন্য যোগ্য কিনা। এটি অবশ্যই |
filter | ঐচ্ছিক। যানবাহন অনুসন্ধান করার সময় প্রয়োগ করার জন্য একটি ফিল্টার প্রশ্ন। ফিল্টার সিনট্যাক্সের উদাহরণের জন্য http://aip.dev/160 দেখুন। এই ক্ষেত্রটি এই ফিল্টারটি অন্যান্য সীমাবদ্ধতার সাথে একটি AND ক্লজ হিসাবে কাজ করে, যেমন মনে রাখবেন যে শুধুমাত্র গাড়ির অ্যাট্রিবিউটে সমর্থিত প্রশ্নগুলি (উদাহরণস্বরূপ, এছাড়াও, সমস্ত বৈশিষ্ট্য স্ট্রিং হিসাবে সংরক্ষণ করা হয়, তাই বৈশিষ্ট্যগুলির সাথে শুধুমাত্র সমর্থিত তুলনাগুলি হল স্ট্রিং তুলনা। সংখ্যা বা বুলিয়ান মানের সাথে তুলনা করার জন্য, স্ট্রিং হিসাবে বিবেচনা করার জন্য মানগুলিকে স্পষ্টভাবে উদ্ধৃত করতে হবে (উদাহরণস্বরূপ, |
প্রতিক্রিয়া শরীর
vehicles.search
প্রতিক্রিয়া বার্তা।
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
JSON প্রতিনিধিত্ব |
---|
{
"matches": [
{
object ( |
ক্ষেত্র | |
---|---|
matches[] | |
VehicleAttributelist
গাড়ির বৈশিষ্ট্যগুলির জন্য একটি তালিকার তালিকা ডেটাটাইপ৷
JSON প্রতিনিধিত্ব |
---|
{
"attributes": [
{
object ( |
ক্ষেত্র | |
---|---|
attributes[] | এই সংগ্রহের বৈশিষ্ট্যগুলির একটি তালিকা৷ |
যানবাহন ম্যাচ অর্ডার
প্রতিক্রিয়ায় গাড়ির মিলের ক্রম উল্লেখ করে।
Enums | |
---|---|
UNKNOWN_VEHICLE_MATCH_ORDER | ডিফল্ট, অনির্দিষ্ট বা অচেনা গাড়ির জন্য ব্যবহৃত অর্ডার মেলে। |
PICKUP_POINT_ETA | পিকআপ পয়েন্টে গাড়ি চালানোর সময় দ্বারা আরোহী ক্রম। |
PICKUP_POINT_DISTANCE | পিকআপ পয়েন্ট পর্যন্ত যানবাহন ড্রাইভিং দূরত্ব দ্বারা আরোহী ক্রম. |
DROPOFF_POINT_ETA | ড্রপঅফ পয়েন্টে গাড়ি চালানোর সময় দ্বারা আরোহী ক্রম। অনুরোধে ড্রপঅফ পয়েন্ট উল্লেখ থাকলেই এই অর্ডারটি ব্যবহার করা যাবে। |
PICKUP_POINT_STRAIGHT_DISTANCE | গাড়ির সর্বশেষ রিপোর্ট করা অবস্থান থেকে পিকআপ পয়েন্ট পর্যন্ত সরল-রেখার দূরত্ব দ্বারা আরোহী ক্রম। |
COST | কনফিগার করা ম্যাচ খরচ দ্বারা আরোহী ক্রম. ম্যাচ খরচ সরলরেখার দূরত্ব এবং ETA এর মধ্যে একটি ওজনযুক্ত গণনা হিসাবে সংজ্ঞায়িত করা হয়। ওজন ডিফল্ট মান সহ সেট করা হয় এবং গ্রাহক প্রতি সংশোধন করা যেতে পারে। আপনার প্রকল্পের জন্য এই ওজনগুলি পরিবর্তন করার প্রয়োজন হলে অনুগ্রহ করে Google সহায়তার সাথে যোগাযোগ করুন৷ |
বর্তমান ট্রিপ বর্তমান
একটি গাড়ির বর্তমান ভ্রমণের উপর বিধিনিষেধের প্রকারগুলি নির্দিষ্ট করে৷
Enums | |
---|---|
CURRENT_TRIPS_PRESENT_UNSPECIFIED | উপস্থিত ট্রিপ সহ যানবাহনের প্রাপ্যতা includeBackToBack ফিল্ড দ্বারা নিয়ন্ত্রিত হয়। |
NONE | ট্রিপ ছাড়া যানবাহন অনুসন্ধান ফলাফল প্রদর্শিত হতে পারে. যখন এই মানটি ব্যবহার করা হয়, includeBackToBack true হতে পারে না। |
ANY | সর্বাধিক 5টি বর্তমান ট্রিপ এবং 10টি ওয়েপয়েন্ট সহ যানবাহন অনুসন্ধান ফলাফলে অন্তর্ভুক্ত করা হয়েছে৷ যখন এই মানটি ব্যবহার করা হয়, includeBackToBack true হতে পারে না। |
যানবাহন ম্যাচ
যানবাহন এবং সংশ্লিষ্ট অনুমান রয়েছে যা যানবাহনের জন্য সক্রিয় ট্রিপের পয়েন্টের সাথে মেলে SearchVehiclesRequest
JSON প্রতিনিধিত্ব |
---|
{ "vehicle": { object ( |
ক্ষেত্র | |
---|---|
vehicle | প্রয়োজন। অনুরোধের সাথে মেলে এমন একটি যান। |
vehiclePickupEta | অনুরোধে উল্লেখিত পিকআপ পয়েন্টে গাড়ির ড্রাইভিং ETA। একটি খালি মান গাড়ির জন্য ETA গণনা করতে ব্যর্থতা নির্দেশ করে। যদি RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: |
vehiclePickupDistanceMeters | বিদ্যমান ট্রিপের জন্য যেকোনো মধ্যবর্তী পিকআপ বা ড্রপঅফ পয়েন্ট সহ অনুরোধে উল্লেখিত গাড়ির বর্তমান অবস্থান থেকে পিকআপ পয়েন্টের দূরত্ব। এই দূরত্বের মধ্যে গণনা করা ড্রাইভিং (রুট) দূরত্ব এবং নেভিগেশন শেষ বিন্দু এবং অনুরোধ করা পিকআপ পয়েন্টের মধ্যে সরলরেখার দূরত্ব অন্তর্ভুক্ত। (নেভিগেশন শেষ বিন্দু এবং অনুরোধ করা পিকআপ পয়েন্টের মধ্যে দূরত্ব সাধারণত ছোট।) একটি খালি মান দূরত্ব গণনা করার ক্ষেত্রে একটি ত্রুটি নির্দেশ করে। |
vehiclePickupStraightLineDistanceMeters | প্রয়োজন। অনুরোধে উল্লেখ করা গাড়ি এবং পিকআপ পয়েন্টের মধ্যে সরলরেখার দূরত্ব। |
vehicleDropoffEta | অনুরোধে উল্লিখিত ড্রপ অফ পয়েন্টে সম্পূর্ণ গাড়ির ড্রাইভিং ETA। অনুরোধে উল্লিখিত RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: |
vehiclePickupToDropoffDistanceMeters | অনুরোধে উল্লিখিত পিকআপ পয়েন্ট থেকে ড্রপ অফ পয়েন্ট পর্যন্ত গাড়ির ড্রাইভিং দূরত্ব (মিটারে)। দূরত্বটি শুধুমাত্র দুটি পয়েন্টের মধ্যে এবং এতে গাড়ির অবস্থান বা অন্য কোনো পয়েন্ট অন্তর্ভুক্ত নয় যা গাড়িটি পিকআপ পয়েন্ট বা ড্রপঅফ পয়েন্টে যাওয়ার আগে পরিদর্শন করতে হবে। অনুরোধে একটি |
tripType | প্রয়োজন। অনুরোধের ট্রিপ প্রকার যা পিকআপ পয়েন্টে ETA গণনা করতে ব্যবহৃত হয়েছিল। |
vehicleTripsWaypoints[] | ETA গণনা করতে ব্যবহৃত ওয়েপয়েন্টের অর্ডারকৃত তালিকা। তালিকায় গাড়ির অবস্থান, গাড়ির জন্য সক্রিয় ভ্রমণের পিকআপ পয়েন্ট এবং অনুরোধে দেওয়া পিকআপ পয়েন্ট অন্তর্ভুক্ত রয়েছে। একটি খালি তালিকা গাড়ির জন্য ETA গণনা করতে ব্যর্থতা নির্দেশ করে। |
vehicleMatchType | গাড়ির মিলের ধরন। |
requestedOrderedBy | আদেশে গাড়ির মিল বাছাই করার অনুরোধ করা হয়েছে। |
orderedBy | এই গাড়ির জন্য ব্যবহৃত আসল অর্ডার। সাধারণত এটি অনুরোধ থেকে 'orderBy' ক্ষেত্রের সাথে মিলবে; যাইহোক, নির্দিষ্ট পরিস্থিতিতে যেমন একটি অভ্যন্তরীণ সার্ভার ত্রুটি, একটি ভিন্ন পদ্ধতি ব্যবহার করা যেতে পারে (যেমন |
ওয়েপয়েন্ট
SearchVehiclesResponse
এ VehicleMatch
এর রুট বরাবর মধ্যবর্তী পয়েন্টগুলি বর্ণনা করে। এই ধারণাটিকে অন্য সব শেষ পয়েন্টে TripWaypoint
হিসেবে উপস্থাপন করা হয়।
JSON প্রতিনিধিত্ব |
---|
{
"latLng": {
object ( |
ক্ষেত্র | |
---|---|
latLng | এই ওয়েপয়েন্টের অবস্থান। |
eta | এই ওয়েপয়েন্টে গাড়িটি আসার আনুমানিক সময়। RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: |
VehicleMatchType
গাড়ির মিলের ধরন।
Enums | |
---|---|
UNKNOWN | অজানা গাড়ির মিলের ধরন |
EXCLUSIVE | গাড়িটির বর্তমানে কোনো ট্রিপ নির্ধারিত নেই এবং পিকআপ পয়েন্টে যেতে পারে। |
BACK_TO_BACK | গাড়িটি বর্তমানে একটি ট্রিপের জন্য বরাদ্দ করা হয়েছে, তবে অগ্রগতি ট্রিপ শেষ করার পরে পিকআপ পয়েন্টে যেতে পারে৷ ETA এবং দূরত্বের হিসাব বিদ্যমান ট্রিপকে বিবেচনায় নেয়। |
CARPOOL | শেয়ার্ড রাইডের জন্য গাড়িটির পর্যাপ্ত ক্ষমতা রয়েছে। |
CARPOOL_BACK_TO_BACK | পিকআপ পয়েন্টে যাওয়ার আগে গাড়িটি তার বর্তমান, সক্রিয় ট্রিপ শেষ করবে। ETA এবং দূরত্বের হিসাব বিদ্যমান ট্রিপকে বিবেচনায় নেয়। |