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

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

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

অবৈধ রুটের সমস্যা সমাধান করা হচ্ছে

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

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

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