ভূমিকা: গাড়ি তৈরি করা

Fleet Engine-এ কীভাবে গাড়ি কাজ করে সেই সম্পর্কে সাধারণ তথ্যের জন্য, Fleet Engine-এর প্রয়োজনীয় বিভাগে নিম্নলিখিত নির্দেশিকা দেখুন:

• Fleet Engine কী?
• গাড়ির ভূমিকা

এই বিভাগের ডকুমেন্টেশনে Fleet Engine-এ কীভাবে গাড়ি তৈরি ও ম্যানেজ করতে হয় তা বর্ণনা করা হয়েছে। আপনার বাস্তব-জগতের অপারেশনে আসল গাড়ির মতো করে দেখানোর জন্য আপনি Fleet Engine সার্ভার এনভায়রনমেন্টে গাড়ি তৈরি করেন। আপনার Fleet Engine গাড়িগুলি আপনার ব্যাকএন্ড সিস্টেমে ব্যবহৃত গাড়িগুলির সাথেও মিলতে হবে যা আপনি গাড়ি অ্যাসাইনমেন্ট এবং রাউটিংয়ের জন্য ব্যবহার করেন।

আপনি gRPC বা REST ব্যবহার করে একটি গাড়ি রিসোর্স তৈরি করতে, একটি ক্রিয়েট পদ্ধতি ব্যবহার করেন। এই গাইডে ফিল্ডের নামগুলি gRPC নোটেশন ব্যবহার করে যাতে সহজে বোঝা যায়।

চাহিদা মতো ট্রিপ

• CreateVehicleRequest (gRPC)
• providers.vehicle.create (REST)
• Vehicle রিসোর্স (REST, gRPC)

শিডিউল করা টাস্ক

• CreateDeliveryVehicleRequest (gRPC)
• providers.deliveryVehicles.create (REST)
• DeliveryVehicle (REST, gRPC)

মনে রাখবেন: দুটি Fleet Engine vehicle রিসোর্সের জন্য অনুরোধ মেসেজ ও রিসোর্স ফিল্ড মূলত একই ধরনের, যদিও দুটির মধ্যে কিছু নাম আলাদা আলাদা।

গাড়ির অনুরোধ

অন-ডিমান্ড ও শিডিউল করা টাস্কের ক্ষেত্রে, আপনি ফিল্ড সহ একটি অনুরোধ মেসেজ ইস্যু করে গাড়ি তৈরি ও আপডেট করেন, যা নিচে সংক্ষিপ্তভাবে দেওয়া হল:

1. প্যারেন্ট: আপনার Google Cloud প্রোজেক্ট আইডির সাথে যুক্ত একটি স্ট্রিং, যা গাড়ির ইনস্ট্যান্সের নাম ফিল্ড পূরণ করতে ব্যবহার করা হয়।

2. গাড়ির আইডি: গাড়ির name ফিল্ড পপুলেট করার জন্য ব্যবহৃত অনন্য স্ট্রিং।

   মনে রাখবেন: Vehicle ID স্ট্রিংয়ে নির্দিষ্ট অক্ষর সংক্রান্ত বিধিনিষেধ আছে। অটোমেটিক বাড়তে থাকা আইডি এড়িয়ে চলুন এবং নিশ্চিত করুন যে সেগুলিতে ব্যক্তিগতভাবে শনাক্তকরণযোগ্য তথ্য নেই। অক্ষর সংক্রান্ত বিধিনিষেধের ব্যাপারে বিস্তারিত জানতে, CreateVehicleRequest বা CreateDeliveryVehicleRequest-এর জন্য vehicle ID ফিল্ড দেখুন।

3. প্রয়োজনীয় ফিল্ড সহ একটি গাড়ির ইনস্ট্যান্স। আপনি কোন Fleet Engine ক্ষমতা ব্যবহার করছেন তার উপর এইসব ফিল্ড নির্ভর করে।

অনুরোধের বডিতে থাকা তথ্য অনুরোধের ধরনের উপর নির্ভর করে। তাদের নিজ নিজ নির্দেশিকায় সেইসব বিবরণ দেখুন।

