खास जानकारी
अगर आपने Google Maps के लिए GTFS फ़ीड उपलब्ध नहीं कराए हैं, तो आपका इंटिग्रेशन सिर्फ़ बस स्टॉप के लिए है. इस इंटिग्रेशन के लिए, हमें यह समझना होगा कि आप अलग-अलग ट्रेन या बस स्टॉप की पहचान कैसे करते हैं.
फ़ीड की सामान्य खास बातें
इंटिग्रेशन शुरू करते समय, हम हर इंटिग्रेशन के लिए एक यूनीक आइडेंटिफ़ायर बनाते हैं. उदाहरण के लिए: ch_google_test (देश का कोड, पार्टनर का नाम, इंटिग्रेशन) या eu_google (क्षेत्र का कोड, पार्टनर का नाम).
पार्टनर, CSV फ़ॉर्मैट में टेक्स्ट फ़ाइलों वाली एक ZIP फ़ाइल उपलब्ध करा सकते हैं. ये फ़ाइलें, दुनिया भर में या हर इंटिग्रेशन के हिसाब से लागू होती हैं:
पहला उदाहरण:
- ch_google_test_stops.txt
- ch_google_test_markets.txt
दूसरा उदाहरण:
- stops.txt (सभी इंटिग्रेशन पर लागू होता है)
- eu_google_integration1_markets.txt
- eu_google_integration2_markets.txt
स्टॉप फ़ीड की खास बातें (ज़रूरी है)
स्टॉप फ़ाइल में ये कॉलम होने चाहिए:
| फ़ील्ड का नाम | टाइप (GTFS देखें) | ब्यौरा |
|---|---|---|
stop_id |
आईडी (ज़रूरी है) | स्टॉप या स्टेशन की पहचान करने वाला यूनीक आइडेंटिफ़ायर. बड़े स्टेशनों में सिर्फ़ एक एंट्री होनी चाहिए. इसका इस्तेमाल, पार्टनर सर्वर एपीआई को कॉल करते समय और टिकट बेचने के लिए डीप लिंक में किया जाता है. |
stop_name |
टेक्स्ट (ज़रूरी है) | स्टॉप मैपिंग, कैश मेमोरी भरने, और कीमत के सटीक डेटा को डीबग करने के लिए, ऐसा नाम जिसे आसानी से पढ़ा जा सके. |
stop_lat |
अक्षांश (ज़रूरी है) | स्टॉप का अक्षांश. |
stop_lon |
देशांतर (ज़रूरी है) | स्टॉप का देशांतर. |
हम डेटा को अपने-आप डालने की प्रोसेस का इस्तेमाल करेंगे. इसमें पार्टनर, डेटा में बदलाव होने पर, अपडेट की गई ZIP फ़ाइलें लगातार उपलब्ध करा सकते हैं. उदाहरण के लिए, कोई पार्टनर बस स्टॉप की सूची को बढ़ाकर, उपलब्ध इन्वेंट्री को बड़ा कर सकता है. हालांकि, GTFS की तरह ही stop_ids भी स्थिर होने चाहिए.
मार्केट सेट फ़ीड की खास बातें (ज़रूरी नहीं)
मैप किए गए स्टॉप की मदद से, हम इस इंटिग्रेशन के लिए मार्केट सेट जनरेट करते हैं. यह एक सूची होती है, जिसमें लोकप्रिय ऑरिजिन / डेस्टिनेशन पेयर शामिल होते हैं. यहां से, आपके पास मार्केट सेट फ़ीड सबमिट करके, मार्केट के इस सेट को कम करने का विकल्प होता है.
मार्केट सेट, अनुमति वाली सूची के तौर पर काम करता है: अगर कोई मार्केट सेट नहीं दिया जाता है, तो इंटिग्रेशन में सभी मार्केट चालू होते हैं. अगर कोई मार्केट सेट दिया जाता है, तो सूची में शामिल न होने वाले किसी भी मार्केट को बंद कर दिया जाता है.
मार्केट सेट फ़ाइल में ये कॉलम होने चाहिए:
| फ़ील्ड का नाम | टाइप (GTFS देखें) | ब्यौरा |
|---|---|---|
origin_stop_id |
आईडी (ज़रूरी है) | मार्केट का ऑरिजिन stop_id. |
destination_stop_id |
आईडी (ज़रूरी है) | मार्केट का डेस्टिनेशन stop_id. |
पार्टनर कॉन्फ़िगरेशन
सिर्फ़ रोकने वाले इंटिग्रेशन का इस्तेमाल करते समय, हमें स्टैटिक पार्टनर कॉन्फ़िगरेशन के लिए ज़्यादा जानकारी चाहिए. इस बारे में पार्टनर कॉन्फ़िगरेशन सेक्शन में बताया गया है.
टिकट बेचने के लिए डीप लिंक
डीप लिंक का फ़ॉर्मैट और पैरामीटर, टिकट बेचने के लिंक में तय किए जाते हैं
Partner API के पैरामीटर
पार्टनर एपीआई (GetBulkTripOptionsRequest) के लिए SegmentKeys पैरामीटर, डीप लिंक स्पेसिफ़िकेशन पर आधारित होते हैं. हम SegmentKeys का इस्तेमाल करते हैं. इसमें सिर्फ़ from_ticketing_stop_time_id, to_ticketing_stop_time_id, service_date, boarding_time, और arrival_time शामिल होते हैं. ticketing_trip_id को खाली छोड़ दिया जाता है. हम हर सेगमेंट के लिए एक सेगमेंट कीवर्ड तय करके, सभी ट्रांसफ़र के साथ-साथ रूट की पूरी जानकारी देंगे.