Google Transit GTFS शेड्यूल का रेफ़रंस और अंतर

इस पेज पर, आधिकारिक GTFS शेड्यूल और Google Transit के स्पेसिफ़िकेशन के लागू होने के बीच के मुख्य अंतर के बारे में बताया गया है. ये अंतर इन क्षेत्रों में हैं:

  • अनदेखी की गई आधिकारिक जानकारी: ये फ़ील्ड, आधिकारिक जीटीएफ़एस का हिस्सा हैं. Google Transit, इस डेटा को बिना किसी गड़बड़ी के इंपोर्ट करता है. हालांकि, वह इस डेटा का इस्तेमाल नहीं करता.

  • अलग तरीके से व्याख्या करना: इन फ़ील्ड में, आधिकारिक जीटीएफ़एस के ऐसे हिस्से शामिल होते हैं जिनका Google Transit, जीटीएफ़एस के उन हिस्सों की परिभाषा से अलग तरीके से विश्लेषण करता है.

  • एक्सपेरिमेंट के तौर पर सहायता: Google Transit के लागू होने के दौरान, ये फ़ील्ड एक्सपेरिमेंट के तौर पर उपलब्ध हैं. अगर आपको एक्सपेरिमेंट के तौर पर कोई नया फ़ील्ड लागू करना है, तो Google की बस, मेट्रो वगैरह की सेवाओं की टीम से संपर्क करें.

  • Google Transit के साथ काम करने वाला एक्सटेंशन: यह एक्सटेंशन, आधिकारिक जीटीएफ़एस का हिस्सा नहीं है. सार्वजनिक परिवहन के लिए उपलब्ध एक्सटेंशन में, सार्वजनिक एक्सटेंशन और Google Transit के लिए उपलब्ध एक्सटेंशन, दोनों शामिल होते हैं. कोई भी पार्टनर, अपने फ़ीड में यह जानकारी ट्रांज़िट को भेज सकता है.

स्टैटिक सार्वजनिक परिवहन की जानकारी देने वाला फ़ॉर्मैट

यहां दिए गए सेक्शन में, आधिकारिक GTFS और Google Transit के स्टैटिक फ़ीड के बीच के मुख्य अंतर के बारे में बताया गया है.

स्टैटिक फ़ीड में आधिकारिक स्पेसिफ़िकेशन को अनदेखा किया गया

Transit कुछ आधिकारिक खास बातों को अनदेखा करता है. ये खास बातें, एक्सपेरिमेंट के तौर पर उपलब्ध हैं. ज़्यादा जानकारी के लिए, gtfs.org पर जाएं.

टेबल 1 में उन जीटीएफ़एस फ़ाइलों की सूची दी गई है जो स्टैटिक फ़ीड में, Transit के साथ काम नहीं करती हैं. साथ ही, इन फ़ाइलों में बताए गए किसी भी फ़ील्ड का इस्तेमाल, Transit में नहीं किया जा सकता.

टेबल 1. स्टैटिक फ़ीड में इस्तेमाल नहीं की जा सकने वाली जीटीएफ़एस फ़ाइलें
areas.txt
fare_leg_rules.txt
fare_products.txt
fare_transfer_rules.txt
levels.txt
stop_areas.txt

टेबल 2 में, जीटीएफ़एस के तय किए गए ऐसे सभी फ़ील्ड की सूची दी गई है जिन्हें स्टैटिक फ़ीड में Transit अनदेखा करता है.

टेबल 2. स्टैटिक फ़ीड में अनदेखा किए गए GTFS फ़ील्ड
फ़ाइल का नाम GTFS में बताया गया, अनदेखा किया गया फ़ील्ड फ़ील्ड टाइप
fare_attributes.txt payment_method Enum
feed_info.txt default_lang भाषा कोड
feed_info.txt feed_publisher_name टेक्स्ट
pathways.txt max_slope फ़्लोट
routes.txt continuous_drop_off Enum
routes.txt continuous_pickup Enum
routes.txt network_id आईडी
routes.txt route_desc टेक्स्ट
routes.txt route_sort_order सकारात्मक पूर्णांक
stops.txt level_id आईडी
stops.txt stop_desc टेक्स्ट
stops.txt stop_url URL
stops.txt tts_stop_name टेक्स्ट
trips.txt bikes_allowed Enum

स्टैटिक फ़ीड में अलग-अलग तरह से जानकारी

