এই নথিটি ফ্লিট ইঞ্জিনে অন-ডিমান্ড ট্রিপ পরিষেবার বর্ণনা দেয়। এটা অনুমান আপনি পড়েছেন ফ্লিট ইঞ্জিন কি? এবং আপনার প্রয়োজনীয় নির্দিষ্ট ফ্লিট ইঞ্জিন পরিষেবা ক্ষমতা সম্পর্কে সচেতন।
আপনি এই ডকুমেন্টেশন পড়ার সময়, নিম্নলিখিত মনে রাখবেন:
- আপনি ট্রিপ এবং সেই ট্রিপটি সম্পন্নকারী ড্রাইভারের মধ্যে বাস্তব-বিশ্বের সম্পর্ককে মডেল করার উপায় হিসাবে যানবাহনে ট্রিপ নির্ধারণ করেন ৷ ফ্লিট ইঞ্জিনে যানবাহন কীভাবে কাজ করে তা আরও ভালভাবে বুঝতে যানবাহনের ভূমিকা পড়ুন।
- এই দস্তাবেজটি গাড়ির কিছু উপাদানেরও বর্ণনা করে যা শুধুমাত্র অন-ডিমান্ড ট্রিপের ক্ষেত্রে প্রযোজ্য।
- অন-ডিমান্ড ট্রিপের জন্য ফ্লিট ইঞ্জিন দুটি সম্পদ ব্যবহার করে : একটি
Tripএবং একটিVehicle। ফ্লিট ইঞ্জিন একটি gRPC পরিষেবা এবং REST ইন্টারফেস উভয়ই প্রদান করে:
একটি অন-ডিমান্ড ট্রিপ কি?
ফ্লিট ইঞ্জিনে, একটি ট্রিপ একটি অন-ডিমান্ড যাত্রার প্রতিনিধিত্ব করে যা বিভিন্ন পরিবহন লক্ষ্য পূরণ করতে পারে। যেমন:
- মানুষ : পিকআপ থেকে ড্রপ-অফ অবস্থানে এক বা একাধিক ব্যক্তিকে পরিবহন করুন।
- খাদ্য এবং পণ্য : একটি নির্দিষ্ট ব্যবসায়িক অবস্থান থেকে এক বা একাধিক খাবারের অর্ডার নিন এবং এই অর্ডারগুলি এক বা একাধিক প্রাপককে তাদের অবস্থানে ছেড়ে দিন।
ট্রিপ উপাদান
নিম্নলিখিত চিত্রটি একটি ট্রিপের মৌলিক উপাদানগুলি দেখায়: নির্ধারিত গাড়ির আইডি, ট্রিপ স্ট্যাটাস এবং ট্রিপ ওয়েপয়েন্ট। যাত্রার পর্যায়ের উপর নির্ভর করে ওয়েপয়েন্টের ধরন পরিবর্তিত হয়: পিকআপ, ইন্টারমিডিয়েট এবং ড্রপ-অফ। যেকোনো ট্রিপে, একটি মধ্যবর্তী গন্তব্য বা ওয়েপয়েন্ট ঐচ্ছিক। চিত্রের উদাহরণে, গাড়িটি পিকআপ অবস্থানে এসেছে৷

ভ্রমণের জন্য ডেটা মডেল
যেহেতু আপনার ব্যাকএন্ড যানবাহনগুলির জন্য ট্রিপ নির্ধারণ করে, এটিকে অবশ্যই যানবাহনের জন্য নির্ধারিত অন্যান্য ভ্রমণ সম্পর্কেও জানতে হবে। সেই কারণে, নিম্নলিখিত ডায়াগ্রামগুলি Trip রিসোর্সের ডেটা মডেলকে চিত্রের পাশাপাশি তার সংশ্লিষ্ট Vehicle সংস্থানের জন্য চিত্রিত করে৷ আপনি নিম্নলিখিতগুলি মনে রেখে দুটি সংস্থানের মধ্যে সম্পর্ক অন্বেষণ করতে উভয় চিত্র পর্যালোচনা করতে পারেন:
- ট্রিপ আইডি দ্বারা একটি যানবাহন বরাদ্দ করা হয় .
- ট্রিপ-ভেহিক্যাল অ্যাসোসিয়েশন অনেক-টু-এক । অর্থাৎ, একটি প্রদত্ত ট্রিপ গাড়ির জন্য নির্ধারিত একমাত্র ট্রিপ হতে পারে, অথবা এটি গাড়ির জন্য অনেক ট্রিপের মধ্যে একটি হতে পারে।
- ট্রিপ অবজেক্টে ট্রিপ ওয়েপয়েন্টের দুটি তালিকা থাকে , একটি ট্রিপের জন্য এবং একটি নির্ধারিত গাড়ির জন্য। এটি এই নথিতে আরও বিস্তারিতভাবে ব্যাখ্যা করা হয়েছে।
- অন-ডিমান্ড গাড়িতে ট্রিপ ওয়েপয়েন্টগুলির একটি তালিকাও রয়েছে , যা এই নথিতে আরও সম্পূর্ণভাবে বর্ণিত হয়েছে।
ট্রিপ ডেটা মডেল

যানবাহন ডেটা মডেল

