सड़क से जुड़े इकट्ठा किए गए डेटा को टाइम सीरीज़ डेटा के तौर पर उपलब्ध कराया जाता है. इसमें यह जानकारी शामिल होती है:
- यात्रा की अवधि
- स्पीड रीडिंग इंटरवल (एसआरआई)
- रूट की ज्यामिति
BigQuery सेट अप करना
BigQuery में सड़क से जुड़ा डेटा ऐक्सेस करने से पहले, आपको अपना Google Cloud प्रोजेक्ट सेट अप करना होगा. साथ ही, डेटा एक्सचेंज की सदस्यता लेनी होगी.
ज़रूरी शर्तें
पक्का करें कि आपके Google Cloud प्रोजेक्ट और खाते में ये कॉन्फ़िगरेशन हों:
- BigQuery API को चालू करें. निर्देशों के लिए, Google Cloud कंसोल की मदद से सार्वजनिक डेटासेट को क्वेरी करना लेख पढ़ें.
- Analytics Hub API को चालू करें. Analytics Hub API देखें.
- ज़रूरी आईएएम भूमिकाएं असाइन करें. पक्का करें कि आपके खाते में, सदस्य से जुड़े टास्क करने और डेटासेट बनाने के लिए ये भूमिकाएं हों:
- Analytics Hub Subscriber
(
roles/analyticshub.subscriber)- BigQuery User
(
roles/bigquery.user)
- BigQuery User
(
डेटा एक्सचेंज की सदस्यता लेना
सड़क से जुड़ा आपका डेटा, BigQuery (Analytics Hub) में निजी डेटा एक्सचेंज के ज़रिए आपके साथ शेयर किया जाता है. आपको Google पार्टनर से सदस्यता का एक लिंक मिलेगा. इस लिंक का इस्तेमाल करके, अपने डेटा को ऐक्सेस किया जा सकेगा. यह डेटासेट, नाम रखने के इस तरीके का पालन करता है:
historical_roads_data_PROJECT_NUMBER.
अपने डेटा की सदस्यता लेने के लिए:
- Google पार्टनर से मिले सदस्यता के लिंक पर क्लिक करें. इस लिंक पर क्लिक करने से, आपको सीधे Google Cloud Console में डेटा एक्सचेंज पर ले जाया जाएगा.
- Google Cloud console में, डेटा एक्सचेंज की जानकारी देखें.
- डायलॉग बॉक्स में, सदस्यता लें बटन पर क्लिक करें.
- सदस्यता लेने के बाद, लिंक किया गया डेटासेट, Google Cloud Console में BigQuery एक्सप्लोरर पैनल में दिखता है. अब एक्सप्लोरर पैनल में दिखाए गए टेबल के नामों का इस्तेमाल करके, अपनी SQL क्वेरी में डेटा को ऐक्सेस किया जा सकता है.
BigQuery टेबल
आपके चुने गए रास्तों का इकट्ठा किया गया डेटा, Google के मालिकाना हक वाले क्लाउड प्रोजेक्ट के BigQuery डेटासेट में होस्ट किया जाता है. यह डेटा, आपके साथ एक निजी डेटा एक्सचेंज के ज़रिए शेयर किया जाता है. इसे BigQuery शेयरिंग (Analytics Hub) में खास तौर पर आपके लिए बनाया जाता है. डेटा ऐक्सेस करने के लिए, आपको डेटा एक्सचेंज की सदस्यता लेनी होगी. साथ ही, अपने Google Cloud प्रोजेक्ट में लिंक किया गया डेटासेट बनाना होगा.
शेयर किए गए BigQuery डेटासेट में कुछ BigQuery टेबल शामिल होती हैं. इन्हें Google ने तय और तैयार किया है. हर टेबल की जानकारी यहां दी गई है.
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 | ट्रैफ़िक को ध्यान में रखते हुए, रास्ते पर लगने वाला समय. has_road_closure के true होने पर,
NULL को शामिल नहीं किया गया. |
| static_duration_in_seconds | NULLABLE | FLOAT | ट्रैफ़िक की जानकारी के बिना, रास्ते पर लगने वाला समय |
| route_geometry | NULLABLE | GEOGRAPHY | रास्ते की ट्रैफ़िक-अवेयर पॉलीलाइन ज्यामिति |
| road_segment_ids | दोहराया गया | स्ट्रिंग | रास्ते के साथ-साथ सड़क के सेगमेंट, जिन्हें जगह के आईडी के तौर पर दिखाया जाता है |
| has_road_closure | NULLABLE | बूलियन | क्या रास्ते में सड़क पूरी तरह से बंद है. true होने पर,
duration_in_seconds को छोड़ दिया जाता है (NULL), क्योंकि
रास्ता बंद है. NULL वैल्यू से पता चलता है कि सड़क बंद होने की जानकारी तय नहीं है. |
टेबल के काम करने का तरीका और उससे जुड़े तथ्य
- टेबल को दिन के हिसाब से बांटा गया है. साथ ही, हर हिस्से के लिए 10 साल की समयसीमा सेट की गई है.
- टेबल को हर घंटे अपडेट किया जाता है. इसमें बैच में लिखे गए ट्रैफ़िक का नया डेटा शामिल होता है.
- Roads Selection API में नया रूट बनाने के बाद, इस टेबल में डेटा दिखने में एक घंटे तक का समय लग सकता है.
- Roads Selection API से कोई रास्ता मिटाने के बाद, इस टेबल में उस रास्ते के लिए कोई नया डेटा नहीं जोड़ा जाता. हालांकि, पुराना डेटा तब तक मौजूद रहता है, जब तक उसकी समयसीमा खत्म नहीं हो जाती.
- रूट के साथ मौजूद सड़क के सेगमेंट, टोपोलॉजिकल ऑर्डर के हिसाब से होते हैं और हमेशा कनेक्ट रहते हैं.
has_road_closureफ़्लैग, Google Maps पर सड़क पूरी तरह से बंद होने की स्थिति के मुताबिक होता हैसे मैच करता है.
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 | ट्रैफ़िक को ध्यान में रखते हुए, रास्ते पर लगने वाला समय. has_road_closure के true होने पर,
NULL को शामिल नहीं किया गया. |
| 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 | दोहराया गया | रिकॉर्ड | ऑफ़सेट के आधार पर स्पीड रीडिंग इंटरवल, जो पूरे रास्ते में ट्रैफ़िक की डेंसिटी दिखाते हैं. हर इंटरवल को रास्ते की शुरुआत से दूरी के ऑफ़सेट के हिसाब से तय किया जाता है. has_road_closure के true होने पर, इसे शामिल नहीं किया जाता. स्पीड रीडिंग इंटरवल देखें. |
| 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 से उपलब्ध) |
| has_road_closure | NULLABLE | बूलियन | क्या रास्ते में सड़क पूरी तरह से बंद है. जब true,
duration_in_seconds, और speed_reading_offsets
को हटा दिया जाता है, क्योंकि रास्ता बंद है. NULL वैल्यू से पता चलता है कि सड़क बंद होने की जानकारी तय नहीं है. |
टेबल के काम करने का तरीका और उससे जुड़े तथ्य
- टेबल को दिन के हिसाब से बांटा जाता है. साथ ही, हर हिस्से के लिए 60 दिनों की समयसीमा सेट की जाती है.
- टेबल को हर घंटे अपडेट किया जाता है. इसमें बैच में लिखे गए ट्रैफ़िक का नया डेटा शामिल होता है.
- Roads Selection API में नया रूट बनाने के बाद, इस टेबल में डेटा दिखने में एक घंटे तक का समय लग सकता है.
- Roads Selection API से किसी रास्ते को मिटाने के बाद, इस टेबल में उस रास्ते के लिए कोई नया डेटा नहीं लिखा जाएगा. हालांकि, पुराना डेटा तब तक मौजूद रहता है, जब तक उसकी समयसीमा खत्म नहीं हो जाती.
- रूट के साथ मौजूद सड़क के सेगमेंट, टोपोलॉजिकल ऑर्डर के हिसाब से होते हैं और हमेशा कनेक्ट रहते हैं.
speed_reading_offsetsकॉलम में, 8 अक्टूबर, 2026 को या इसके बाद रिकॉर्ड की गई पंक्तियों का डेटा भरा जाता है. पहले की पंक्तियों में खाली कलेक्शन हैं.- ऐसा हो सकता है कि लेगसी
speed_reading_intervalsकॉलम में 9 नवंबर, 2026 को या इसके बाद, डेटा अपने-आप भरना बंद हो जाए. इसके बजाय,speed_reading_offsetsका इस्तेमाल करें. has_road_closureफ़्लैग, Google Maps पर सड़क पूरी तरह से बंद होने की स्थिति के मुताबिक होता हैसे मैच करता है.
routes_status टेबल
टेबल में, चुने गए रूट का मेटाडेटा और स्टेटस की जानकारी होती है. इसका मकसद, सभी रूट और उनकी स्थिति को देखने का आसान तरीका उपलब्ध कराना है. डेटा फ़िल्टर करने के लिए, इसे अन्य दो टेबल के साथ जोड़ा जा सकता है. यहां BigQuery में स्कीमा दिया गया है:
| नाम | मोड | टाइप | ब्यौरा |
|---|---|---|---|
| selected_route_id | NULLABLE | स्ट्रिंग | selected_route_id |
| display_name | NULLABLE | स्ट्रिंग | रास्ते का डिसप्ले नेम |
| status* | NULLABLE | स्ट्रिंग | Status of the route |
| validation_error | NULLABLE | स्ट्रिंग | रूट की पुष्टि करते समय गड़बड़ी हुई |
| low_road_usage_start_time | NULLABLE | टाइमस्टैंप | वह समय जब फिर से पुष्टि करने के दौरान, रास्ते पर पहली बार कम ट्रैफ़िक देखा गया. यह VALIDATION_ERROR_LOW_ROAD_USAGE से जुड़ा है. |
| route_attributes | NULLABLE | स्ट्रिंग | चुने गए रास्ते के लिए कस्टम एट्रिब्यूट |
| dynamic_routing | NULLABLE | बूलियन | इससे पता चलता है कि रूट डाइनैमिक (true) है या तय (false). dynamicRouting देखें. |
| origin | NULLABLE | GEOGRAPHY | रास्ते का शुरुआती वेपॉइंट |
| डेस्टिनेशन | NULLABLE | GEOGRAPHY | रास्ते का डेस्टिनेशन वेपॉइंट |
| इंटरमीडिएट | दोहराया गया | GEOGRAPHY | रास्ते के इंटरमीडिएट वेपॉइंट |
| static_route_geometry | NULLABLE | GEOGRAPHY | वेपॉइंट से लाइव ट्रैफ़िक के बिना कैलकुलेट किए गए स्टैटिक रूट की पॉलीलाइन ज्यामिति |
| road_segment_ids | दोहराया गया | स्ट्रिंग | लाइव ट्रैफ़िक के बिना कैलकुलेट किए गए स्टैटिक रूट के साथ मौजूद सड़क के सेगमेंट. इन्हें जगह के आईडी के तौर पर दिखाया जाता है |
टेबल के काम करने का तरीका और उससे जुड़े तथ्य
- इस टेबल में सिर्फ़ STATUS_RUNNING या STATUS_INVALID स्टेटस वाले रूट शामिल किए जाते हैं.
- रास्तों का मेटाडेटा और स्टेटस, हर घंटे अपडेट होता है.
- Roads Selection API में नया रूट बनाने के बाद, इस टेबल में रूट दिखने में एक घंटे तक का समय लग सकता है.
- Roads Selection API से कोई रूट मिटाने के बाद, उसे इस टेबल से हटने में एक घंटा लग सकता है.
- तय किए गए रास्तों (
dynamic_routing: false) के लिए,road_segment_idsमें मौजूद जगह के आईडी अपने-आप अपडेट हो जाते हैं. इससे Google के रोड नेटवर्क में हुए बदलाव दिखते हैं. हालांकि, रास्ता वही रहता है. डाइनैमिक रूट (dynamic_routing: true) के लिए,road_segment_idsको अपडेट नहीं किया जाता.