যাচাইকরণ ও অনুমোদন টোকেন

Fleet Engine-এ অনুরোধ করার সময় সঠিক অ্যাক্সেস ক্রেডেনশিয়ালও প্রদান করতে হবে। এই গাইডের উদাহরণগুলিতে নিম্নলিখিত অনুমানগুলি রয়েছে:

• gRPC-এর উদাহরণে জাভার জন্য অনুমোদন লাইব্রেরি ব্যবহার করা হয়েছে বলে ধরে নেওয়া হয়।
• REST উদাহরণে একটি HTTP অনুরোধ হেডার দেখানো হয়েছে, যার মধ্যে Authorization ফিল্ডটি Bearer <token> ভ্যালু সহ থাকতে হবে, যেখানে <token> হল একটি JSON ওয়েব টোকেন যা আপনি ইস্যু করেন।

আরও বিবরণের জন্য, Fleet Engine সেট-আপ করুন গাইড দেখুন।

গাড়ির রিসোর্স ফিল্ড

একটি যানবাহন রিসোর্সে নিম্নলিখিত ধরনের ফিল্ড থাকে:

• শুধু আউটপুট ফিল্ড। অন্য কোনও পদ্ধতির আউটপুট হিসেবে পরিষেবা দ্বারা সেট করা ফিল্ড এবং সরাসরি সেট করা যায় না। এই ধরনের একটি গুরুত্বপূর্ণ ফিল্ড হল name ফিল্ড। Fleet Engine, ব্যবহারকারীর নির্দিষ্ট করা আইডি-এর জন্য Google AIP-এর নির্দেশিকা অনুযায়ী, গাড়ির name ফিল্ডের জন্য দেওয়া যেকোনও ভ্যালুকে উপেক্ষা করে। আপনি এইসব ফিল্ডের জন্য ভ্যালু প্রদান করলে, Fleet Engine একটি সমস্যা দেখায়।
• প্রয়োজনীয় ফিল্ড। অন-ডিমান্ড ট্রিপ পরিষেবায় তৈরি করা গাড়ির জন্য তৈরির সময় নির্দিষ্ট ফিল্ড সেট করতে হয়। শিডিউল করা টাস্ক পরিষেবায় তৈরি করা গাড়ির জন্য কোনও প্রয়োজনীয় গাড়ির রিসোর্স ফিল্ড নেই।
• ঐচ্ছিক ফিল্ড। দুটি পরিষেবারই ফিল্ড আছে যা আপনি তৈরি করার সময় বা পরে সেট করতে পারবেন। আপনি যে পরিষেবা ব্যবহার করেন তার জন্য সংশ্লিষ্ট রেফারেন্স গাইডে এগুলি পাওয়া যাবে।

গাড়ির নাম (শুধুমাত্র আউটপুটে)

চাহিদা মতো ট্রিপ ও শিডিউল করা টাস্ক পরিষেবার জন্য name ফিল্ডটি ঠিক একই রকম হয়। আপনি যখন কোনও ভেইকেল তৈরি করেন, তখন Fleet Engine ফিল্ডটি নির্ধারণ করে। এটি ভেইকেল তৈরি করার সময় আপনার সেট করা দুটি ফিল্ডের উপর ভিত্তি করে করা হয়:

• অভিভাবক: আপনার Google Cloud প্রোজেক্ট আইডির সাথে যুক্ত একটি স্ট্রিং, যা providers/{provider} ফর্মের হয়, যেখানে {provider} হল আপনার Cloud প্রোজেক্টের আইডি। কোনও নির্দিষ্ট প্রোজেক্টের জন্য আপনার তৈরি করা প্রতিটি গাড়ির একই পেরেন্ট পাথ থাকবে।

  আপনি যে পরিষেবা ব্যবহার করেন তার জন্য এখানে উল্লেখ করা Cloud প্রোজেক্টে Fleet Engine পরিষেবা অ্যাকাউন্টের ভূমিকাও থাকতে হবে। সেইসব পরিষেবা অ্যাকাউন্টের তালিকা পেতে পরিষেবা অ্যাকাউন্ট দেখুন। Fleet Engine একাধিক Google Cloud প্রোজেক্ট থেকে অ্যাক্সেস করার সুবিধা দেয় না।