ভ্রমণের ধরন
যখন আপনার পরিষেবা একটি ট্রিপ তৈরি করে, তখন এটি tripType ক্ষেত্রটিকে নিম্নলিখিতগুলির মধ্যে একটি হিসাবে সেট করতে পারে: EXCLUSIVE বা SHARED ৷
এক্সক্লুসিভ ট্রিপ
একটি এক্সক্লুসিভ ট্রিপ হল এমন একটি যার যাত্রা অন্য ট্রিপের সাথে ওভারল্যাপ করে না এবং যা গাড়িটি তার সময়সূচীতে অন্য ট্রিপের আগে বা পরে সম্পূর্ণ করে। এর মানে হল যে যখন আপনার সিস্টেম একচেটিয়া ট্রিপ বরাদ্দ করে, তখন এটি শুধুমাত্র সেগুলিকে ক্রমানুসারে সম্পন্ন করার জন্য একটি যানবাহনে বরাদ্দ করতে পারে, একযোগে নয়। ব্যাখ্যা করার জন্য, আপনি নিম্নলিখিত বৈশিষ্ট্যগুলির সাথে একচেটিয়া ট্রিপ তৈরি করতে পারেন:
- একটি পিকআপ সহ একটি ট্রিপ এবং একটি গাড়ির জন্য একটি একক ড্রপ-অফ যার সময়সূচীতে অন্য কোন ট্রিপ নেই৷
- একটি পিকআপ সহ একটি ট্রিপ, মধ্যবর্তী ওয়েপয়েন্ট এবং একটি গাড়ির জন্য একটি ড্রপ-অফ যার সময়সূচীতে অন্য কোন ট্রিপ নেই৷
- গাড়ির জন্য ইতিমধ্যে নির্ধারিত ট্রিপের শেষে একটি পিকআপ এবং ড্রপ-অফ সহ একটি ট্রিপ যোগ করা হয়েছে৷ এই ক্ষেত্রে, প্রতিটি ট্রিপ অন্যের জন্য একচেটিয়া, তবে ট্রিপগুলি একটি ব্যাক-টু-ব্যাক ফ্যাশনে অর্ডার করা হয়। উপরন্তু, এই ধরনের ট্রিপ প্রয়োজন হলে মধ্যবর্তী গন্তব্য অন্তর্ভুক্ত করতে পারে।
শেয়ার্ড ট্রিপ
একটি শেয়ার্ড ট্রিপ হল এমন একটি যার যাত্রা অন্য ট্রিপ বুকিংয়ের সাথে ওভারল্যাপ করতে পারে। এই ধরনের ট্রিপের জন্য, আপনার সিস্টেম এগুলিকে ইন্টারলিভিং গন্তব্যের সাথে একযোগে ঘটতে বরাদ্দ করতে পারে। উদাহরণস্বরূপ, একটি ট্রিপের জন্য ড্রপ-অফ অন্য ট্রিপের জন্য পিকআপের পরে ঘটতে পারে। উপরন্তু, শেয়ার্ড ট্রিপ মধ্যবর্তী ওয়েপয়েন্ট ব্যবহার নাও করতে পারে।
সাধারণত, আপনি ট্রিপ পরিস্থিতি বিভাগে চিত্রিত শেয়ার্ড পুলিং পরিস্থিতিগুলির একটির জন্য একটি শেয়ার্ড ট্রিপ ব্যবহার করবেন৷
ট্রিপ ওয়েপয়েন্ট
Google মানচিত্রের জন্য, একটি ওয়েপয়েন্ট হল একটি রুট বরাবর একটি স্থান, সাধারণত একটি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক দ্বারা সংজ্ঞায়িত করা হয়। অন-ডিমান্ড ট্রিপের জন্য, একটি ওয়েপয়েন্ট একটি TripWaypoint অবজেক্ট দ্বারা প্রতিনিধিত্ব করা হয়, যাতে নিম্নলিখিতগুলির মতো অতিরিক্ত তথ্য থাকে:
- ট্রিপ আইডি
-
WaypointType, হয় পিকআপ, ইন্টারমিডিয়েট বা ড্রপ-অফ - পূর্ববর্তী ট্রিপ ওয়েপয়েন্ট এবং বর্তমানের মধ্যে পথ এবং দূরত্বের তথ্য
- ট্রিপ ওয়েপয়েন্টের পথ বরাবর ট্রাফিক অবস্থা
- ট্রিপ ওয়েপয়েন্টে ভ্রমণের সময় এবং ETA
রেফারেন্স দেখুন:
ট্রিপ ওয়েপয়েন্ট প্রকার
একটি ট্রিপ ওয়েপয়েন্ট একটি যানবাহন ভ্রমণের সাধারণ জীবনচক্রের সাথে সম্পর্কিত সংজ্ঞায়িত করা হয়:

