सड़क का इकट्ठा किया गया डेटा, टाइम सीरीज़ डेटा के तौर पर दिया जाता है. इसमें यह जानकारी शामिल होती है:
- यात्रा की अवधि
- तेज़ी से पढ़ने के इंटरवल (एसआरआई)
- रास्ते की ज्यामिति
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 | रास्ते की पॉलीलाइन ज्यामिति, जिसमें ट्रैफ़िक की जानकारी शामिल होती है |
टेबल के काम करने के तरीके और तथ्य
- इस टेबल को दिन के हिसाब से बांटा गया है. साथ ही, हर पार्टीशन के लिए 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 |
टेबल के काम करने के तरीके और तथ्य
- टेबल को दिन के हिसाब से बांटा जाता है. साथ ही, हर पार्टीशन के लिए 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 से मिटाने के बाद, इस टेबल से चुने गए रास्ते को हटाने में एक घंटे तक का समय लग सकता है.