जीटीएफ़एस-आधारित इंटिग्रेशन

जनरल ट्रांज़िट फ़ीड स्पेसिफ़िकेशन (जीटीएफ़एस), सार्वजनिक परिवहन के शेड्यूल और उससे जुड़ी भौगोलिक जानकारी के लिए एक मौजूदा फ़ॉर्मैट है. जीटीएफ़एस पर आधारित इंटिग्रेशन, GTFS और Google Transit Ticketing एक्सटेंशन का इस्तेमाल करता है. इससे यात्रा और परिवहन के इंटिग्रेशन का पहला चरण पूरा किया जाता है. यानी, स्टैटिक डेटा का फ़ीड उपलब्ध कराया जाता है.

Partner Server API, GTFS से मिले ticketing_trip_id जैसे आइडेंटिफ़ायर का इस्तेमाल करेगा. इसलिए, एपीआई का इस्तेमाल करने से पहले, एक मान्य GTFS फ़ीड मौजूद होना चाहिए. कृपया मान्य GTFS फ़ीड देने के लिए, यहां दिया गया तरीका अपनाएं.

जीटीएफ़एस स्टैटिक फ़ीड बनाना

जीटीएफ़एस पर आधारित इंटिग्रेशन का इस्तेमाल करके, उपयोगकर्ताओं को एक शहर से दूसरे शहर की यात्रा के लिए रास्ते और शेड्यूल खोजने की सुविधा देने के लिए, पार्टनर से GTFS फ़ीड की ज़रूरत होती है. जीटीएफ़एस फ़ीड के डेटा में, शेड्यूल, रास्तों, और टिकट की जानकारी के बारे में स्थायी जानकारी शामिल होगी. इसके बाद, Google इस जानकारी का इस्तेमाल करके पार्टनर एपीआई से कनेक्ट करेगा.

1. सार्वजनिक परिवहन का खाता बनाना

अगर आपने अब तक यह प्रोसेस पूरी नहीं की है, तो कृपया Google Transit का इस्तेमाल शुरू करना पर जाएं और खाता पाने का अनुरोध करने के लिए, फ़ॉर्म का इस्तेमाल करें. समीक्षा पूरी होने के बाद, एक खाता बनाया जाएगा और GTFS डैशबोर्ड उपलब्ध कराया जाएगा. डैशबोर्ड को ऐक्सेस और कॉन्फ़िगर करने के तरीके के बारे में जानने के लिए, ट्रांज़िट पार्टनर के डैशबोर्ड को ऐक्सेस करना लेख पढ़ें.

2. एक्सटेंशन के साथ जीटीएफ़एस फ़ीड बनाना

Google Transit Ticketing एक्सटेंशन के ज़रूरी सेक्शन शामिल करके, अपना GTFS फ़ीड बनाएं. ज़्यादा जानकारी के लिए, GTFS एक्सटेंशन सेक्शन देखें. उपयोगकर्ताओं को बेहतरीन अनुभव देने के लिए, कृपया GTFS की क्वालिटी से जुड़ी ज़रूरी शर्तों और सबसे सही तरीकों को पढ़ें और उनका पालन करें.

ध्यान दें: पूरी प्रोसेस का पहला डेमो देने के लिए, टेस्ट GTFS फ़ीड का इस्तेमाल किया जा सकता है. इसमें उपलब्ध इन्वेंट्री का सिर्फ़ एक सबसेट शामिल होता है. बाकी रास्ते बाद में जोड़े जा सकते हैं. हालांकि, ऐसा फ़ीड लॉन्च करने से पहले करना होगा.

3. अपने फ़ीड को नाम देना

फ़ीड को नाम देने के लिए, यह तरीका अपनाने का सुझाव दिया जाता है: agency-region-country_code, जैसे कि gbus-ca-us या agency-country_code, अगर क्षेत्र की जानकारी देना ज़रूरी नहीं है. उदाहरण के लिए, gbus-br. टेस्ट फ़ीड के लिए, फ़ीड का नाम रखने का सुझाव दिया गया तरीका यह है: test-agency-country_code. जैसे, test-gbus-ca-us या test-gbus-br.

4. फ़ीड अपलोड करना और उसे अपडेट करना

अपना GTFS डेटा अपलोड और अपडेट करने के लिए, अपना GTFS फ़ीड डेटा पब्लिश करना गाइड पढ़ें. डेटा अपलोड होने पर, हर बार उसकी पुष्टि अपने-आप होगी. इसमें 30 मिनट तक लग सकते हैं. इसके बाद, पुष्टि करने वाली रिपोर्ट जनरेट होगी. कृपया अगले चरण पर जाने से पहले, गड़बड़ियां ठीक करें.

5. प्रीव्यू एनवायरमेंट का अनुरोध करना

जीटीएफ़एस डेटा की पुष्टि हो जाने के बाद, निजी झलक विकल्प से फ़ीड डेटा जांचें लेख में दिए गए निर्देशों का पालन करें, ताकि प्रीव्यू एनवायरमेंट चालू किया जा सके. इस सुविधा को चालू करने के बाद, अपलोड किया गया फ़ीड डेटा, अनुमति पाए उपयोगकर्ताओं के Google Maps में दिखेगा. इस चरण में, GTFS डेटा का इस्तेमाल एपीआई सर्वर के साथ टेस्टिंग के लिए भी किया जा सकता है.

सफल: झलक और एंड-टू-एंड डेमो में टेस्टिंग के लिए, यहां दिया गया तरीका अपनाया जा सकता है.

6. लॉन्च से पहले QA की समीक्षा का अनुरोध करना

प्रीव्यू एनवायरमेंट में, समस्या वाली चेतावनियों और डेटा क्वालिटी की समस्याओं को ठीक करने के बाद, सार्वजनिक तौर पर लॉन्च करने से पहले Google की QA टीम से समीक्षा कराना ज़रूरी है. QA की समीक्षा प्रोसेस के दौरान मिली समस्याएं, डैशबोर्ड में दिखेंगी. सभी समस्याओं को ठीक करने के बाद, GTFS को लॉन्च किया जा सकेगा.

7. फ़ीड लॉन्च करना

फ़ीड को सार्वजनिक तौर पर उपलब्ध कराने के तरीके के बारे में जानने के लिए, अपना फ़ीड लॉन्च करना लेख पढ़ें.

ध्यान दें: अगर GTFS फ़ीड, क्वालिटी अश्योरेंस (QA) से जुड़े सभी रिव्यू पास कर लेता है, तो पार्टनर इसे ट्रैवल ट्रांसपोर्ट एपीआई पर काम पूरा होने से पहले भी लॉन्च कर सकते हैं. इसके बाद, ये शेड्यूल Google Maps के सभी उपयोगकर्ताओं के लिए उपलब्ध होंगे.