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

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

আপনি API রেসপন্সের state ফিল্ডের মাধ্যমে আপনার রুটের বৈধতা অবস্থা পর্যবেক্ষণ করতে পারেন। আপনি Get selected routes এ বর্ণিত get endpoint ব্যবহার করে অথবা 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 রুটগুলি পেতে বর্ণিত গেট এন্ডপয়েন্টের মাধ্যমে অথবা BigQuery-তে routes_status টেবিল পরীক্ষা করে একটি রুটের বৈধতা অবস্থা পর্যবেক্ষণ করতে পারেন।

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

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

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

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