রুট যাচাইকরণ সম্পর্কে বোঝা

আপনি রুট তৈরি করার পরে, Roads Selection API একটি যাচাইকরণ প্রক্রিয়া সম্পাদন করে। এই যাচাইকরণ নিশ্চিত করে যে রুটটি Roads Management Insights-এর মধ্যে ডেটা সংগ্রহ এবং আপডেটের জন্য উপযুক্ত। প্রসেসটি সাধারণত কয়েক মিনিটের মধ্যে সম্পূর্ণ হয়ে যায়।

API রেসপন্সে state ফিল্ডের মাধ্যমে আপনার রুটের যাচাইকরণ স্ট্যাটাস মনিটর করতে পারবেন। আপনি get এন্ডপয়েন্ট ব্যবহার করে এটি চেক করতে পারবেন, যেমন বেছে নেওয়া রুট পান লিঙ্কে বর্ণনা করা হয়েছে অথবা BigQuery-তে routes_status টেবিল পরীক্ষা করে।

রুটের অবস্থা

SelectedRoute রিসোর্সের state ফিল্ডটি বর্তমান যাচাইকরণ ও অপারেশনাল স্ট্যাটাস নির্দেশ করে। state ফিল্ডে নিম্নলিখিত ভ্যালু থাকতে পারে:

• STATE_UNSPECIFIED: এই রুটের যাচাইকরণের স্ট্যাটাস সেট করা নেই।
• STATE_VALIDATING: রুট যাচাই করা হচ্ছে।
• STATE_RUNNING: রুটটি যাচাইকরণে সফলভাবে উত্তীর্ণ হয়েছে এবং এখন অ্যাক্টিভ আছে। API সক্রিয়ভাবে ডেটা সংগ্রহ করছে এবং এই রুটের জন্য BigQuery, Pub/Sub বা উভয় প্ল্যাটফর্মে পর্যায়ক্রমিক আপডেট পাঠাচ্ছে।
• STATE_DELETING: রুটটি মুছে ফেলার জন্য চিহ্নিত করা হয়েছে এবং সিস্টেম থেকে সরানো হচ্ছে।
• STATE_INVALID: নির্দিষ্ট মাপকাঠির ভিত্তিতে রুট যাচাই করা যায়নি। কোনও রুট STATE_INVALID-এ থাকলে, উত্তরে একটি validationError ফিল্ড থাকে যেখানে যাচাইকরণ কেন ব্যর্থ হয়েছে তার বিবরণ থাকে।

যাচাইকরণ সংক্রান্ত সমস্যা

SelectedRoute রিসোর্সের state STATE_INVALID হলে, API উত্তরে validationError ফিল্ড অন্তর্ভুক্ত থাকে। এই ফিল্ডে যাচাইকরণে ব্যর্থতার নির্দিষ্ট কারণ উল্লেখ করা থাকে।

validationError ফিল্ডে নিম্নলিখিত মান থাকতে পারে:

• VALIDATION_ERROR_UNSPECIFIED: এই রুটের জন্য যাচাইকরণ সংক্রান্ত সমস্যা সেট করা নেই।
• VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: রুটটি আপনার প্রোজেক্টের অনুমোদিত এক্তিয়ারের বাইরে।
• VALIDATION_ERROR_LOW_ROAD_USAGE: রুটে রাস্তার ব্যবহার কম, অর্থাৎ অর্থপূর্ণ বিশ্লেষণের জন্য পর্যাপ্ত ট্রাফিক ডেটা সংগ্রহ করা যাবে না। রাস্তার ব্যবহার কম হওয়ার কারণে কোনও রুটকে ভুল হিসেবে শ্রেণীবদ্ধ করা হলে, ট্রাফিকের পরিমাণ পূর্বনির্ধারিত থ্রেশহোল্ডের উপরে বৃদ্ধি পেলে এটি আবার সঠিক হিসেবে বিবেচিত হতে পারে। কম রাস্তা ব্যবহার করা হয় এমন রুট থেকে আরও জানুন।

কম রাস্তা ব্যবহার করা হয় এমন রুট

API যদি নির্ধারণ করে যে ধারাবাহিক বিশ্লেষণের জন্য পর্যাপ্ত ট্রাফিক ডেটা নেই, তাহলে রুটগুলি VALIDATION_ERROR_LOW_ROAD_USAGE দিয়ে ফ্ল্যাগ করা হতে পারে। প্রাথমিক যাচাইকরণ বা চলমান মূল্যায়নের সময় এটি ঘটতে পারে।