Transit, जीटीएफ़एस के कुछ फ़ील्ड को स्वीकार करता है. हालांकि, Transit इनका इस्तेमाल जीटीएफ़एस के मुकाबले अलग तरीके से करता है.

टेबल 3 में, स्टैटिक फ़ीड में मौजूद ऐसे फ़ील्ड दिखाए गए हैं जिन्हें Transit, जीटीएफ़एस में बताए गए तरीके से अलग तरीके से लागू करता है.

टेबल 3. अलग-अलग तरीके से लागू किए गए स्टैटिक फ़ीड फ़ील्ड
फ़ाइल का नाम GTFS में बताया गया फ़ील्ड फ़ील्ड टाइप क्या Google Transit के लिए यह ज़रूरी है? Google Transit को लागू करने की जानकारी
fare_attributes.txt transfers Enum ज़रूरी है

Google Transit एक्सटेंशन.

सार्वजनिक GTFS, वैल्यू की सीमा को 0 से लेकर 2 तक सीमित करता है. Google Transit 0 से 5 तक की वैल्यू स्वीकार करता है.

किराये के लिए ज़्यादा से ज़्यादा कितने ट्रांसफ़र की अनुमति है, यह तय करने के लिए इस फ़ील्ड का इस्तेमाल करें. इसमें ब्लॉक ट्रांसफ़र शामिल नहीं हैं. इन्हें सीट में बैठे हुए ट्रांसफ़र भी कहा जाता है. अगर आपको किसी किराये के लिए, ट्रांसफ़र की संख्या की सीमाएं सेट नहीं करनी हैं, तो transfers फ़ील्ड को खाली छोड़ दें.

pathways.txt pathway_mode Enum वैकल्पिक अगर pathway_mode फ़ील्ड को छोड़ दिया जाता है, तो Google Transit इसे स्वीकार कर लेता है और इसे 'जानकारी नहीं है' के तौर पर इस्तेमाल करता है.
stop_times.txt arrival_time समय कुछ शर्तों के मुताबिक ज़रूरी है घंटों की वैल्यू 00 से 99 के बीच होनी चाहिए. यह तीन दिन की यात्राओं के लिए काफ़ी है.
transfers.txt transfer_type Enum ज़रूरी है

4 और 5 की वैल्यू इस्तेमाल नहीं की जा सकतीं और उन्हें अनदेखा कर दिया जाता है.

Google Transit, 0, 1, 2, और 3 वैल्यू के साथ काम करता है.

trips.txt block_id आईडी वैकल्पिक ज़्यादा जानने के लिए, ट्रांसफ़र को ब्लॉक करने का उदाहरण देखें.

स्टैटिक फ़ीड में एक्सपेरिमेंट के तौर पर उपलब्ध सहायता

अगर आपको इस कैटगरी में एक्सपेरिमेंट के तौर पर उपलब्ध नए फ़ील्ड इंटिग्रेट करने में मदद चाहिए, तो Google Transit से संपर्क करें.

स्टैटिक फ़ीड में, Google Transit के साथ काम करने वाले एक्सटेंशन

टेबल 4 में, Google Transit एक्सटेंशन के बारे में जानकारी दी गई है. ये फ़ील्ड, आधिकारिक GTFS का हिस्सा नहीं हैं.

टेबल 4. स्टैटिक फ़ीड के साथ काम करने वाले एक्सटेंशन
फ़ाइल का नाम फ़ील्ड फ़ील्ड टाइप क्या Google Transit के लिए यह ज़रूरी है? Google Transit को लागू करने की जानकारी
fare_attributes.txt ic_price फ़्लोट वैकल्पिक

Google Transit का यह एक्सटेंशन, सिर्फ़ जापान में मौजूद पार्टनर के लिए उपलब्ध है.

ic_price फ़ील्ड, स्मार्ट कार्ड से इस किराये के लिए चुकाई जाने वाली रकम में दी गई छूट दिखाता है. अगर इस किराये के लिए कोई छूट नहीं दी जाती है या स्मार्ट कार्ड काम नहीं करता है, तो ic_price फ़ील्ड की वैल्यू -1 होनी चाहिए.

fare_rules.txt contains_route_id आईडी वैकल्पिक

Google Transit एक्सटेंशन.

