ভূমিকা: যানবাহন তৈরি করুন

ফ্লিট ইঞ্জিনে যানবাহন কীভাবে কাজ করে সে সম্পর্কে সাধারণ তথ্যের জন্য, ফ্লিট ইঞ্জিন অপরিহার্য বিভাগে নিম্নলিখিত নির্দেশিকাগুলি দেখুন:

• ফ্লিট ইঞ্জিন কি?
• যানবাহন পরিচিতি

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

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

যানবাহনের অনুরোধ

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

1. অভিভাবক : আপনার Google ক্লাউড প্রকল্প আইডির সাথে যুক্ত একটি স্ট্রিং, গাড়ির উদাহরণের নাম ক্ষেত্রটি পূরণ করতে ব্যবহৃত হয়।

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

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

অনুরোধের অংশের তথ্য অনুরোধের প্রকৃতির সাথে পরিবর্তিত হয়। তাদের নিজ নিজ গাইড অধীনে যারা বিবরণ দেখুন.

প্রমাণীকরণ এবং অনুমোদন টোকেন

ফ্লীট ইঞ্জিনের অনুরোধগুলিকে অবশ্যই সঠিক অ্যাক্সেসের শংসাপত্র প্রদান করতে হবে। এই গাইডের উদাহরণগুলিতে নিম্নলিখিত অনুমান রয়েছে:

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

আরও বিশদ বিবরণের জন্য, সেট আপ ফ্লিট ইঞ্জিন নির্দেশিকাগুলি দেখুন৷

যানবাহন সম্পদ ক্ষেত্র

একটি যানবাহন সংস্থানের নিম্নলিখিত ধরণের ক্ষেত্র রয়েছে:

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

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

name ক্ষেত্রটি অন-ডিমান্ড ট্রিপ এবং নির্ধারিত টাস্ক পরিষেবার জন্য হুবহু একই। আপনি যখন যানবাহন তৈরি করেন তখন ফ্লিট ইঞ্জিন ক্ষেত্রটিকে সংজ্ঞায়িত করে, যা আপনি যানবাহন তৈরিতে সেট করা দুটি ক্ষেত্রের উপর ভিত্তি করে:

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

  আপনি যে ক্লাউড প্রকল্পটি এখানে উল্লেখ করেছেন সেটিতে আপনার ব্যবহার করা পরিষেবার জন্য ফ্লিট ইঞ্জিন পরিষেবা অ্যাকাউন্টের ভূমিকাও থাকতে হবে। সেই পরিষেবা অ্যাকাউন্টগুলির একটি তালিকার জন্য পরিষেবা অ্যাকাউন্টগুলি দেখুন৷ ফ্লিট ইঞ্জিন একাধিক Google ক্লাউড প্রকল্প থেকে অ্যাক্সেস সমর্থন করে না।

• গাড়ির আইডি , যা আপনার বহরের সমস্ত যানবাহন জুড়ে অনন্য হতে হবে এবং একটি বৈধ ইউনিকোড স্ট্রিং হতে হবে। এটি গাড়ির রিসোর্স আইডি । অন-ডিমান্ড ট্রিপ এবং নির্ধারিত স্টপ উভয়ই এটি ব্যবহার করে একটি ট্রিপ বা একটি টাস্ককে সেই গাড়ির সাথে যুক্ত করতে যা এটি সম্পূর্ণ করে।

Google ক্লাউড-ভিত্তিক পরিষেবাগুলিতে, সমস্ত API গুলিকে অবশ্যই স্ট্রিং হিসাবে সংস্থানগুলি উপস্থাপন করতে হবে৷ আরো বিস্তারিত জানার জন্য ফ্লিট ইঞ্জিনে সম্পদের নামকরণ দেখুন।

স্বতন্ত্র সত্তা শনাক্তকারী

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

যানবাহন পুনরায় ব্যবহার

একটি প্রদত্ত ভ্রমণের জন্য একটি যানবাহন সমস্ত স্টপ শেষ করার পরে, এটি 7 দিনের জন্য ফ্লিট ইঞ্জিনে পুনঃব্যবহারের জন্য উপলব্ধ থাকে, যার অর্থ আপনি একটি নতুন তৈরি না করেই পরবর্তী ব্যবসায়িক দিনে একটি গাড়ি পুনরায় ব্যবহার করতে পারেন৷ প্রতিবার যখন আপনি একটি যানবাহন পুনঃব্যবহার করেন, ফ্লিট ইঞ্জিন তার প্রাপ্যতা পুনরায় সেট করে, সেই সময়ে 7-দিনের কাউন্টডাউন নতুন করে শুরু হয়।

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

দ্রষ্টব্য: Vehicle সত্তার কিছু ক্ষেত্র যেমন device_settings সম্পূর্ণরূপে ডিবাগ তথ্য যা ফ্লিট ইঞ্জিন দ্বারা স্থায়ী হয় না। তাদের আপডেট করা Vehicle সত্তার আয়ু বাড়ায় না।

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

এরপর কি

• অন-ডিমান্ড ট্রিপের জন্য একটি গাড়ি তৈরি করুন
• নির্ধারিত কাজের জন্য একটি যান তৈরি করুন