• গাড়ির আইডি, যা আপনার ফ্লিটের সব গাড়ির ক্ষেত্রে অনন্য হতে হবে এবং একটি সঠিক ইউনিকোড স্ট্রিং হতে হবে। এটি হল গাড়ির রিসোর্স আইডি। অন-ডিমান্ড ট্রিপ ও শিডিউল করা স্টপ, দু'টি ক্ষেত্রেই এটি ব্যবহার করে, যে গাড়ি ট্রিপ বা টাস্ক সম্পূর্ণ করে তার সাথে সেটি অ্যাসোসিয়েট করা হয়।

Google Cloud-ভিত্তিক পরিষেবায়, সব API-কে অবশ্যই স্ট্রিং হিসেবে রিসোর্স দেখাতে হবে। আরও জানতে Fleet Engine-এ রিসোর্সের নামকরণ দেখুন।

অনন্য এন্টিটি শনাক্তকারী

রিসোর্স কলে ব্যবহৃত অনন্য এন্টিটি শনাক্তকারীর ফর্ম্যাট এবং মান Fleet Engine-এর কাছে অস্পষ্ট। নিশ্চিত করুন যে শনাক্তকারীতে কোনও ব্যক্তিগতভাবে শনাক্তকরণযোগ্য তথ্য (PII) নেই, যেমন ড্রাইভারের ফোন নম্বর।

গাড়ির পুনর্ব্যবহার

কোনও গাড়ি নির্দিষ্ট ভ্রমণসূচীর সব স্টপেজ সম্পূর্ণ করার পরে, সেটি Fleet Engine-এ ৭ দিনের জন্য আবার ব্যবহার করার জন্য উপলভ্য থাকে, যার অর্থ হল আপনি পরবর্তী কাজের দিনগুলিতে নতুন গাড়ি তৈরি না করেই একটি গাড়ি আবার ব্যবহার করতে পারবেন। আপনি যতবার কোনও গাড়ি পুনর্ব্যবহার করবেন, Fleet Engine ততবারই সেটির উপলভ্যতা রিসেট করে দেবে। এর পরে ৭-দিনের কাউন্টডাউন আবার শুরু হবে।

Fleet Engine-এ কোনও গাড়ি উপলভ্য রাখার জন্য সাজেস্ট করা পদ্ধতি হল নিয়মিত বিরতিতে সেটির লোকেশন আপডেট করা। এছাড়াও, Vehicle এন্টিটির বেশিরভাগ অন্যান্য ফিল্ডে আপডেট করলে, এটির মেয়াদ বাড়ানো হবে, তবে নতুন ফিল্ডের ভ্যালু আগেকার ভ্যালুর থেকে আলাদা হতে হবে।

মনে রাখবেন: Vehicle এন্টিটির কিছু ফিল্ড যেমন device_settings হল সম্পূর্ণ ডিবাগ তথ্য যা Fleet Engine-এ সেভ করা হয় না। এগুলি আপডেট করলে Vehicle এন্টিটির আয়ু বাড়ে না।

সিস্টেম অ্যানালিটিক্স উন্নত করতে, একই ড্রাইভার-গাড়ি আইডি পেয়ারিং প্রতিদিন ব্যবহার করা ভাল। আগে শিডিউল করা স্টপ বা অন-ডিমান্ড ট্রিপের জন্য ড্রাইভারের সাথে যুক্ত একই গাড়ি আইডি ব্যবহার করে এটি করুন।

এর পরে কী করতে হবে

• চাহিদা মতো ট্রিপের জন্য গাড়ি তৈরি করা
• শিডিউল করা টাস্কের জন্য একটি ভেহিকল তৈরি করুন