यह किराया सिर्फ़ उन यात्राओं पर लागू होता है जो fare_id, origin_id, और destination_id कॉलम के इस कॉम्बिनेशन के लिए, सभी पंक्तियों में route_id वैल्यू से पहचाने गए, रास्तों के सटीक सेट पर जाती हैं.

अगर contains_route_id कॉलम मौजूद नहीं है या इस किराये के लिए उसकी सभी वैल्यू शून्य हैं, तो इसका मतलब है कि इस पैरामीटर में किराये पर पाबंदी नहीं है. अगर contains_route_id फ़ील्ड में किराया दिया गया है, तो route_id फ़ील्ड खाली होना चाहिए.

routes.txt checkin_duration पूर्णांक वैकल्पिक

Google Transit एक्सटेंशन.

checkin_duration फ़ील्ड से पता चलता है कि चेक इन करने और फ़्लाइट में चढ़ने के लिए, यात्री को शेड्यूल की गई फ़्लाइट के विमान उड़ान भरने से कितने सेकंड पहले पहुंचने की सलाह दी जाती है.

अगर यात्री, ट्रांसफ़र की मदद से, सफ़र की शुरुआती जगह से जुड़ता है, तो ट्रांसफ़र के लिए तय किया गया कोई भी समय, checkin_duration वैल्यू को बदल देता है.

checkin_duration वैल्यू सिर्फ़ एक सुझाव है, जिसे आम तौर पर बस, मेट्रो वगैरह चलाने वाली कंपनी से मिलता है. ऐसा हो सकता है कि यह समय, उस आखिरी समय से अलग हो जब तक यात्री आकर, वाहन में सवार हो सकता है.

routes.txt route_type Enum ज़रूरी है

Google Transit एक्सटेंशन.

Google Transit, GTFS के ज़रिए स्वीकार की गई route_type वैल्यू के विकल्पों को कैसे बढ़ाता है, यह जानने के लिए जीटीएफ़एस के ज़रिए स्वीकार किए गए रास्ते के टाइप देखें.

stop_times.txt stop_direction_name टेक्स्ट वैकल्पिक

Google Transit एक्सटेंशन.

stop_direction_name फ़ील्ड से यात्रियों को यात्रा की दिशा के बारे में पता चलता है. दिशा को इस स्टॉप से जाने के समय की direction_name वैल्यू के तौर पर सेव किया जाता है.

अगर stop_direction_name फ़ील्ड खाली है, तो इसके बजाय, बस, मेट्रो वगैरह के लिए इस्तेमाल होने वाले trip_direction_name फ़ील्ड का इस्तेमाल किया जाता है. अगर trip_direction_name और stop_direction_name फ़ील्ड, दोनों खाली हैं, तो ट्रांज़िट इंपोर्टर उन्हें खाली छोड़ देता है. ऐसे में, पार्टनर stop_headsign या trip_headsign वैल्यू का इस्तेमाल कर सकते हैं. stop_direction_name फ़ील्ड की वैल्यू को केस के हिसाब से सामान्य किया जाता है.

stops.txt signposted_as टेक्स्ट वैकल्पिक

Google Transit एक्सटेंशन.

signposted_as फ़ील्ड में, प्लैटफ़ॉर्म के साइनबोर्ड पर लिखा गया टेक्स्ट होता है. उदाहरण के लिए, "सेंट्रल की ओर" और "ईस्ट साइड और ब्रुकलिन."

GTFS platform_code फ़ील्ड और बस, मेट्रो वगैरह के लिए इस्तेमाल होने वाला signposted_as फ़ील्ड, एक साथ सेट किया जा सकता है.

platform_code और signposted_as फ़ील्ड के बीच के अंतर में ये शामिल हैं:

  • लंबाई. आम तौर पर, platform_code फ़ील्ड में 2 या C जैसा कोई अंक या अक्षर होता है.
  • भाषा. platform_code फ़ील्ड में कोई भाषा नहीं होती, लेकिन signposted_as वैल्यू का अनुवाद किया जा सकता है.
  • स्थिरता. platform_code फ़ील्ड, signposted_as फ़ील्ड की तुलना में बहुत कम बदलता है.
stops.txt vehicle_type पूर्णांक वैकल्पिक

Google Transit एक्सटेंशन.

