रास्ते की पुष्टि करने की सुविधा के बारे में जानकारी

रूट बनाने के बाद, Roads Selection API पुष्टि करने की प्रोसेस पूरी करता है. इस पुष्टि से यह पक्का होता है कि रूट, डेटा कलेक्शन और Roads Management Insights में अपडेट के लिए सही है. आम तौर पर, यह प्रोसेस कुछ मिनटों में पूरी हो जाती है.

एपीआई से मिली जानकारी में state फ़ील्ड की मदद से, अपने रूट की पुष्टि की स्थिति को मॉनिटर किया जा सकता है. इसकी जांच करने के लिए, 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 होता है, तब एपीआई से मिले जवाब में validationError फ़ील्ड शामिल होता है. इस फ़ील्ड में, पुष्टि न हो पाने की खास वजह बताई जाती है.

validationError फ़ील्ड में ये वैल्यू हो सकती हैं:

• VALIDATION_ERROR_UNSPECIFIED: इस रूट के लिए, पुष्टि करने से जुड़ी गड़बड़ी सेट नहीं की गई है.
• VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: यह रास्ता आपके प्रोजेक्ट के अधिकार क्षेत्र से बाहर है.
• VALIDATION_ERROR_LOW_ROAD_USAGE: इस रास्ते पर कम गाड़ियां चलती हैं. इसका मतलब है कि विश्लेषण के लिए, ट्रैफ़िक का ज़रूरी डेटा इकट्ठा नहीं किया जा सकता. अगर किसी रास्ते पर ट्रैफ़िक की संख्या, पहले से तय थ्रेशोल्ड से ज़्यादा हो जाती है, तो उसे फिर से मान्य माना जा सकता है. कम इस्तेमाल होने वाली सड़कों वाले रास्ते के बारे में ज़्यादा जानें.

कम इस्तेमाल होने वाली सड़क वाला रास्ता

अगर एपीआई को लगता है कि लगातार विश्लेषण करने के लिए ट्रैफ़िक का ज़रूरी डेटा मौजूद नहीं है, तो रास्तों को VALIDATION_ERROR_LOW_ROAD_USAGE से फ़्लैग किया जा सकता है. ऐसा, पुष्टि करने की शुरुआती प्रक्रिया या समीक्षाओं के दौरान हो सकता है.

कम इस्तेमाल होने वाली सड़कों के लिए, आपको ये सुविधाएं मिलेंगी:

• BigQuery में डेटा पब्लिश करना जारी रहता है: अगर किसी रास्ते को सड़क के कम इस्तेमाल की वजह से STATE_INVALID के तौर पर कैटगरी में रखा गया है, तो भी एपीआई उस रास्ते के लिए उपलब्ध डेटा को प्रोसेस करता रहता है और BigQuery में पब्लिश करता रहता है.
• Pub/Sub अपडेट बंद होना: अगर रूट का state बदलकर STATE_INVALID हो जाता है, तो Pub/Sub को समय-समय पर मिलने वाले रीयल-टाइम अपडेट बंद हो जाते हैं.
• तिमाही समीक्षाएं: एपीआई, ट्रैफ़िक वॉल्यूम के लिए सभी चालू रूट की तिमाही समीक्षाएं करता है.
  • अगर समीक्षा के दौरान कम ट्रैफ़िक का पता चलता है, तो एपीआई 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 में वापस बदल सकती है. ऐसा तब होगा, जब समय के साथ ट्रैफ़िक बढ़ता है, जैसा कि कम इस्तेमाल होने वाले रूट में बताया गया है.