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

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

एपीआई के जवाब में मौजूद state फ़ील्ड की मदद से, अपने रास्तों की पुष्टि की स्थिति की निगरानी की जा सकती है. चुने गए रास्ते पाना में बताए गए तरीके के मुताबिक, get एंडपॉइंट का इस्तेमाल करके या BigQuery में routes_status टेबल की जांच करके, यह देखा जा सकता है.

रास्ते की स्थितियां

state फ़ील्ड, SelectedRoute संसाधन में मौजूद इसकी मौजूदा पुष्टि की स्थिति और ऑपरेशनल स्टेटस दिखाता है. 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 में वापस आ सकती है. इसके बारे में, कम ट्रैफ़िक वाले रास्ते लेख में बताया गया है.