vehicle_type फ़ील्ड से पता चलता है कि किसी स्टॉप पर किस तरह के वाहन इस्तेमाल किए जाते हैं. इस फ़ील्ड में, हैरारकीकल वेहिकल टाइप (HVT) के हिसाब से, रास्ते के टाइप डाले जा सकते हैं. HVT वैल्यू, यूरोपियन ट्रांसपोर्ट प्रोटोकॉल एक्सपर्ट ग्रुप (TPEG) स्टैंडर्ड से ली जाती हैं.

agency.txt ticketing_deep_link_id आईडी वैकल्पिक

Google Transit का टिकट एक्सटेंशन.

agency.txt फ़ाइल में, ticketing_deep_link_id फ़ील्ड उस डीप लिंक को दिखाता है जिसका इस्तेमाल इस एजेंसी की यात्राओं के टिकट के लिए किया जाता है.

routes.txt ticketing_deep_link_id आईडी वैकल्पिक

Google Transit का टिकट एक्सटेंशन.

routes.txt फ़ाइल में, ticketing_deep_link_id फ़ील्ड उस डीप लिंक को दिखाता है जिसका इस्तेमाल इस रूट की यात्राओं के टिकट बुक करने के लिए किया जाता है.

stop_times.txt ticketing_stop_time_id आईडी वैकल्पिक

Google Transit का टिकट एक्सटेंशन.

अगर stop_times.txt फ़ाइल में ticketing_stop_time_id फ़ील्ड मौजूद है, तो यह उस आइडेंटिफ़ायर को बदल देता है जो डीप लिंक की मदद से टिकट बुक करने के लिए, स्टॉप का समय दिखाता है.

stop_times.txt ticketing_type Enum वैकल्पिक

Google Transit का टिकट एक्सटेंशन.

ticketing_type फ़ील्ड से पता चलता है कि स्टॉप के इस समय पर किस तरह की टिकट की बिक्री की जाती है.

Google Transit, इन वैल्यू को स्वीकार करता है:

  • Empty. डिफ़ॉल्ट—जैसा कि यात्रा के लिए तय किया गया है.
  • 0. यह विकल्प सिर्फ़ तब उपलब्ध होता है, जब एजेंसी या रूट के लिए, टिकट बेचने वाला डीप लिंक चालू हो.
  • 1. उपलब्ध नहीं है.
ticketing_deep_links.txt android_intent_uri यूआरआई वैकल्पिक

Google Transit का टिकट एक्सटेंशन.

android_intent_uri फ़ील्ड, इंटेंट यूआरआई को दिखाता है जिसका इस्तेमाल Android पर डीप लिंकिंग के लिए किया जाता है.

ticketing_deep_links.txt ios_universal_link_url URL वैकल्पिक

Google Transit का टिकट एक्सटेंशन.

ios_universal_link_url फ़ील्ड, यूनिवर्सल लिंक यूआरएल को दिखाता है. इसका इस्तेमाल, iOS पर डीप लिंकिंग के लिए किया जाता है.

ticketing_deep_links.txt ticketing_deep_link_id आईडी ज़रूरी है

Google Transit का टिकट एक्सटेंशन.

ticketing_deep_link_id फ़ील्ड, डीप लिंक के आइडेंटिफ़ायर को दिखाता है.

ticketing_deep_links.txt web_url URL वैकल्पिक

Google Transit का टिकट एक्सटेंशन.

web_url फ़ील्ड, वेब पर डीप लिंक करने के लिए इस्तेमाल किए जाने वाले यूआरएल को दिखाता है.

ticketing_identifiers.txt agency_id आईडी ज़रूरी है

Google Transit का टिकट एक्सटेंशन.

जिस स्टॉप के लिए डिफ़ॉल्ट ticketing_stop_id फ़ील्ड तय किया गया है उसकी एजेंसी की जानकारी देने के लिए, agency_id फ़ील्ड में GTFS agency.txt फ़ाइल का आईडी होता है.

ticketing_identifiers.txt stop_id आईडी ज़रूरी है

Google Transit का टिकट एक्सटेंशन.

उस स्टॉप की जानकारी देने के लिए जिसके लिए डिफ़ॉल्ट ticketing_stop_id फ़ील्ड तय किया गया है, stop_id फ़ील्ड में GTFS stops.txt फ़ाइल का आईडी होता है.

ticketing_identifiers.txt ticketing_stop_id आईडी ज़रूरी है

Google Transit का टिकट एक्सटेंशन.

ticketing_stop_id फ़ील्ड में, स्टॉप पर लागू किया गया टिकट आईडी होता है. इसके अलावा, कोई एजेंसी भी आईडी की पुष्टि कर सकती है.

