शुरू करना

इस गाइड में, Google के साथ इंटिग्रेट करने का तरीका बताया गया है. इससे उपयोगकर्ताओं को Google Maps और Google Search जैसे Google के अलग-अलग प्लैटफ़ॉर्म पर, परिवहन के साधनों को खोजने का बेहतर अनुभव मिलता है. बड़े लेवल पर, इंटिग्रेशन की मुख्य खास बातों में ये शामिल हैं:

  • स्टैटिक डेटा उपलब्ध कराने के दो विकल्प:
    • जीटीएफ़एस पर आधारित इंटिग्रेशन: टिकट बुकिंग की सुविधा देने वाले एक्सटेंशन के साथ GTFS फ़ीड उपलब्ध कराना. ऐसा उन मामलों में किया जाता है जहां शेड्यूल डेटा उपलब्ध कराने की ज़िम्मेदारी आपकी होती है. जीटीएफ़एस पर आधारित इंटिग्रेशन के लिए, हमारी कुछ अन्य ज़रूरतें हैं.
    • सिर्फ़ स्टॉप की जानकारी देने वाला इंटिग्रेशन: इसमें सिर्फ़ स्टॉप की सूची दी जाती है. ऐसा उन मामलों में किया जाता है जहां Google के पास पहले से ही किसी अन्य सोर्स से शेड्यूल का डेटा मौजूद होता है.
  • डाइनैमिक डेटा उपलब्ध कराने के लिए, Partner API की खास जानकारी:

Travel Transport के साथ इंटिग्रेट करने का तरीका

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

  1. शामिल होने की ज़रूरी शर्तों की समीक्षा की जा रही है.
  2. Google को स्टैटिक डेटा का फ़ीड उपलब्ध कराना.
  3. Travel Transport API के साथ काम करता है, ताकि तेज़ी से बदलने वाले डेटा की डाइनैमिक क्वेरी की जा सके. जैसे, किराये और उपलब्धता. एपीआई, पहले चरण में स्टैटिक डेटा फ़ीड से मिले आइडेंटिफ़ायर का इस्तेमाल करता है. उदाहरण के लिए, स्टॉप की पहचान करने के लिए ticketing_stop_id.

1. प्रोग्राम में शामिल होने की ज़रूरी शर्तें

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

2. स्टैटिक डेटा का फ़ीड उपलब्ध कराना

स्टैटिक डेटा देने के दो विकल्प हैं. हर विकल्प का इस्तेमाल कुछ खास परिस्थितियों में किया जाता है. यह तय करने के लिए कि कौनसा विकल्प इस्तेमाल करना है, यह देखना ज़रूरी है कि क्या आपने उन ट्रांज़िट कनेक्शन के लिए शेड्यूल डेटा उपलब्ध कराया है जिनके लिए आपको बुकिंग की सुविधा देनी है. यह देखने का सबसे आसान तरीका है कि Google के पास पहले से ही शेड्यूल का डेटा है या नहीं. इसके लिए, Google Maps पर किसी ऑपरेटर के कनेक्शन ढूंढने की कोशिश करें.

सुविधा GTFS पर आधारित इंटिग्रेशन सिर्फ़ रोकने की सुविधा वाला इंटिग्रेशन
इस्तेमाल का उदाहरण आपने GTFS में शेड्यूल और टिकट की जानकारी पहले ही दी हो. Google के पास, ऑपरेटर के शेड्यूल का डेटा पहले से ही किसी दूसरे सोर्स से मौजूद है.
ज़रूरी डेटा जीटीएफ़एस आईडी. आपके स्टॉप आईडी की सूची, जिसमें उनके भौगोलिक निर्देशांक शामिल हों.
कोशिश कम मीडियम

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

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

3. Travel Transport API का इस्तेमाल करना

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

3.1. Partner Server API को लागू करना

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

  1. कीमतों को तुरंत दिखाने के लिए, कैश मेमोरी जनरेट करता है.
  2. जब कोई उपयोगकर्ता किसी यात्रा की योजना पर क्लिक करता है, तो उसे मौजूदा किराया दिखाएं.

अगर पार्टनर को Google पर कीमतें दिखानी हैं, तो Partner Server API लागू करना ज़रूरी है.

3.2. API की पुष्टि और टेस्टिंग

एपीआई लागू करने की प्रोसेस पूरी होने के बाद, कृपया transport-help@google.com पर सर्वर की जानकारी के साथ संपर्क करें, ताकि हम आपके एपीआई लागू करने की प्रोसेस की पुष्टि कर सकें.

हम आने वाले समय में, एपीआई लागू करने की पुष्टि करने के लिए ऑटोमेटेड टूल उपलब्ध कराने का प्लान बना रहे हैं. हालांकि, यह सुविधा अभी उपलब्ध नहीं है.