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