trips.txt exceptional Enum वैकल्पिक

इस फ़ील्ड से, खास यात्राओं के बारे में पता चलता है. ये बसें, तय समय से पहले या बाद में चलाई जाती हैं. इसके अलावा, खास मौकों या पहले से तय रुकावटों (जैसे कि रेलवे का ट्रैक बनाने का काम) की वजह से, सामान्य रास्ते के बजाय किसी और रास्ते से चलाई जाती हैं.

Google, वैल्यू के लिए ये विकल्प स्वीकार करता है:

  • 0. सामान्य सेवाएं
  • 1. सेवा में अपवाद. उदाहरण के लिए, खास मौकों की वजह से जोड़ी गई सेवाएं या पहले से तय की गई रुकावटों की वजह से, सामान्य रास्ते के बजाय किसी और रास्ते से तय की जाने वाली सेवाएं.
trips.txt ticketing_trip_id आईडी वैकल्पिक

Google Transit का टिकट एक्सटेंशन.

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

trips.txt ticketing_type Enum वैकल्पिक

Google Transit का टिकट एक्सटेंशन.

ticketing_type फ़ील्ड से पता चलता है कि इस यात्रा के लिए किस तरह का टिकट जारी किया गया है.

Google Transit, इन वैल्यू को स्वीकार करता है:

  • 0. डिफ़ॉल्ट. यह सुविधा सिर्फ़ तब उपलब्ध होती है, जब एजेंसी या रूट के लिए, टिकट बेचने वाला डीप लिंक चालू हो.
  • 1. उपलब्ध नहीं है.
translations.txt lang भाषा कोड वैकल्पिक

Google Transit एक्सटेंशन.

lang फ़ील्ड, आधिकारिक GTFS का हिस्सा नहीं है. हालांकि, Google Transit इस वैल्यू का इस्तेमाल तब करता है, जब यह मौजूद हो.

किसी वाक्यांश का अनुवाद बताने के लिए, lang फ़ील्ड का इस्तेमाल करें. इसकी वैल्यू खाली या und (एक ऐसी भाषा जिसकी जानकारी नहीं दी गई है) नहीं होनी चाहिए.

translations.txt trans_id आईडी वैकल्पिक

Google Transit एक्सटेंशन.

trans_id फ़ील्ड, आधिकारिक GTFS का हिस्सा नहीं है. हालांकि, Google Transit इस वैल्यू का इस्तेमाल तब करता है, जब यह मौजूद हो.

जिस वाक्यांश का अनुवाद पाना है उसका आईडी टोकन बताने के लिए, trans_id फ़ील्ड का इस्तेमाल करें. translations.txt टेबल की हर पंक्ति का मतलब है कि lang भाषा में, trans_id वाक्यांश का अनुवाद translation में होता है.

trips.txt original_trip_id आईडी वैकल्पिक

Google Transit एक्सटेंशन.

अगर यह trips.txt फ़ाइल में मौजूद है, तो original_trip_id वैल्यू, trip_id वैल्यू को बदल देती है, ताकि दूसरे सिस्टम इसका इस्तेमाल कर सकें. इसका एक उदाहरण, रीयल टाइम मैचिंग है.

trips.txt trip_direction_name टेक्स्ट वैकल्पिक

Google Transit एक्सटेंशन.

trip_direction_name फ़ील्ड से यात्रियों को यात्रा की दिशा के बारे में पता चलता है. इस फ़ील्ड में मौजूद वैल्यू को हर ट्रिप की direction_name वैल्यू के तौर पर सेव किया जाता है.

अगर यात्रा के दौरान stop_times टेबल में stop_direction_name वैल्यू बदलती है, तो हो सकता है कि वह trip_direction_name वैल्यू को बदल दे.

trip_direction_name फ़ील्ड में मौजूद वैल्यू को केस के हिसाब से सामान्य किया जाता है.

trips.txt vehicle_category_id आईडी वैकल्पिक

Google Transit एक्सटेंशन.

trips.txt फ़ाइल में, vehicle_category_id फ़ील्ड उस वाहन की पहचान करता है जिसे इस यात्रा के लिए दिया गया है. जब यह फ़ील्ड trips.txt फ़ाइल में होता है, तो इसकी वैल्यू routes.txt फ़ाइल में मौजूद vehicle_category_id वैल्यू को बदल देती है.