सड़क का इकट्ठा किया गया डेटा, टाइम सीरीज़ डेटा के तौर पर उपलब्ध कराया जाता है. इसमें यह जानकारी शामिल होती है:
- यात्रा की अवधि
- तेज़ी से पढ़ने के इंटरवल (एसआरआई)
- रास्ते की ज्यामिति
BigQuery सेट अप करना
BigQuery में सड़क से जुड़ा डेटा ऐक्सेस करने से पहले, आपको अपना Google Cloud प्रोजेक्ट सेट अप करना होगा. साथ ही, डेटा एक्सचेंज के लिए सदस्यता लेनी होगी.
ज़रूरी शर्तें
पक्का करें कि आपके Google Cloud प्रोजेक्ट और खाते में ये कॉन्फ़िगरेशन हों:
- BigQuery API चालू करें. निर्देशों के लिए, Google Cloud Console की मदद से, सार्वजनिक डेटासेट से क्वेरी करना लेख पढ़ें.
- Analytics Hub API को चालू करें. Analytics हब API देखें.
- ज़रूरी आईएएम भूमिकाएं असाइन करें. पक्का करें कि आपके खाते में, सदस्य से जुड़े टास्क करने और डेटासेट बनाने के लिए ये भूमिकाएं हों:
- Analytics Hub Subscriber
(
roles/analyticshub.subscriber)- BigQuery उपयोगकर्ता
(
roles/bigquery.user)
- BigQuery उपयोगकर्ता
(
डेटा एक्सचेंज की सदस्यता लेना
सड़क का डेटा, BigQuery (Analytics Hub) में निजी डेटा एक्सचेंज के ज़रिए आपके साथ शेयर किया जाता है. आपके डेटा को ऐक्सेस करने के लिए, आपको Google के किसी पार्टनर से सदस्यता लेने का लिंक मिलेगा. यह डेटासेट, नाम रखने के इस तरीके का पालन करता है:
historical_roads_data_PROJECT_NUMBER.
अपने डेटा की सदस्यता लेने के लिए:
- Google के पार्टनर से मिले सदस्यता लिंक पर क्लिक करें. इस लिंक पर क्लिक करने से, आपको सीधे Google Cloud console में डेटा एक्सचेंज करने की सुविधा पर ले जाया जाएगा.
- Google Cloud console में, डेटा एक्सचेंज की जानकारी देखें.
- डायलॉग बॉक्स में, सदस्यता लें बटन पर क्लिक करें.
- सदस्यता लेने की प्रोसेस पूरी होने के बाद, लिंक किया गया डेटासेट, Google Cloud Console में BigQuery के एक्सप्लोरर पैनल में दिखता है. अब एक्सप्लोरर पैनल में दिखाए गए टेबल के नामों का इस्तेमाल करके, अपनी एसक्यूएल क्वेरी में मौजूद डेटा को ऐक्सेस किया जा सकता है.
BigQuery टेबल
चुने गए रास्तों का इकट्ठा किया गया सड़क का डेटा, Google के मालिकाना हक वाले क्लाउड प्रोजेक्ट के अलग किए गए BigQuery डेटासेट में होस्ट किया जाता है. इसे आपके साथ शेयर किया जाता है. इसके लिए, BigQuery में सिर्फ़ आपके लिए बनाया गया एक प्राइवेट डेटा एक्सचेंज इस्तेमाल किया जाता है. यह डेटा, Analytics हब के ज़रिए शेयर किया जाता है. डेटा ऐक्सेस करने के लिए, आपको डेटा एक्सचेंज की सदस्यता लेनी होगी. साथ ही, अपने Google Cloud प्रोजेक्ट में लिंक किया गया डेटासेट बनाना होगा.
शेयर किए गए BigQuery डेटासेट में, Google की बनाई गई और तय की गई कुछ BigQuery टेबल शामिल होती हैं. यहां हर टेबल के बारे में जानकारी दी गई है.
historical_travel_time टेबल
BigQuery टेबल historical_travel_time का स्कीमा यहां दिया गया है:
| नाम | मोड | टाइप | ब्यौरा |
|---|---|---|---|
| selected_route_id | NULLABLE | स्ट्रिंग | selected_route_id ज़्यादा |
| display_name | NULLABLE | स्ट्रिंग | रास्ते का डिसप्ले नेम |
| record_time | NULLABLE | टाइमस्टैंप | रास्ते का डेटा कैलकुलेट किए जाने का टाइमस्टैंप |
| duration_in_seconds | NULLABLE | FLOAT | ट्रैफ़िक की जानकारी के हिसाब से रास्ते की अवधि |
| static_duration_in_seconds | NULLABLE | FLOAT | रास्ते पर ट्रैफ़िक की जानकारी न होने पर यात्रा का समय |
| route_geometry | NULLABLE | GEOGRAPHY | रास्ते की पॉलीलाइन ज्यामिति, जिसमें ट्रैफ़िक की जानकारी शामिल होती है |
| road_segment_ids | दोहराया गया | स्ट्रिंग | रास्ते में पड़ने वाली सड़कों के सेगमेंट, जिन्हें प्लेस आईडी के तौर पर दिखाया गया है |
टेबल के काम करने के तरीके और तथ्य
- इस टेबल को दिन के हिसाब से बांटा गया है. साथ ही, हर पार्टीशन के लिए 10 साल की समयसीमा तय की गई है.
- इस टेबल को हर घंटे अपडेट किया जाता है. इसमें ट्रैफ़िक की जानकारी बैच में लिखी जाती है.
- Roads Selection API में नया रास्ता बनाने के बाद, इस टेबल में डेटा दिखने में एक घंटे तक का समय लग सकता है.
- किसी रास्ते को Roads Selection API से हटाने के बाद, उस रास्ते के लिए इस टेबल में कोई नया डेटा नहीं लिखा जाता. हालांकि, पुराना डेटा तब तक मौजूद रहता है, जब तक इसकी समयसीमा खत्म नहीं हो जाती.
- रास्ते के साथ-साथ सड़क के सेगमेंट, टोपोलॉजिकल क्रम में होते हैं और हमेशा कनेक्टेड होते हैं.
recent_roads_data टेबल
ध्यान दें: यह टेबल सिर्फ़ तब उपलब्ध होती है, जब आपके कानूनी समझौते में सड़क से जुड़ा रीयल-टाइम डेटा शामिल हो.
historical_travel_time से अलग, इस टेबल में ऑफ़सेट पर आधारित तेज़ी से पढ़ने के इंटरवल (speed_reading_offsets) और लेगसी कोऑर्डिनेट पर आधारित तेज़ी से पढ़ने के इंटरवल (speed_reading_intervals) भी शामिल होते हैं. BigQuery में स्कीमा यहां दिया गया है:
| नाम | मोड | टाइप | ब्यौरा |
|---|---|---|---|
| selected_route_id | NULLABLE | स्ट्रिंग | selected_route_id ज़्यादा |
| display_name | NULLABLE | स्ट्रिंग | रास्ते का डिसप्ले नेम |
| record_time | NULLABLE | टाइमस्टैंप | रास्ते का डेटा कैलकुलेट किए जाने का टाइमस्टैंप |
| duration_in_seconds | NULLABLE | FLOAT | ट्रैफ़िक की जानकारी के हिसाब से रास्ते की अवधि |
| static_duration_in_seconds | NULLABLE | FLOAT | रास्ते पर ट्रैफ़िक की जानकारी न होने पर यात्रा का समय |
| route_geometry | NULLABLE | GEOGRAPHY | रास्ते की पॉलीलाइन ज्यामिति, जिसमें ट्रैफ़िक की जानकारी शामिल होती है |
| speed_reading_intervals | दोहराया गया | रिकॉर्ड | कोऑर्डिनेट के आधार पर, स्पीड रीडिंग के लेगसी इंटरवल. 9 नवंबर, 2026 को या इसके बाद, इस रिपोर्ट में डेटा दिखना बंद हो सकता है. इसके बजाय, speed_reading_offsets का इस्तेमाल करें. तेज़ी से पढ़ने की सुविधा के लिए तय किए गए समय अंतराल देखें. |
| speed_reading_intervals.interval_coordinates | दोहराया गया | GEOGRAPHY | लेगसी. ऐसा हो सकता है कि 9 नवंबर, 2026 को या इसके बाद, इस रिपोर्ट में डेटा दिखना बंद हो जाए. इसके बजाय, speed_reading_offsets का इस्तेमाल करें. इस इंटरवल के लिए
ज्यामिति |
| speed_reading_intervals.speed | NULLABLE | स्ट्रिंग | लेगसी. 9 नवंबर, 2026 को या इसके बाद, इस रिपोर्ट में डेटा दिखना बंद हो सकता है. इसके बजाय,
speed_reading_offsets का इस्तेमाल करें. इस इंटरवल के लिए स्पीड का क्लासिफ़िकेशन. संभावित वैल्यू: NORMAL, SLOW, TRAFFIC_JAM. इस लेगसी फ़ील्ड में, भारी ट्रैफ़िक जाम (गहरा लाल) को भी TRAFFIC_JAM के तौर पर रिपोर्ट किया जाता है. TRAFFIC_JAM_HEAVY का इस्तेमाल कभी नहीं किया जाता. |
| road_segment_ids | दोहराया गया | स्ट्रिंग | रास्ते में मौजूद सड़क के सेगमेंट, जिन्हें जगह के आईडी के तौर पर दिखाया जाता है |
| speed_reading_offsets | दोहराया गया | रिकॉर्ड | ऑफ़सेट के आधार पर, तेज़ी से पढ़ने के अंतराल. ये अंतराल, पूरे रास्ते पर ट्रैफ़िक की डेंसिटी दिखाते हैं. हर अंतराल को, रास्ते की शुरुआत से दूरी के ऑफ़सेट के हिसाब से तय किया जाता है. स्पीड रीडिंग इंटरवल देखें. |
| speed_reading_offsets.start_offset | NULLABLE | पूर्णांक | रास्ते की शुरुआत से लेकर, इंटरवल की शुरुआत तक की दूरी का ऑफ़सेट (मीटर में). इसमें इंटरवल की शुरुआत शामिल है |
| speed_reading_offsets.end_offset | NULLABLE | पूर्णांक | रास्ते की शुरुआत से लेकर इंटरवल के आखिर तक की दूरी का ऑफ़सेट (मीटर में). यह दूरी, इंटरवल में शामिल नहीं होती. यह दूरी, अगले इंटरवल के start_offset के बराबर होती है |
| speed_reading_offsets.speed | NULLABLE | स्ट्रिंग | इस इंटरवल के लिए स्पीड की कैटगरी, Google Maps की ट्रैफ़िक लेयर में मौजूद रंगों के हिसाब से तय की जाती है. संभावित वैल्यू: NORMAL (हरा), SLOW (पीला), TRAFFIC_JAM (लाल), TRAFFIC_JAM_HEAVY (गहरा लाल, 8 अक्टूबर, 2026 से उपलब्ध है) |
टेबल के काम करने के तरीके और तथ्य
- टेबल को दिन के हिसाब से बांटा गया है. साथ ही, हर पार्टीशन के लिए 60 दिनों की समयसीमा सेट की गई है.
- इस टेबल को हर घंटे अपडेट किया जाता है. इसमें ट्रैफ़िक की जानकारी बैच में लिखी जाती है.
- Roads Selection API में नया रास्ता बनाने के बाद, इस टेबल में डेटा दिखने में एक घंटे तक का समय लग सकता है.
- किसी रास्ते को Roads Selection API से हटाने के बाद, उस रास्ते के लिए इस टेबल में कोई नया डेटा नहीं लिखा जाएगा. हालांकि, पुराना डेटा तब तक मौजूद रहता है, जब तक इसकी समयसीमा खत्म नहीं हो जाती.
- रास्ते के साथ-साथ सड़क के सेगमेंट, टोपोलॉजिकल क्रम में होते हैं और हमेशा कनेक्टेड होते हैं.
speed_reading_offsetsकॉलम में, 8 अक्टूबर, 2026 को या इसके बाद रिकॉर्ड की गई लाइनों के लिए वैल्यू भरी जाती है. पिछली पंक्तियों में खाली कलेक्शन हैं.- ऐसा हो सकता है कि 9 नवंबर, 2026 या इसके बाद, लेगसी
speed_reading_intervalsकॉलम में डेटा अपने-आप न भरे. इसके बजाय,speed_reading_offsetsका इस्तेमाल करें.
routes_status टेबल
टेबल में, चुने गए रूट का मेटाडेटा और स्टेटस की जानकारी होती है. इसका मकसद, सभी रास्तों और स्टेटस को आसानी से देखने का तरीका उपलब्ध कराना है. डेटा फ़िल्टर करने के लिए, इसे अन्य दो टेबल के साथ जोड़ा जा सकता है. यहां BigQuery में स्कीमा दिया गया है:
| नाम | मोड | टाइप | ब्यौरा |
|---|---|---|---|
| selected_route_id | NULLABLE | स्ट्रिंग | selected_route_id ज़्यादा |
| display_name | NULLABLE | स्ट्रिंग | रास्ते का डिसप्ले नेम |
| status* | NULLABLE | स्ट्रिंग | रास्ते की स्थिति |
| validation_error | NULLABLE | स्ट्रिंग | रास्ते की पुष्टि करने में गड़बड़ी |
| low_road_usage_start_time | NULLABLE | टाइमस्टैंप | वह समय जब फिर से पुष्टि करने के दौरान, पहली बार रास्ते पर कम ट्रैफ़िक देखा गया. यह VALIDATION_ERROR_LOW_ROAD_USAGE से जुड़ा है. |
| route_attributes | NULLABLE | स्ट्रिंग | चुने गए रास्ते के लिए कस्टम एट्रिब्यूट |
*इस टेबल में रूट की स्थिति, STATE_ के बजाय STATUS_ से शुरू होती है. यह Roads Selection API के साथ काम करता है.
टेबल के काम करने का तरीका और उससे जुड़े तथ्य
- इस टेबल में, सिर्फ़ STATUS_RUNNING या STATUS_INVALID स्टेटस वाले रूट शामिल किए जाते हैं.
- रास्तों का मेटाडेटा और स्टेटस, हर घंटे अपडेट होता रहता है.
- Roads Selection API में नया रूट बनाने के बाद, इस टेबल में रूट दिखने में एक घंटे तक का समय लग सकता है.
- किसी रास्ते को Roads Selection API से मिटाने के बाद, चुने गए रास्ते को इस टेबल से हटाने में एक घंटे तक का समय लग सकता है.