शब्दावली

इस शब्दावली में, ट्रांसपोर्ट पार्टनर इंटिग्रेशन के दस्तावेज़ में इस्तेमाल किए गए मुख्य शब्दों की परिभाषाएं दी गई हैं.

बुकिंग टोकन: यह पार्टनर की जनरेट की गई एक स्ट्रिंग होती है. इसे टिकट बुकिंग के डीप लिंक में पास किया जा सकता है. इससे Google के खोज नतीजों और पार्टनर के बुकिंग पेज पर, किराये और यात्रा की योजना में एकरूपता बनाए रखने में मदद मिलती है.

कैननिकल JSON मैपिंग: यह नियमों का एक खास सेट है. इसे Protocol Buffers ने, किसी प्रोटो मैसेज को JSON ऑब्जेक्ट में बदलने के लिए तय किया है. इस इंटिग्रेशन के लिए, इस मैपिंग का इस्तेमाल करना ज़रूरी है. साथ ही, कुछ खास विकल्पों का इस्तेमाल करना भी ज़रूरी है, ताकि अनुरोध और जवाब सही फ़ॉर्मैट में हों.

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

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

known_itineraries: यह पार्टनर कॉन्फ़िगरेशन में मौजूद एक विकल्प है. इसकी मदद से पार्टनर, Google से जानी-पहचानी यात्राओं की सूची पा सकते हैं, ताकि वे अपने जवाब को ऑप्टिमाइज़ कर सकें.

मार्केट सेट: (सिर्फ़ स्टॉप-ओनली इंटिग्रेशन के लिए) यह एक वैकल्पिक फ़ीड है. इसे पार्टनर उपलब्ध कराता है. इससे, मूल जगह और मंज़िल के जोड़े (मार्केट) की एक खास सूची तय की जाती है. पार्टनर इन मार्केट के लिए किराया तय करेगा. अगर यह विकल्प दिया जाता है, तो यह अनुमति वाले डोमेन की सूची के तौर पर काम करता है.

Partner API / Partner Server API: यह एपीआई का ऐसा सेट है जिसे पार्टनर को लागू करना होगा, ताकि Google को डाइनैमिक डेटा दिया जा सके. जैसे, रीयल-टाइम में कीमत और उपलब्धता की जानकारी.

किराये की क्वालिटी की जांच: यह एक ऐसी प्रोसेस है जो लगातार चलती रहती है. इसमें Google के क्रॉलर, पार्टनर की वेबसाइट पर मौजूद यात्रा की योजनाओं के सैंपल लेते हैं. इससे यह पुष्टि की जाती है कि लोगों को दिखाए गए किराये, Partner API के ज़रिए उपलब्ध कराए गए किराये से मेल खाते हैं.

क्यूपीएस (क्वेरी प्रति सेकंड): यह वह औसत दर है जिस पर Google, पार्टनर के एपीआई सर्वर को अनुरोध भेजता है. एक क्वेरी का मतलब एक अनुरोध होता है. इस दर में उतार-चढ़ाव हो सकता है. कभी ट्रैफ़िक थोड़ा ज़्यादा होता है, तो कभी थोड़ा कम.

SegmentKey: यह एक ऑब्जेक्ट है. इसका इस्तेमाल Partner API में किया जाता है. इससे यात्रा के किसी एक लेग की खास तौर पर पहचान की जाती है. इसमें यात्रा की शुरुआत, मंज़िल, और सेवा की तारीखें/समय शामिल होते हैं.

service_date: वह तारीख जब ट्रांज़िट सेवा उपलब्ध होती है. इसे YYYYMMDD के तौर पर फ़ॉर्मैट किया जाता है. इसका इस्तेमाल अन्य आइडेंटिफ़ायर के साथ मिलाकर किया जाता है, ताकि यात्रा के किसी यूनीक इंस्टेंस के बारे में बताया जा सके.

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

ticketing_stop_id: यह किसी स्टॉप या स्टेशन के लिए पार्टनर का यूनीक आइडेंटिफ़ायर होता है. यह आईडी, स्टैटिक डेटा फ़ीड (GTFS या सिर्फ़ स्टॉप) में दिया जाता है. इसका इस्तेमाल Partner API और टिकट बुकिंग के डीप लिंक में किया जाता है.

ticketing_trip_id: (जीटीएफ़एस पर आधारित इंटिग्रेशन के लिए) पार्टनर का यूनीक आइडेंटिफ़ायर, जो किसी खास यात्रा के लिए होता है. यह उनके GTFS फ़ीड की trips.txt फ़ाइल में दिया जाता है. सिर्फ़ GTFS पर आधारित इंटिग्रेशन.

टिकट बुक करने के लिए डीप लिंक: यह एक ऐसा यूआरएल होता है जो उपयोगकर्ता को Google पर खोज के नतीजों से, पार्टनर की वेबसाइट पर ले जाता है. इससे उपयोगकर्ता किसी खास यात्रा कार्यक्रम के लिए टिकट बुक कर पाता है. इस यूआरएल में, चुनी गई यात्रा की कोड में बदली गई जानकारी शामिल होती है.

TripOptionsErrorType: यह गड़बड़ियों के टाइप का एक खास सेट है. इसे Partner API में दिखाया जा सकता है, ताकि यह बताया जा सके कि अनुरोध क्यों पूरा नहीं किया जा सका.

UNSPECIFIED Enum वैल्यू: Protocol Buffers का इस्तेमाल करते समय, किसी भी enum डेफ़िनिशन में यह पहली वैल्यू (जिसकी संख्यात्मक वैल्यू 0 होती है) ज़रूरी होती है. यह डिफ़ॉल्ट वैल्यू के तौर पर काम करता है. अगर अनुरोध में यह वैल्यू मिलती है, तो आम तौर पर इसे गड़बड़ी माना जाना चाहिए.