शुरू करना

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

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 API से जुड़ी गाइड में दी गई है. इस एपीआई की मदद से, Google को पार्टनर से किराये और उपलब्धता की सबसे नई जानकारी मिलती है. Google इस एपीआई को इन कामों के लिए कॉल करेगा:

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

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

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

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

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