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

रास्ता बनाने के बाद, 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 पर सेट हो सकता है. इसके बारे में सड़क का कम इस्तेमाल करने वाले रूट में बताया गया है.