- পিকআপ ওয়েপয়েন্ট — ট্রিপের উত্স বা শুরুর জন্য ব্যবহৃত হয়, যেমন যখন একজন ড্রাইভার পরবর্তী ডেলিভারির জন্য খাবারের অর্ডার নেয়, বা যখন একজন ড্রাইভার পরে ড্রপ-অফের জন্য একজন ব্যক্তিকে তুলে নেয়।
- ইন্টারমিডিয়েট ওয়েপয়েন্ট —একটি মধ্যবর্তী গন্তব্য যা বিভিন্ন উদ্দেশ্যে ব্যবহার করা যেতে পারে, যেমন যখন একজন ড্রাইভার একই বুকিং পার্টির একজন যাত্রীকে নামিয়ে দেয়, কিন্তু ট্রিপ নিজেই সম্পূর্ণ হয় না, যেহেতু আরও যাত্রী থাকে। এই ওয়েপয়েন্ট ঐচ্ছিক এবং শুধুমাত্র একচেটিয়া ভ্রমণের জন্য ব্যবহার করা যেতে পারে।
- ড্রপ-অফ ওয়েপয়েন্ট — যাত্রার চূড়ান্ত অবস্থানের জন্য ব্যবহৃত হয়, যেমন যখন বাকী যাত্রী গাড়ি থেকে বের হয়।
ট্রিপ ওয়েপয়েন্ট তালিকা
একটি Trip সত্তা ওয়েপয়েন্টের দুটি তালিকা অন্তর্ভুক্ত করে, যার প্রত্যেকটি TripWaypoint টাইপের পুনরাবৃত্তি ক্ষেত্র। একটি তালিকা ট্রিপের জন্য প্রয়োজনীয় সেই ক্ষেত্রগুলিকে বর্ণনা করে এবং অন্যটি ট্রিপের সাথে যুক্ত গাড়ির জন্য অবশিষ্ট সমস্ত ওয়েপয়েন্টগুলি বর্ণনা করে৷ এটি আপনাকে যাত্রার সমস্ত উপাদানের একটি সম্পূর্ণ ছবি পেতে দেয়: ট্রিপ এবং সম্পূর্ণ যানবাহনের যাত্রা।
- যানবাহনের জন্য অবশিষ্ট ওয়েপয়েন্ট - একটি ক্ষেত্র যাকে
vehicle_waypointsবলা হয়। এতে গাড়ির জন্য নির্ধারিত সমস্ত ভ্রমণের জন্য বাকি সমস্ত পথপয়েন্ট রয়েছে। - ট্রিপের জন্য অবশিষ্ট ওয়েপয়েন্টস —একটি ক্ষেত্র যাকে বলা হয়
remaining_waypoints। এটিতে ওয়েপয়েন্ট রয়েছে যে গাড়িটিকে ট্রিপের চূড়ান্ত ড্রপ-অফ পয়েন্টের আগে ক্রমানুসারে ভ্রমণ করতে হবে। ট্রিপ পরিস্থিতিতে দৃশ্যকল্প দেখুন।- একটি একক-গন্তব্য ভ্রমণের জন্য একটি গাড়ির জন্য নির্ধারিত সময়সূচীতে অন্য কোন ট্রিপ নেই, এতে শুধুমাত্র একটি পিকআপ এবং একটি ড্রপ-অফ অবস্থান অন্তর্ভুক্ত থাকবে, ধরে নিলাম গাড়িটি পিকআপ ওয়েপয়েন্ট ছেড়ে যায়নি।
- অন্য কোনো ট্রিপের দৃশ্যের জন্য যেখানে গাড়িটি অন্যান্য ট্রিপের জন্যও নির্ধারিত আছে, তার যাত্রাপথে যেকোন ট্রিপের জন্য অবশিষ্ট ওয়েপয়েন্টগুলিতে অন্যান্য ট্রিপের সমস্ত ওয়েপয়েন্ট অন্তর্ভুক্ত থাকবে যা সেই ট্রিপের জন্য ড্রপ-অফ ওয়েপয়েন্টে পৌঁছানোর আগে গাড়িটিকে অবশ্যই অতিক্রম করতে হবে। উদাহরণস্বরূপ, একটি ব্যাক-টু-ব্যাক ট্রিপে যেখানে গাড়িটি ট্রিপ A-এর জন্য ড্রপ-অফের পথে রয়েছে, ট্রিপ B-এর অবশিষ্ট ওয়েপয়েন্টগুলিতে ট্রিপ A-এর জন্য ড্রপ-অফ ওয়েপয়েন্ট অন্তর্ভুক্ত থাকবে। ফ্লিট ইঞ্জিন
vehicle_waypointsফিল্ড ব্যবহার করে এই তথ্য গণনা করে।
Trip সত্তার জন্য রেফারেন্স দেখুন: gRPC বা REST ।
ট্রিপ দৃশ্যকল্প
নিম্নলিখিত চিত্রগুলি বিভিন্ন সমর্থিত ট্রিপ পরিস্থিতিতে চিত্রিত করে৷ এই পরিস্থিতিতে, শুধুমাত্র শেয়ার্ড পুলিং ট্রিপ SHARED ধরনের হয়; অন্য সব EXCLUSIVE . ডায়াগ্রামগুলি ট্রিপ স্ট্যাটাস এবং ট্রিপ সম্পাদনকারী গাড়ির জন্য অবশিষ্ট ওয়েপয়েন্টগুলিও দেখায়, এই গাইডে পরে বর্ণিত ধারণাগুলি।
একক-গন্তব্য ভ্রমণ
একটি একক-গন্তব্য ট্রিপ হল একটি পিকআপ এবং একটি ড্রপ-অফ অবস্থান সহ একটি EXCLUSIVE ট্রিপ৷ উদাহরণস্বরূপ, একজন চালক এক স্থান থেকে একজন যাত্রীকে তুলে অন্য স্থানে নিয়ে যায়; অথবা একজন ড্রাইভার রেস্তোরাঁ থেকে খাবার ডেলিভারি অর্ডার পুনরুদ্ধার করে এবং একজন গ্রাহকের কাছে ফেলে দেয়। 
বহু-গন্তব্য ভ্রমণ
একটি মাল্টি-ডেস্টিনেশন ট্রিপ হল একটি EXCLUSIVE ট্রিপ যাতে পিকআপ এবং ড্রপ-অফ অবস্থানের মধ্যে এক বা একাধিক মধ্যবর্তী গন্তব্য থাকে। উদাহরণস্বরূপ, তিনজন রাইডশেয়ার গ্রাহক এক ব্যক্তির ফোন থেকে একসাথে একটি রাইড বুক করেন, কিন্তু প্রত্যেকের আলাদা গন্তব্য রয়েছে। 
ব্যাক-টু-ব্যাক ট্রিপ
ব্যাক-টু-ব্যাক ট্রিপগুলি হল EXCLUSIVE ট্রিপ যাতে একের পর এক স্বাধীন ট্রিপের একটি সিরিজ থাকে। চেইনের প্রতিটি ট্রিপ একক বা বহু-গন্তব্য হতে পারে। এই পরিস্থিতিতে, একজন ড্রাইভার বর্তমান ট্রিপ শেষ করার আগে অন্য গ্রাহককে পিক আপ করার প্রতিশ্রুতি দেয়। 
এই ট্রিপগুলি শুধুমাত্র সেই যানবাহনের জন্য বরাদ্দ করা যেতে পারে যা ব্যাক-টু-ব্যাক শিডিউলিংয়ের অনুমতি দেয়। Vehicle REST , gRPC রেফারেন্স দেখুন।
শেয়ার্ড পুলিং ট্রিপ
একটি শেয়ার্ড পুলিং ট্রিপ অন্যান্য ট্রিপের ধরন থেকে আলাদা। প্রথমত, এটি একটি SHARED ট্রিপ হতে হবে, একটি EXCLUSIVE নয়৷ এখানে, যানবাহনটি একচেটিয়া ভ্রমণের মতো ক্রমানুসারে না হয়ে একযোগে ট্রিপগুলি সম্পাদন করে৷ একটি শেয়ার্ড পুলিং ট্রিপ অন্য ট্রিপের সাথে তার যাত্রা শেয়ার করলে, এটি ট্রিপের মধ্যে পিকআপ এবং ড্রপ-অফ অবস্থানের তথ্য শেয়ার করে না। পরিবর্তে, প্রতিটি ট্রিপ একটি একচেটিয়া বুকিং যেমন একটি ট্রিপ বুক করা শেষ ব্যবহারকারী তাদের নিজস্ব ছাড়া অন্য কোনো ট্রিপের পিকআপ বা গন্তব্য তথ্য দেখতে পারে না। যেমন:
- একটি বিমানবন্দর শাটল পরিষেবা বিভিন্ন গ্রাহকদের তাদের বাসস্থান থেকে তুলে নেয় এবং রুট বরাবর বিভিন্ন বিমানবন্দর টার্মিনালে জমা করে। ব্যক্তি 2 ট্রিপের অগ্রগতি ট্র্যাক করতে আপনার ভোক্তা অ্যাপ ব্যবহার করতে পারে, কিন্তু তাদের অ্যাপ শুধুমাত্র তাদের যাত্রার অংশ দেখায় এবং যেখানে 1 ব্যক্তিকে তুলে নেওয়া হয়েছে বা যেখানে 1 ব্যক্তিকে বাদ দেওয়া হবে তা নয়, যদিও তাদের যাত্রার কিছু অংশ ওভারল্যাপ হয়।

- একজন ফুড ডেলিভারি ড্রাইভার একই রেস্তোরাঁ থেকে তিনটি খাবারের অর্ডার তুলে নেয় বিভিন্ন গ্রাহকের বাসস্থানে ডেলিভারি করার জন্য। আপনার ভোক্তা অ্যাপ ব্যবহার করে, ব্যক্তি 3 দেখতে পারে কোথায় এবং কখন তাদের খাবার তোলা হয়েছে এবং ড্রাইভারের রুট দেখতে পারে, কিন্তু 1 এবং 2 জনের জন্য খাবার ড্রপ-অফ অবস্থানগুলি দেখতে পারে না।

