রুট বৈধতা বুঝুন

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

আপনি এপিআই রেসপন্সের ' state ফিল্ডের মাধ্যমে আপনার রাউটগুলোর ভ্যালিডেশন স্ট্যাটাস নিরীক্ষণ করতে পারেন। 'Get selected routes'- এ বর্ণিত পদ্ধতি অনুযায়ী get ' এন্ডপয়েন্ট ব্যবহার করে, অথবা BigQuery-এর routes_status টেবিলটি পরীক্ষা করে আপনি এটি যাচাই করতে পারেন।

রুট রাজ্যগুলি

একটি SelectedRoute রিসোর্সের state ফিল্ডটি এর বর্তমান বৈধতা যাচাই এবং কার্যক্ষম অবস্থা নির্দেশ করে। state ফিল্ডটির নিম্নলিখিত মানগুলো থাকতে পারে:

• STATE_UNSPECIFIED : এই রুটের বৈধতা অবস্থা সেট করা নেই।
• STATE_VALIDATING : রুটটি যাচাই করা হচ্ছে।
• STATE_RUNNING : রুটটি সফলভাবে যাচাইকরণ সম্পন্ন করেছে এবং এখন সক্রিয়। এপিআই সক্রিয়ভাবে ডেটা সংগ্রহ করছে এবং এই রুটের জন্য 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 : রুটটিতে রাস্তার ব্যবহার কম, যার অর্থ হলো অর্থপূর্ণ বিশ্লেষণের জন্য পর্যাপ্ত ট্র্যাফিক ডেটা সংগ্রহ করা সম্ভব হয়নি। কম ব্যবহারের কারণে অবৈধ হিসেবে চিহ্নিত একটি রুট, ট্র্যাফিকের পরিমাণ একটি পূর্বনির্ধারিত সীমা অতিক্রম করলে পুনরায় বৈধ হতে পারে। ‘Low road usage route’- এ আরও জানুন।

কম রাস্তা ব্যবহারের পথ

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

যেসব রুটে রাস্তা কম ব্যবহৃত হয়, সেগুলোর ক্ষেত্রে যা আশা করা যায় তা নিচে দেওয়া হলো:

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

Troubleshooting invalid routes

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

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

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