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