ভ্রমণের অবস্থা এবং এর জীবনচক্র
এই বিভাগে ট্রিপ স্ট্যাটাস এবং গাড়ির উপর এর প্রভাব বর্ণনা করে এবং আপনি চাহিদা অনুযায়ী ট্রিপ নির্ধারণ এবং পরিচালনা করার সময় বিভিন্ন পরিস্থিতির সম্মুখীন হন।
একটি ট্রিপ সাধারণত বিভিন্ন রাজ্যের মধ্য দিয়ে অগ্রসর হয়, সৃষ্টি থেকে শেষ পর্যন্ত। বিস্তৃতভাবে বলতে গেলে, একটি ট্রিপ সক্রিয় বা নিষ্ক্রিয় হতে পারে, তার অবস্থার উপর নির্ভর করে। ট্রিপ স্ট্যাটাস ফ্লিট ইঞ্জিনের সাথে বিভিন্ন ব্যবহারের ক্ষেত্রে প্রভাব ফেলে, সেইসাথে আপনার জন্য যাত্রার মাধ্যমে গাড়ির অগ্রগতি সনাক্ত করার ক্ষমতা। এই নথির বাকি অংশ সেই পরিস্থিতিতে আলোচনা করে।
নিম্নলিখিত সারণীটি সক্রিয় এবং নিষ্ক্রিয় ধরণের দ্বারা ভ্রমণের অবস্থা তালিকাভুক্ত করে।
| সক্রিয় ট্রিপ অবস্থা | নিষ্ক্রিয় ট্রিপ স্ট্যাটাস |
|---|---|
NEWUNKNOWN_TRIP_STATUSENROUTE_TO_PICKUPARRIVED_AT_PICKUPENROUTE_TO_INTERMEDIATE_DESTINATIONARRIVED_AT_INTERMEDIATE_DESTINATIONENROUTE_TO_DROPOFF | COMPLETECANCELED |
ট্রিপ স্ট্যাটাস এবং অবশিষ্ট যানবাহন ওয়েপয়েন্ট
ইতিমধ্যেই একটি ট্রিপ চালানো গাড়িতে অতিরিক্ত ট্রিপ দেওয়ার সময়, গাড়ির অবশিষ্ট ওয়েপয়েন্টগুলির মধ্যে সম্পর্ক এবং সেই অবশিষ্ট ওয়েপয়েন্টগুলিকে কীভাবে ট্রিপ স্ট্যাটাস প্রভাবিত করে তা আপনার বোঝা উচিত।
উদাহরণস্বরূপ, আপনি একটি নতুন রাইডশেয়ার অনুরোধ বরাদ্দ করতে পারেন একটি যানবাহন যা শুধুমাত্র একচেটিয়া ট্রিপ সমর্থন করে এবং একটি ট্রিপ সম্পূর্ণ করার মাঝখানে রয়েছে। এই ক্ষেত্রে আপনি ট্রিপটিকে ব্যাক-টু-ব্যাক ট্রিপ হিসাবে মডেল করবেন। এই ধরনের ট্রিপ বরাদ্দ করার সময়, আপনার সিস্টেমকে নিশ্চিত করা উচিত যে নতুন ট্রিপের ওয়েপয়েন্টগুলি চলমান ট্রিপের ওয়েপয়েন্টের পরে ঘটবে।

যানবাহনের যাত্রার সময়, ফ্লিট ইঞ্জিন গাড়ির অবশিষ্ট ওয়েপয়েন্টের তালিকা থেকে পূর্ববর্তী একটি ট্রিপ ওয়েপয়েন্টকে সরিয়ে দেয় শুধুমাত্র তখনই যখন গাড়িটি রিপোর্ট করে যে এটি পরবর্তী গন্তব্যে যাচ্ছে বা সম্পূর্ণ হয়েছে। অর্থাৎ, নিচের যেকোনো একটি:
- ENROUTE_TO_INTERMEDIATE_DESTINATION
- ENROUTE_TO_DROPOFF
- সম্পূর্ণ
যখন ট্রিপ স্ট্যাটাস COMPLETED এ পরিবর্তিত হয়, তখন ফ্লিট ইঞ্জিন গাড়ির অবশিষ্ট ওয়েপয়েন্ট তালিকা থেকে ট্রিপের চূড়ান্ত ওয়েপয়েন্ট সরিয়ে দেয়।
বিপরীতে, একটি ওয়েপয়েন্টে আগমন নির্দেশ করে স্ট্যাটাস পরিবর্তনগুলি সাধারণত গাড়ির জন্য অবশিষ্ট ওয়েপয়েন্টগুলির তালিকার উপর কোন প্রভাব ফেলে না:
- ARRIVED_AT_PICKUP
- ARRIVED_AT_INTERMEDIATE_DESTINATION
- ARRIVED_AT_DROPOFF
একটি অন-ডিমান্ড রাইডের উদাহরণ দিয়ে ব্যাখ্যা করার জন্য: ধরুন ড্রাইভার তাদের বাসস্থান থেকে একজন গ্রাহককে তুলে নিয়ে যায়, তাদের এমন একটি স্থানে নিয়ে যায় যেখানে তারা গ্রাহকের একটি কাজ শেষ করার জন্য অপেক্ষা করে এবং তারপরে গ্রাহককে তাদের বাসস্থানে নিয়ে যায়। যখন প্রাথমিকভাবে তৈরি করা হয়, তখন ট্রিপের তিনটি ওয়েপয়েন্ট থাকে: PICKUP , INTERMEDIATE এবং DROPOFF । নিম্নলিখিত সারণী যাত্রার বিভিন্ন রাজ্যে অবশিষ্ট ওয়েপয়েন্টগুলির জন্য একটি প্রশ্নের ফলাফলকে চিত্রিত করে:
| ট্রিপ স্ট্যাটাস | বাকি পথপয়েন্ট |
|---|---|
ARRIVED_AT_PICKUP | PICKUPINTERMEDIATEDROPOFF |
ENROUTE_TO_INTERMEDIATE_DESTINATION | PICKUPINTERMEDIATEDROPOFF |
ARRIVED_AT_INTERMEDIATE_DESTINATION | PICKUPINTERMEDIATEDROPOFF |
ENROUTE_TO_DROPOFF | PICKUPINTERMEDIATEDROPOFF |
ARRIVED_AT_DROPOFF | PICKUPINTERMEDIATEDROPOFF |
COMPLETE | PICKUPINTERMEDIATEDROPOFF |
পুনরায় নিয়োগ বা বাতিল করা ট্রিপের জন্য স্ট্যাটাসের প্রয়োজনীয়তা
আপনি নিম্নলিখিতগুলির মধ্যে যেকোনো একটি করতে পারার আগে, আপনাকে অবশ্যই NEW বা CANCELED তে ট্রিপ স্ট্যাটাস সেট করতে হবে।
- ভ্রমণের জন্য গাড়ির অ্যাসাইনমেন্ট পরিবর্তন করার সময় । উদাহরণস্বরূপ, যদি একজন চালক একটি ট্রিপের জন্য একটি গাড়ির অ্যাসাইনমেন্ট প্রত্যাখ্যান করেন এবং এটি একটি ভিন্ন যানবাহনে পুনরায় নিয়োগ করা প্রয়োজন।
- একটি ভ্রমণের জন্য একটি গাড়ির অ্যাসাইনমেন্ট সাফ করার সময় । উদাহরণ স্বরূপ, যদি একজন ড্রাইভার রুটে একটি ট্রিপ বাতিল করে এবং আপনি গাড়ির অ্যাসাইনমেন্টটি সাফ করতে চান, তাহলে স্ট্যাটাসটি অবশ্যই
NEWবাCANCELEDহতে হবে।
ট্রিপ স্ট্যাটাসের উপর ভিত্তি করে ফলাফল অনুসন্ধান করুন
আপনি যখন একটি নির্দিষ্ট গাড়ির জন্য SearchTrips পরিষেবা ব্যবহার করেন, তখন এটি SearchTripsResponse এ সক্রিয় ট্রিপের তালিকা প্রদান করে। সক্রিয় ট্রিপগুলি Vehicle সত্তার active_trips ক্ষেত্রেও উপস্থিত হয়৷ বিস্তারিত জানার জন্য SearchTripsResponse রেফারেন্স দেখুন: gRPC বা REST ।
অতএব, সক্রিয় স্থিতি সহ সমস্ত ট্রিপ active_trips ফিল্ডে প্রদর্শিত হবে, কিন্তু সম্পূর্ণ বা বাতিল করা ট্রিপগুলি দেখা যায় না।
এরপর কি
,এই নথিটি ফ্লিট ইঞ্জিনে অন-ডিমান্ড ট্রিপ পরিষেবার বর্ণনা দেয়। এটা অনুমান আপনি পড়েছেন ফ্লিট ইঞ্জিন কি? এবং আপনার প্রয়োজনীয় নির্দিষ্ট ফ্লিট ইঞ্জিন পরিষেবা ক্ষমতা সম্পর্কে সচেতন।
আপনি এই ডকুমেন্টেশন পড়ার সময়, নিম্নলিখিত মনে রাখবেন:
- আপনি ট্রিপ এবং সেই ট্রিপটি সম্পন্নকারী ড্রাইভারের মধ্যে বাস্তব-বিশ্বের সম্পর্ককে মডেল করার উপায় হিসাবে যানবাহনে ট্রিপ নির্ধারণ করেন ৷ ফ্লিট ইঞ্জিনে যানবাহন কীভাবে কাজ করে তা আরও ভালভাবে বুঝতে যানবাহনের ভূমিকা পড়ুন।
- এই দস্তাবেজটি গাড়ির কিছু উপাদানেরও বর্ণনা করে যা শুধুমাত্র অন-ডিমান্ড ট্রিপের ক্ষেত্রে প্রযোজ্য।
- অন-ডিমান্ড ট্রিপের জন্য ফ্লিট ইঞ্জিন দুটি সম্পদ ব্যবহার করে : একটি
Tripএবং একটিVehicle। ফ্লিট ইঞ্জিন একটি gRPC পরিষেবা এবং REST ইন্টারফেস উভয়ই প্রদান করে:
একটি অন-ডিমান্ড ট্রিপ কি?
ফ্লিট ইঞ্জিনে, একটি ট্রিপ একটি অন-ডিমান্ড যাত্রার প্রতিনিধিত্ব করে যা বিভিন্ন পরিবহন লক্ষ্য পূরণ করতে পারে। যেমন:
- মানুষ : পিকআপ থেকে ড্রপ-অফ অবস্থানে এক বা একাধিক ব্যক্তিকে পরিবহন করুন।
- খাদ্য এবং পণ্য : একটি নির্দিষ্ট ব্যবসায়িক অবস্থান থেকে এক বা একাধিক খাবারের অর্ডার নিন এবং এই অর্ডারগুলি এক বা একাধিক প্রাপককে তাদের অবস্থানে ছেড়ে দিন।
ট্রিপ উপাদান
নিম্নলিখিত চিত্রটি একটি ট্রিপের মৌলিক উপাদানগুলি দেখায়: নির্ধারিত গাড়ির আইডি, ট্রিপ স্ট্যাটাস এবং ট্রিপ ওয়েপয়েন্ট। যাত্রার পর্যায়ের উপর নির্ভর করে ওয়েপয়েন্টের ধরন পরিবর্তিত হয়: পিকআপ, ইন্টারমিডিয়েট এবং ড্রপ-অফ। যেকোনো ট্রিপে, একটি মধ্যবর্তী গন্তব্য বা ওয়েপয়েন্ট ঐচ্ছিক। চিত্রের উদাহরণে, গাড়িটি পিকআপ অবস্থানে এসেছে৷

