टिकट बेचने की सुविधा का लिंक फ़ॉर्मैट

डीप लिंक के लिए, पार्टनर टिकट बुकिंग से जुड़ा बेस यूआरएल देंगे. इसके बारे में जानने के लिए, पार्टनर कॉन्फ़िगरेशन देखें. हम यूआरएल में जो क्वेरी पैरामीटर जोड़ेंगे वे Google Transit Ticketing Extension के मुताबिक होंगे. हालांकि, पैरामीटर के सेट में बदलाव किया जाएगा:

फ़ील्ड का नाम विवरण
from_ticketing_stop_time_id

(दोहराया जा सकता है) उस स्टॉप का आइडेंटिफ़ायर जहां से लेग शुरू होता है.

किसी खास स्टॉप के लिए, यह स्टेशन से जाने के समय का ticketing_stop_id होता है.
to_ticketing_stop_time_id

(दोहराया जा सकता है) उस स्टॉप का आइडेंटिफ़ायर जहां लेग खत्म होता है.

किसी स्टॉप के लिए, यह डेस्टिनेशन स्टेशन के ticketing_stop_id की वैल्यू होती है.
service_date

(तारीख, दोहराई जा सकती है) यात्रा का सेवा दिवस.

यह फ़ील्ड, JSON ऐरे के तौर पर फ़ॉर्मैट किया जाता है. इसमें तारीख इस फ़ॉर्मैट स्ट्रिंग में होती है:

YYYYMMDD
boarding_time

(ISO 8601, दोहराया जा सकता है) स्टॉप_टाइम के लिए, लेग शुरू होने के समय (departure_time) की तारीख और समय.

इस फ़ील्ड की समय वैल्यू, ISO 8601 के मुताबिक है. इसका फ़ॉर्मैट स्ट्रिंग यह है:

YYYY-MM-DDThh:mm:ss±hh:mm
arrival_time

(ISO 8601, दोहराया जा सकता है) स्टॉप पर पहुंचने का समय (arrival_time). यह उस stop_time के लिए होता है जिस पर लेग खत्म होता है.

इस फ़ील्ड की समय वैल्यू, ISO 8601 के मुताबिक है. इसका फ़ॉर्मैट स्ट्रिंग यह है:

YYYY-MM-DDThh:mm:ss±hh:mm
booking_token

(स्ट्रिंग) यह फ़ील्ड ज़रूरी नहीं है. इसका इस्तेमाल अतिरिक्त डेटा जोड़ने के लिए किया जाता है. यह वैल्यू, Travel Transport API से मिले जवाब से मिलती है. इसे टिकट बुकिंग के डीप लिंक में जोड़ा जाता है.

ज़्यादा से ज़्यादा booking_token की लंबाई 100 वर्ण होनी चाहिए.

बुकिंग टोकन के बिना भी यात्रा की जानकारी देखने की सुविधा काम करती है. हालांकि, इसका इस्तेमाल Google Search के नतीजों और पार्टनर की बुकिंग पेज पर किराये को एक जैसा रखने के लिए किया जा सकता है.
lang

(IETF BCP 47, वैकल्पिक) इस फ़ील्ड का इस्तेमाल, बुकिंग साइट की चुनी गई भाषा के बारे में बताने के लिए किया जाता है.

इस फ़ील्ड की वैल्यू, IETF BCP 47 के मुताबिक होती है. उदाहरण के लिए, en-US.

अगर चुनी गई भाषा उपलब्ध नहीं है या फ़ील्ड पास नहीं किया गया है, तो बुकिंग साइट को फ़ॉलबैक भाषा का इस्तेमाल करना चाहिए.
cur

(आईएसओ 4217, वैकल्पिक) इस फ़ील्ड का इस्तेमाल, उस मुद्रा को दिखाने के लिए किया जाता है जिसमें कीमतें दिखनी चाहिए.

इस फ़ील्ड की वैल्यू, ISO 4217 के मुताबिक होती है. उदाहरण के लिए, USD.

अगर चुनी गई मुद्रा नहीं दिखाई जा सकती या फ़ील्ड पास नहीं किया गया है, तो बुकिंग साइट को फ़ॉलबैक मुद्रा का इस्तेमाल करना चाहिए.
utm_source

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

google_search और google_maps को वैल्यू के तौर पर इस्तेमाल किया जा सकता है.

दोहराए जा सकने वाले सभी पैरामीटर, JSON कलेक्शन के तौर पर तय किए जाते हैं. इसमें एक से ज़्यादा वैल्यू, ट्रांसफ़र स्टॉप के बारे में बताती हैं. Google Transit Ticketing Extension के उदाहरणों में, यूआरएल एन्कोडिंग के उदाहरण देखे जा सकते हैं.

इन पैरामीटर के साथ काम करने की सुविधा उपलब्ध होने पर, पार्टनर को हमें इसकी सूचना देनी चाहिए.