কম ব্যবহার করা হয় এমন রুটের ক্ষেত্রে কী প্রত্যাশা করবেন:

• BigQuery-তে ডেটা প্রকাশ করা চালিয়ে যাওয়া হয়: কোনও রুট কম ব্যবহার হওয়ার কারণে STATE_INVALID হিসেবে শ্রেণীবদ্ধ করা হলেও, API সেই রুটের জন্য উপলভ্য যেকোনও ডেটা প্রসেস করা এবং BigQuery-তে প্রকাশ করা চালিয়ে যায়।
• Pub/Sub আপডেট বন্ধ হয়ে যায়: রুটের state পরিবর্তন হয়ে STATE_INVALID হয়ে গেলে, Pub/Sub-এ নির্দিষ্ট সময় অন্তর রিয়েল-টাইম আপডেট বন্ধ হয়ে যায়।
• ত্রৈমাসিক মূল্যায়ন: API ট্রাফিক ভলিউমের জন্য সমস্ত অ্যাক্টিভ রুটের ত্রৈমাসিক মূল্যায়ন করে।
  • মূল্যায়নের সময় কম ট্রাফিক শনাক্ত করা হলে, API SelectedRoute রিসোর্সের মধ্যে সতর্কতা জারি করে।
  • পরপর চার কোয়ার্টার ধরে ট্রাফিক কম থাকলে, রুটের state পরিবর্তন হয়ে STATE_INVALID হয়ে যায় এবং Pub/Sub আপডেট বন্ধ হয়ে যায়।
• আবার যাচাই করা সম্ভব: কোনও রুট STATE_INVALID হলেও, এটি চলমান ট্রাফিক মূল্যায়নের সাপেক্ষে থাকে। পরবর্তী মূল্যায়নগুলি রুটটিকে বৈধ (STATE_RUNNING) হিসাবে পুনরায় শ্রেণীবদ্ধ করতে পারে যদি এর ট্রাফিক ভলিউম পূর্বনির্ধারিত থ্রেশহোল্ডের উপরে বৃদ্ধি পায়।
• মনিটর করার স্ট্যাটাস: আপনি বেছে নেওয়া রুট পান-এ যেভাবে বর্ণনা করা হয়েছে সেই অনুযায়ী get এন্ডপয়েন্টের মাধ্যমে অথবা BigQuery-তে routes_status টেবিল পরীক্ষা করে কোনও রুটের যাচাইকরণ স্ট্যাটাস মনিটর করতে পারবেন।

ভুল রুট সংক্রান্ত সমস্যার সমাধান করা

আপনার রুট state যদি STATE_INVALID হয়, তাহলে আপনি যে validationError পাবেন তার উপর ভিত্তি করে সমস্যার সমাধান সংক্রান্ত পরবর্তী নির্দেশিকা অনুসরণ করুন:

• VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: এই সমস্যার অর্থ হল, আপনার প্রোজেক্টের জন্য অনুমোদিত ভৌগোলিক এলাকার বাইরেও নির্দিষ্ট রুটটি বিস্তৃত। এটি ঠিক করতে, আগে থেকে থাকা রুট মুছে দিন এবং আবার রুট তৈরি করুন, নিশ্চিত করুন যে এর সব পয়েন্ট (শুরু, গন্তব্য এবং যেকোনও মধ্যবর্তী পয়েন্ট) আপনার অনুমোদিত প্রোজেক্টের এক্তিয়ারের মধ্যে আছে।

• VALIDATION_ERROR_LOW_ROAD_USAGE: এই সমস্যার অর্থ হল, বেছে নেওয়া রুটে অর্থপূর্ণ বিশ্লেষণ ও আপডেট করার জন্য রাস্তা ব্যবহার সংক্রান্ত পর্যাপ্ত ডেটা নেই। এটি ঠিক করতে, আগে থেকে থাকা রুট মুছে দিন এবং ডেটা সংগ্রহের জন্য বেশি রাস্তা ব্যবহার করা হয় বা "ব্যস্ত" এমন এলাকা বেছে নিয়ে রুট আবার তৈরি করুন। মনে রাখবেন যে আপনার রুটে এই সমস্যা থাকলে, সময়ের সাথে সাথে ট্রাফিক বাড়লে রুটের স্ট্যাটাস আবার STATE_RUNNING-এ পরিবর্তন হতে পারে, যেমনটি কম রাস্তা ব্যবহার করা রুট-এ বর্ণনা করা হয়েছে।