ভ্রমণের জন্য ডেটা মডেল
যেহেতু আপনার ব্যাকএন্ড যানবাহনগুলির জন্য ট্রিপ নির্ধারণ করে, এটিকে অবশ্যই যানবাহনের জন্য নির্ধারিত অন্যান্য ভ্রমণ সম্পর্কেও জানতে হবে। সেই কারণে, নিম্নলিখিত ডায়াগ্রামগুলি Trip রিসোর্সের ডেটা মডেলকে চিত্রের পাশাপাশি তার সংশ্লিষ্ট Vehicle সংস্থানের জন্য চিত্রিত করে৷ আপনি নিম্নলিখিতগুলি মনে রেখে দুটি সংস্থানের মধ্যে সম্পর্ক অন্বেষণ করতে উভয় চিত্র পর্যালোচনা করতে পারেন:
- ট্রিপ আইডি দ্বারা একটি যানবাহন বরাদ্দ করা হয় .
- ট্রিপ-ভেহিক্যাল অ্যাসোসিয়েশন অনেক-টু-এক । অর্থাৎ, একটি প্রদত্ত ট্রিপ গাড়ির জন্য নির্ধারিত একমাত্র ট্রিপ হতে পারে, অথবা এটি গাড়ির জন্য অনেক ট্রিপের মধ্যে একটি হতে পারে।
- ট্রিপ অবজেক্টে ট্রিপ ওয়েপয়েন্টের দুটি তালিকা থাকে , একটি ট্রিপের জন্য এবং একটি নির্ধারিত গাড়ির জন্য। এটি এই নথিতে আরও বিস্তারিতভাবে ব্যাখ্যা করা হয়েছে।
- অন-ডিমান্ড গাড়িতে ট্রিপ ওয়েপয়েন্টগুলির একটি তালিকাও রয়েছে , যা এই নথিতে আরও সম্পূর্ণভাবে বর্ণিত হয়েছে।
ট্রিপ ডেটা মডেল

যানবাহন ডেটা মডেল

