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

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

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

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

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

1. Transit खाता बनाना

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

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

GTFS फ़ीड बनाएं. इसमें Google Transit टिकट एक्सटेंशन के ज़रूरी सेक्शन शामिल हैं. ज़्यादा जानकारी के लिए 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. प्रीव्यू एनवायरमेंट का अनुरोध करें

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

सफल: झलक और शुरू से अंत तक के डेमो में टेस्टिंग के लिए, नीचे दिए गए चरणों को छोड़ा जा सकता है.

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

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

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

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

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