এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

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

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

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

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

চাহিদা অনুযায়ী ভ্রমণ

CreateVehicleRequest (gRPC)
providers.vehicle.create (বিশ্রাম)
Vehicle সম্পদ ( REST , gRPC )

নির্ধারিত কাজ

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

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

চাহিদা অনুযায়ী এবং নির্ধারিত কাজের জন্য, আপনি একটি অনুরোধ বার্তা জারি করে একটি যানবাহন তৈরি এবং আপডেট করতে পারেন, যার সারসংক্ষেপ নিম্নরূপ:

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

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

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

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

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

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

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

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

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

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

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

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

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

অনন্য সত্তা শনাক্তকারী

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

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

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

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

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

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