ভ্রমণের ধরন
যখন আপনার পরিষেবা একটি ট্রিপ তৈরি করে, তখন এটি tripType ক্ষেত্রটিকে নিম্নলিখিতগুলির মধ্যে একটি হিসাবে সেট করতে পারে: EXCLUSIVE বা SHARED ৷
এক্সক্লুসিভ ট্রিপ
একটি এক্সক্লুসিভ ট্রিপ হল এমন একটি যার যাত্রা অন্য ট্রিপের সাথে ওভারল্যাপ করে না এবং যা গাড়িটি তার সময়সূচীতে অন্য ট্রিপের আগে বা পরে সম্পূর্ণ করে। এর মানে হল যে যখন আপনার সিস্টেম একচেটিয়া ট্রিপ বরাদ্দ করে, তখন এটি শুধুমাত্র সেগুলিকে ক্রমানুসারে সম্পন্ন করার জন্য একটি যানবাহনে বরাদ্দ করতে পারে, একযোগে নয়। ব্যাখ্যা করার জন্য, আপনি নিম্নলিখিত বৈশিষ্ট্যগুলির সাথে একচেটিয়া ট্রিপ তৈরি করতে পারেন:
- একটি পিকআপ সহ একটি ট্রিপ এবং একটি গাড়ির জন্য একটি একক ড্রপ-অফ যার সময়সূচীতে অন্য কোন ট্রিপ নেই৷
- একটি পিকআপ সহ একটি ট্রিপ, মধ্যবর্তী ওয়েপয়েন্ট এবং একটি গাড়ির জন্য একটি ড্রপ-অফ যার সময়সূচীতে অন্য কোন ট্রিপ নেই৷
- গাড়ির জন্য ইতিমধ্যে নির্ধারিত ট্রিপের শেষে একটি পিকআপ এবং ড্রপ-অফ সহ একটি ট্রিপ যোগ করা হয়েছে৷ এই ক্ষেত্রে, প্রতিটি ট্রিপ অন্যের জন্য একচেটিয়া, তবে ট্রিপগুলি একটি ব্যাক-টু-ব্যাক ফ্যাশনে অর্ডার করা হয়। উপরন্তু, এই ধরনের ট্রিপ প্রয়োজন হলে মধ্যবর্তী গন্তব্য অন্তর্ভুক্ত করতে পারে।
শেয়ার্ড ট্রিপ
একটি শেয়ার্ড ট্রিপ হল এমন একটি যার যাত্রা অন্য ট্রিপ বুকিংয়ের সাথে ওভারল্যাপ করতে পারে। এই ধরনের ট্রিপের জন্য, আপনার সিস্টেম এগুলিকে ইন্টারলিভিং গন্তব্যের সাথে একযোগে ঘটতে বরাদ্দ করতে পারে। উদাহরণস্বরূপ, একটি ট্রিপের জন্য ড্রপ-অফ অন্য ট্রিপের জন্য পিকআপের পরে ঘটতে পারে। উপরন্তু, শেয়ার্ড ট্রিপ মধ্যবর্তী ওয়েপয়েন্ট ব্যবহার নাও করতে পারে।
সাধারণত, আপনি ট্রিপ পরিস্থিতি বিভাগে চিত্রিত শেয়ার্ড পুলিং পরিস্থিতিগুলির একটির জন্য একটি শেয়ার্ড ট্রিপ ব্যবহার করবেন৷
ট্রিপ ওয়েপয়েন্ট
Google মানচিত্রের জন্য, একটি ওয়েপয়েন্ট হল একটি রুট বরাবর একটি স্থান, সাধারণত একটি অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক দ্বারা সংজ্ঞায়িত করা হয়। অন-ডিমান্ড ট্রিপের জন্য, একটি ওয়েপয়েন্ট একটি TripWaypoint অবজেক্ট দ্বারা প্রতিনিধিত্ব করা হয়, যাতে নিম্নলিখিতগুলির মতো অতিরিক্ত তথ্য থাকে:
- ট্রিপ আইডি
-
WaypointType, হয় পিকআপ, ইন্টারমিডিয়েট বা ড্রপ-অফ - পূর্ববর্তী ট্রিপ ওয়েপয়েন্ট এবং বর্তমানের মধ্যে পথ এবং দূরত্বের তথ্য
- ট্রিপ ওয়েপয়েন্টের পথ বরাবর ট্রাফিক অবস্থা
- ট্রিপ ওয়েপয়েন্টে ভ্রমণের সময় এবং ETA
রেফারেন্স দেখুন:
ট্রিপ ওয়েপয়েন্ট প্রকার
একটি ট্রিপ ওয়েপয়েন্ট একটি যানবাহন ভ্রমণের সাধারণ জীবনচক্রের সাথে সম্পর্কিত সংজ্ঞায়িত করা হয়:

