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