सड़क का इकट्ठा किया गया डेटा, टाइम सीरीज़ डेटा के तौर पर उपलब्ध कराया जाता है. इसमें यह जानकारी शामिल होती है:
- यात्रा की अवधि
- तेज़ी से पढ़ने के इंटरवल (एसआरआई)
- रास्ते की ज्यामिति
BigQuery सेट अप करना
BigQuery में सड़क का डेटा ऐक्सेस करने से पहले, आपको अपना Google Cloud प्रोजेक्ट सेट अप करना होगा. साथ ही, डेटा एक्सचेंज के लिए सदस्यता लेनी होगी.
ज़रूरी शर्तें
पक्का करें कि आपके Google Cloud प्रोजेक्ट और खाते में ये कॉन्फ़िगरेशन हों:
- BigQuery API चालू करें. निर्देशों के लिए, Google Cloud Console की मदद से, किसी सार्वजनिक डेटासेट से क्वेरी करना लेख पढ़ें.
- Analytics Hub API चालू करें. Analytics Hub API देखें.
- ज़रूरी आईएएम भूमिकाएं असाइन करें. पक्का करें कि आपके खाते में ये भूमिकाएं हों, ताकि सदस्य से जुड़े टास्क पूरे किए जा सकें और डेटासेट बनाए जा सकें:
- Analytics हब का सदस्य
(
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 Hub) में आपके लिए खास तौर पर बनाया गया एक निजी डेटा एक्सचेंज इस्तेमाल किया जाता है. डेटा ऐक्सेस करने के लिए, आपको डेटा एक्सचेंज की सदस्यता लेनी होगी. साथ ही, अपने 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 से अलग, इस टेबल में SpeedReadingInterval का डेटा भी शामिल होता है. 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 | दोहराया गया | रिकॉर्ड | इंटरवल, पूरे रास्ते पर ट्रैफ़िक की डेंसिटी दिखाते हैं. Routes API में मूल परिभाषा देखें |
| speed_reading_intervals.interval_coordinates | दोहराया गया | GEOGRAPHY | इस इंटरवल के लिए जियॉमेट्री |
| speed_reading_intervals.speed | NULLABLE | स्ट्रिंग | इस इंटरवल के लिए स्पीड का क्लासिफ़िकेशन. ये वैल्यू इस्तेमाल की जा सकती हैं: NORMAL, SLOW, TRAFFIC_JAM |
| road_segment_ids | दोहराया गया | स्ट्रिंग | रास्ते में पड़ने वाली सड़कों के सेगमेंट, जिन्हें प्लेस आईडी के तौर पर दिखाया जाता है |
टेबल के काम करने के तरीके और तथ्य
- टेबल को दिन के हिसाब से बांटा जाता है. साथ ही, हर पार्टीशन के लिए 60 दिनों की समयसीमा सेट की जाती है.
- इस टेबल को हर घंटे अपडेट किया जाता है. इसमें ट्रैफ़िक की जानकारी बैच में लिखी जाती है.
- Roads Selection API में नया रास्ता बनाने के बाद, इस टेबल में डेटा दिखने में एक घंटे तक का समय लग सकता है.
- रास्ते को Roads Selection API से हटाने के बाद, इस टेबल में रास्ते के लिए कोई नया डेटा नहीं लिखा जाएगा. हालांकि, पुराना डेटा तब तक मौजूद रहता है, जब तक इसकी समयसीमा खत्म नहीं हो जाती.
- रास्ते के साथ-साथ सड़क के सेगमेंट, टोपोलॉजिकल क्रम में होते हैं और हमेशा जुड़े रहते हैं.
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 से मिटाने के बाद, इस टेबल से चुने गए रास्ते को हटाने में एक घंटे तक का समय लग सकता है.