- পিকআপ ওয়েপয়েন্ট — ট্রিপের উত্স বা শুরুর জন্য ব্যবহৃত হয়, যেমন যখন একজন ড্রাইভার পরবর্তী ডেলিভারির জন্য খাবারের অর্ডার নেয়, বা যখন একজন ড্রাইভার পরে ড্রপ-অফের জন্য একজন ব্যক্তিকে তুলে নেয়।
- ইন্টারমিডিয়েট ওয়েপয়েন্ট —একটি মধ্যবর্তী গন্তব্য যা বিভিন্ন উদ্দেশ্যে ব্যবহার করা যেতে পারে, যেমন যখন একজন ড্রাইভার একই বুকিং পার্টির একজন যাত্রীকে নামিয়ে দেয়, কিন্তু ট্রিপ নিজেই সম্পূর্ণ হয় না, যেহেতু আরও যাত্রী থাকে। এই ওয়েপয়েন্ট ঐচ্ছিক এবং শুধুমাত্র একচেটিয়া ভ্রমণের জন্য ব্যবহার করা যেতে পারে।
- ড্রপ-অফ ওয়েপয়েন্ট — যাত্রার চূড়ান্ত অবস্থানের জন্য ব্যবহৃত হয়, যেমন যখন বাকী যাত্রী গাড়ি থেকে বের হয়।
ট্রিপ ওয়েপয়েন্ট তালিকা
একটি Trip সত্তা ওয়েপয়েন্টের দুটি তালিকা অন্তর্ভুক্ত করে, যার প্রত্যেকটি TripWaypoint টাইপের পুনরাবৃত্তি ক্ষেত্র। একটি তালিকা ট্রিপের জন্য প্রয়োজনীয় সেই ক্ষেত্রগুলিকে বর্ণনা করে এবং অন্যটি ট্রিপের সাথে যুক্ত গাড়ির জন্য অবশিষ্ট সমস্ত ওয়েপয়েন্টগুলি বর্ণনা করে৷ এটি আপনাকে যাত্রার সমস্ত উপাদানের একটি সম্পূর্ণ ছবি পেতে দেয়: ট্রিপ এবং সম্পূর্ণ যানবাহনের যাত্রা।
- যানবাহনের জন্য অবশিষ্ট ওয়েপয়েন্ট - একটি ক্ষেত্র যাকে
vehicle_waypointsবলা হয়। এতে গাড়ির জন্য নির্ধারিত সমস্ত ভ্রমণের জন্য বাকি সমস্ত পথপয়েন্ট রয়েছে। - ট্রিপের জন্য অবশিষ্ট ওয়েপয়েন্টস —একটি ক্ষেত্র যাকে বলা হয়
remaining_waypoints। এটিতে ওয়েপয়েন্ট রয়েছে যে গাড়িটিকে ট্রিপের চূড়ান্ত ড্রপ-অফ পয়েন্টের আগে ক্রমানুসারে ভ্রমণ করতে হবে। ট্রিপ পরিস্থিতিতে দৃশ্যকল্প দেখুন।- একটি একক-গন্তব্য ভ্রমণের জন্য একটি গাড়ির জন্য নির্ধারিত সময়সূচীতে অন্য কোন ট্রিপ নেই, এতে শুধুমাত্র একটি পিকআপ এবং একটি ড্রপ-অফ অবস্থান অন্তর্ভুক্ত থাকবে, ধরে নিলাম গাড়িটি পিকআপ ওয়েপয়েন্ট ছেড়ে যায়নি।
- অন্য কোনো ট্রিপের দৃশ্যের জন্য যেখানে গাড়িটি অন্যান্য ট্রিপের জন্যও নির্ধারিত আছে, তার যাত্রাপথে যেকোন ট্রিপের জন্য অবশিষ্ট ওয়েপয়েন্টগুলিতে অন্যান্য ট্রিপের সমস্ত ওয়েপয়েন্ট অন্তর্ভুক্ত থাকবে যা সেই ট্রিপের জন্য ড্রপ-অফ ওয়েপয়েন্টে পৌঁছানোর আগে গাড়িটিকে অবশ্যই অতিক্রম করতে হবে। উদাহরণস্বরূপ, একটি ব্যাক-টু-ব্যাক ট্রিপে যেখানে গাড়িটি ট্রিপ A-এর জন্য ড্রপ-অফের পথে রয়েছে, ট্রিপ B-এর অবশিষ্ট ওয়েপয়েন্টগুলিতে ট্রিপ A-এর জন্য ড্রপ-অফ ওয়েপয়েন্ট অন্তর্ভুক্ত থাকবে। ফ্লিট ইঞ্জিন
vehicle_waypointsফিল্ড ব্যবহার করে এই তথ্য গণনা করে।
Trip সত্তার জন্য রেফারেন্স দেখুন: gRPC বা REST ।
ট্রিপ দৃশ্যকল্প
নিম্নলিখিত চিত্রগুলি বিভিন্ন সমর্থিত ট্রিপ পরিস্থিতিতে চিত্রিত করে৷ এই পরিস্থিতিতে, শুধুমাত্র শেয়ার্ড পুলিং ট্রিপ SHARED ধরনের হয়; অন্য সব EXCLUSIVE . ডায়াগ্রামগুলি ট্রিপ স্ট্যাটাস এবং ট্রিপ সম্পাদনকারী গাড়ির জন্য অবশিষ্ট ওয়েপয়েন্টগুলিও দেখায়, এই গাইডে পরে বর্ণিত ধারণাগুলি।
একক-গন্তব্য ভ্রমণ
একটি একক-গন্তব্য ট্রিপ হল একটি পিকআপ এবং একটি ড্রপ-অফ অবস্থান সহ একটি EXCLUSIVE ট্রিপ৷ উদাহরণস্বরূপ, একজন চালক এক স্থান থেকে একজন যাত্রীকে তুলে অন্য স্থানে নিয়ে যায়; অথবা একজন ড্রাইভার রেস্তোরাঁ থেকে খাবার ডেলিভারি অর্ডার পুনরুদ্ধার করে এবং একজন গ্রাহকের কাছে ফেলে দেয়। 
বহু-গন্তব্য ভ্রমণ
একটি মাল্টি-ডেস্টিনেশন ট্রিপ হল একটি EXCLUSIVE ট্রিপ যাতে পিকআপ এবং ড্রপ-অফ অবস্থানের মধ্যে এক বা একাধিক মধ্যবর্তী গন্তব্য থাকে। উদাহরণস্বরূপ, তিনজন রাইডশেয়ার গ্রাহক এক ব্যক্তির ফোন থেকে একসাথে একটি রাইড বুক করেন, কিন্তু প্রত্যেকের আলাদা গন্তব্য রয়েছে। 
ব্যাক-টু-ব্যাক ট্রিপ
ব্যাক-টু-ব্যাক ট্রিপগুলি হল EXCLUSIVE ট্রিপ যাতে একের পর এক স্বাধীন ট্রিপের একটি সিরিজ থাকে। চেইনের প্রতিটি ট্রিপ একক বা বহু-গন্তব্য হতে পারে। এই পরিস্থিতিতে, একজন ড্রাইভার বর্তমান ট্রিপ শেষ করার আগে অন্য গ্রাহককে পিক আপ করার প্রতিশ্রুতি দেয়। 
এই ট্রিপগুলি শুধুমাত্র সেই যানবাহনের জন্য বরাদ্দ করা যেতে পারে যা ব্যাক-টু-ব্যাক শিডিউলিংয়ের অনুমতি দেয়। Vehicle REST , gRPC রেফারেন্স দেখুন।
শেয়ার্ড পুলিং ট্রিপ
একটি শেয়ার্ড পুলিং ট্রিপ অন্যান্য ট্রিপের ধরন থেকে আলাদা। প্রথমত, এটি একটি SHARED ট্রিপ হতে হবে, একটি EXCLUSIVE নয়৷ এখানে, যানবাহনটি একচেটিয়া ভ্রমণের মতো ক্রমানুসারে না হয়ে একযোগে ট্রিপগুলি সম্পাদন করে৷ একটি শেয়ার্ড পুলিং ট্রিপ অন্য ট্রিপের সাথে তার যাত্রা শেয়ার করলে, এটি ট্রিপের মধ্যে পিকআপ এবং ড্রপ-অফ অবস্থানের তথ্য শেয়ার করে না। পরিবর্তে, প্রতিটি ট্রিপ একটি একচেটিয়া বুকিং যেমন একটি ট্রিপ বুক করা শেষ ব্যবহারকারী তাদের নিজস্ব ছাড়া অন্য কোনো ট্রিপের পিকআপ বা গন্তব্য তথ্য দেখতে পারে না। যেমন:
- একটি বিমানবন্দর শাটল পরিষেবা বিভিন্ন গ্রাহকদের তাদের বাসস্থান থেকে তুলে নেয় এবং রুট বরাবর বিভিন্ন বিমানবন্দর টার্মিনালে জমা করে। ব্যক্তি 2 ট্রিপের অগ্রগতি ট্র্যাক করতে আপনার ভোক্তা অ্যাপ ব্যবহার করতে পারে, কিন্তু তাদের অ্যাপ শুধুমাত্র তাদের যাত্রার অংশ দেখায় এবং যেখানে 1 ব্যক্তিকে তুলে নেওয়া হয়েছে বা যেখানে 1 ব্যক্তিকে বাদ দেওয়া হবে তা নয়, যদিও তাদের যাত্রার কিছু অংশ ওভারল্যাপ হয়।

- একজন ফুড ডেলিভারি ড্রাইভার একই রেস্তোরাঁ থেকে তিনটি খাবারের অর্ডার তুলে নেয় বিভিন্ন গ্রাহকের বাসস্থানে ডেলিভারি করার জন্য। আপনার ভোক্তা অ্যাপ ব্যবহার করে, ব্যক্তি 3 দেখতে পারে কোথায় এবং কখন তাদের খাবার তোলা হয়েছে এবং ড্রাইভারের রুট দেখতে পারে, কিন্তু 1 এবং 2 জনের জন্য খাবার ড্রপ-অফ অবস্থানগুলি দেখতে পারে না।

ভ্রমণের অবস্থা এবং এর জীবনচক্র
এই বিভাগে ট্রিপ স্ট্যাটাস এবং গাড়ির উপর এর প্রভাব বর্ণনা করে এবং আপনি চাহিদা অনুযায়ী ট্রিপ নির্ধারণ এবং পরিচালনা করার সময় বিভিন্ন পরিস্থিতির সম্মুখীন হন।
একটি ট্রিপ সাধারণত বিভিন্ন রাজ্যের মধ্য দিয়ে অগ্রসর হয়, সৃষ্টি থেকে শেষ পর্যন্ত। বিস্তৃতভাবে বলতে গেলে, একটি ট্রিপ সক্রিয় বা নিষ্ক্রিয় হতে পারে, তার অবস্থার উপর নির্ভর করে। ট্রিপ স্ট্যাটাস ফ্লিট ইঞ্জিনের সাথে বিভিন্ন ব্যবহারের ক্ষেত্রে প্রভাব ফেলে, সেইসাথে আপনার জন্য যাত্রার মাধ্যমে গাড়ির অগ্রগতি সনাক্ত করার ক্ষমতা। এই নথির বাকি অংশ সেই পরিস্থিতিতে আলোচনা করে।
নিম্নলিখিত সারণীটি সক্রিয় এবং নিষ্ক্রিয় ধরণের দ্বারা ভ্রমণের অবস্থা তালিকাভুক্ত করে।
| সক্রিয় ট্রিপ অবস্থা | নিষ্ক্রিয় ট্রিপ স্ট্যাটাস |
|---|---|
NEWUNKNOWN_TRIP_STATUSENROUTE_TO_PICKUPARRIVED_AT_PICKUPENROUTE_TO_INTERMEDIATE_DESTINATIONARRIVED_AT_INTERMEDIATE_DESTINATIONENROUTE_TO_DROPOFF | COMPLETECANCELED |
ট্রিপ স্ট্যাটাস এবং অবশিষ্ট যানবাহন ওয়েপয়েন্ট
ইতিমধ্যেই একটি ট্রিপ চালানো গাড়িতে অতিরিক্ত ট্রিপ দেওয়ার সময়, গাড়ির অবশিষ্ট ওয়েপয়েন্টগুলির মধ্যে সম্পর্ক এবং সেই অবশিষ্ট ওয়েপয়েন্টগুলিকে কীভাবে ট্রিপ স্ট্যাটাস প্রভাবিত করে তা আপনার বোঝা উচিত।
উদাহরণস্বরূপ, আপনি একটি নতুন রাইডশেয়ার অনুরোধ বরাদ্দ করতে পারেন একটি যানবাহন যা শুধুমাত্র একচেটিয়া ট্রিপ সমর্থন করে এবং একটি ট্রিপ সম্পূর্ণ করার মাঝখানে রয়েছে। এই ক্ষেত্রে আপনি ট্রিপটিকে ব্যাক-টু-ব্যাক ট্রিপ হিসাবে মডেল করবেন। এই ধরনের ট্রিপ বরাদ্দ করার সময়, আপনার সিস্টেমকে নিশ্চিত করা উচিত যে নতুন ট্রিপের ওয়েপয়েন্টগুলি চলমান ট্রিপের ওয়েপয়েন্টের পরে ঘটবে।

যানবাহনের যাত্রার সময়, ফ্লিট ইঞ্জিন গাড়ির অবশিষ্ট ওয়েপয়েন্টের তালিকা থেকে পূর্ববর্তী একটি ট্রিপ ওয়েপয়েন্টকে সরিয়ে দেয় শুধুমাত্র তখনই যখন গাড়িটি রিপোর্ট করে যে এটি পরবর্তী গন্তব্যে যাচ্ছে বা সম্পূর্ণ হয়েছে। অর্থাৎ, নিচের যেকোনো একটি:
- ENROUTE_TO_INTERMEDIATE_DESTINATION
- ENROUTE_TO_DROPOFF
- সম্পূর্ণ
যখন ট্রিপ স্ট্যাটাস COMPLETED এ পরিবর্তিত হয়, তখন ফ্লিট ইঞ্জিন গাড়ির অবশিষ্ট ওয়েপয়েন্ট তালিকা থেকে ট্রিপের চূড়ান্ত ওয়েপয়েন্ট সরিয়ে দেয়।
বিপরীতে, একটি ওয়েপয়েন্টে আগমন নির্দেশ করে স্ট্যাটাস পরিবর্তনগুলি সাধারণত গাড়ির জন্য অবশিষ্ট ওয়েপয়েন্টগুলির তালিকার উপর কোন প্রভাব ফেলে না:
- ARRIVED_AT_PICKUP
- ARRIVED_AT_INTERMEDIATE_DESTINATION
- ARRIVED_AT_DROPOFF
একটি অন-ডিমান্ড রাইডের উদাহরণ দিয়ে ব্যাখ্যা করার জন্য: ধরুন ড্রাইভার তাদের বাসস্থান থেকে একজন গ্রাহককে তুলে নিয়ে যায়, তাদের এমন একটি স্থানে নিয়ে যায় যেখানে তারা গ্রাহকের একটি কাজ শেষ করার জন্য অপেক্ষা করে এবং তারপরে গ্রাহককে তাদের বাসস্থানে নিয়ে যায়। যখন প্রাথমিকভাবে তৈরি করা হয়, তখন ট্রিপের তিনটি ওয়েপয়েন্ট থাকে: PICKUP , INTERMEDIATE এবং DROPOFF । নিম্নলিখিত সারণী যাত্রার বিভিন্ন রাজ্যে অবশিষ্ট ওয়েপয়েন্টগুলির জন্য একটি প্রশ্নের ফলাফলকে চিত্রিত করে:
| ট্রিপ স্ট্যাটাস | বাকি পথপয়েন্ট |
|---|---|
ARRIVED_AT_PICKUP | PICKUPINTERMEDIATEDROPOFF |
ENROUTE_TO_INTERMEDIATE_DESTINATION | PICKUPINTERMEDIATEDROPOFF |
ARRIVED_AT_INTERMEDIATE_DESTINATION | PICKUPINTERMEDIATEDROPOFF |
ENROUTE_TO_DROPOFF | PICKUPINTERMEDIATEDROPOFF |
ARRIVED_AT_DROPOFF | PICKUPINTERMEDIATEDROPOFF |
COMPLETE | PICKUPINTERMEDIATEDROPOFF |
পুনরায় নিয়োগ বা বাতিল করা ট্রিপের জন্য স্ট্যাটাসের প্রয়োজনীয়তা
আপনি নিম্নলিখিতগুলির মধ্যে যেকোনো একটি করতে পারার আগে, আপনাকে অবশ্যই NEW বা CANCELED তে ট্রিপ স্ট্যাটাস সেট করতে হবে।
- ভ্রমণের জন্য গাড়ির অ্যাসাইনমেন্ট পরিবর্তন করার সময় । উদাহরণস্বরূপ, যদি একজন চালক একটি ট্রিপের জন্য একটি গাড়ির অ্যাসাইনমেন্ট প্রত্যাখ্যান করেন এবং এটি একটি ভিন্ন যানবাহনে পুনরায় নিয়োগ করা প্রয়োজন।
- একটি ভ্রমণের জন্য একটি গাড়ির অ্যাসাইনমেন্ট সাফ করার সময় । উদাহরণ স্বরূপ, যদি একজন ড্রাইভার রুটে একটি ট্রিপ বাতিল করে এবং আপনি গাড়ির অ্যাসাইনমেন্টটি সাফ করতে চান, তাহলে স্ট্যাটাসটি অবশ্যই
NEWবাCANCELEDহতে হবে।
ট্রিপ স্ট্যাটাসের উপর ভিত্তি করে ফলাফল অনুসন্ধান করুন
আপনি যখন একটি নির্দিষ্ট গাড়ির জন্য SearchTrips পরিষেবা ব্যবহার করেন, তখন এটি SearchTripsResponse এ সক্রিয় ট্রিপের তালিকা প্রদান করে। সক্রিয় ট্রিপগুলি Vehicle সত্তার active_trips ক্ষেত্রেও উপস্থিত হয়৷ বিস্তারিত জানার জন্য SearchTripsResponse রেফারেন্স দেখুন: gRPC বা REST ।
অতএব, সক্রিয় স্থিতি সহ সমস্ত ট্রিপ active_trips ফিল্ডে প্রদর্শিত হবে, কিন্তু সম্পূর্ণ বা বাতিল করা ট্রিপগুলি দেখা যায় না।