ट्रांज़िट रूट में, उस इलाके में उपलब्ध सार्वजनिक परिवहन के विकल्पों का इस्तेमाल करके नेविगेशन के निर्देश दिए जाते हैं. ट्रांज़िट के विकल्पों में बस, मेट्रो, ट्रेन वगैरह शामिल हो सकती हैं. सार्वजनिक परिवहन के रूट में, आम तौर पर सार्वजनिक परिवहन के स्टेशनों तक पैदल जाने, वहां से आने, और उनके बीच पैदल चलने के निर्देश भी शामिल होते हैं. ऐसा इसलिए है, क्योंकि सार्वजनिक परिवहन से यात्रा के लिए आम तौर पर, एक से ज़्यादा तरह के परिवहन का इस्तेमाल करना पड़ता है. इसलिए, रास्ते के बारे में अनुरोध करने का तरीका और जवाब के कुछ हिस्से अलग-अलग होते हैं.
सार्वजनिक परिवहन के रास्ते, अन्य रास्तों से कैसे अलग होते हैं
ट्रांज़िट के रास्ते, जिनके लिए आपने travelMode TRANSIT सेट करके अनुरोध किया है, यात्रा के अलग-अलग मोड के विकल्पों का इस्तेमाल करने वाले रास्तों से अलग होते हैं.
एक जैसे सभी ऑब्जेक्ट और विकल्पों का अनुरोध नहीं किया जा सकता. साथ ही, अन्य रास्तों की तुलना में जवाब में अलग-अलग फ़ील्ड दिखते हैं.
Routes API में, हर चरण में नेविगेशन से जुड़ा एक निर्देश होता है. यह निर्देश, यात्रा के सभी तरीकों के लिए एक जैसा होता है. इसलिए, नेविगेशन के हर निर्देश को एक चरण माना जाता है. बस, मेट्रो वगैरह के रूट की जानकारी देने वाला रिस्पॉन्स, यात्रा के अन्य तरीकों के रूट की जानकारी देने वाले रिस्पॉन्स से काफ़ी मिलता-जुलता है. हालांकि, इन दोनों के बीच कुछ मुख्य अंतर हैं:
| अंतरों का अनुरोध करना | जवाबों में अंतर |
|---|---|
| रास्ते में पड़ने वाले इंटरमीडिएट वेपॉइंट तय नहीं किए जा सकते. | इसमें ट्रांज़िट की जानकारी शामिल होती है. |
| ईको-फ़्रेंडली रास्ते नहीं मिल सके | इसमें यात्रा के हर मोड के लिए मेटाडेटा शामिल होता है. इसमें यात्रा के उस मोड के लिए चरणों की खास जानकारी होती है. यह जानकारी stepsOverview में होती है. इस मेटाडेटा का अनुरोध करने के लिए, stepsOverview फ़ील्ड मास्क का इस्तेमाल करें. |
| यह नहीं बताया जा सकता कि ट्रैफ़िक डेटा को कैसे और कब शामिल करना है | |
| रास्ते में आने वाली उन सुविधाओं के बारे में नहीं बताया जा सकता जिनसे बचना है | |
सिर्फ़ transitPreferences की जानकारी दी जा सकती है. ज़्यादा जानकारी के लिए, TransitPreference देखें. |
बस, मेट्रो वगैरह के रास्ते की जानकारी पाने के लिए
- यात्रा शुरू करने की जगह और मंज़िल सेट करें.
travelModeकोTRANSITपर सेट करें.- अपनी ज़रूरत के हिसाब से जवाब पाने के लिए, सही फ़ील्ड मास्क जोड़ें. आपको ट्रांज़िट रूट के जिन फ़ील्ड की ज़रूरत है उनके लिए अनुरोध करें लेख पढ़ें.
- अगर ज़रूरी हो, तो वैकल्पिक पैरामीटर सेट करें. ट्रांज़िट रूट के लिए पैरामीटर सेट करना लेख पढ़ें
आपको ट्रांज़िट रूट के जिन फ़ील्ड की ज़रूरत है उनके लिए अनुरोध करें
फ़ील्ड मास्क का इस्तेमाल करके, ट्रांज़िट रूट के उन फ़ील्ड का अनुरोध करें जिनकी आपको ज़रूरत है. इस टेबल में, किसी ट्रांज़िट रूट के लिए सुझाए गए कुछ जवाब और उन्हें पाने का अनुरोध करने के लिए इस्तेमाल की जाने वाली फ़ील्ड मास्क दी गई है.
| यह जानकारी पाने का अनुरोध करने के लिए | इस फ़ील्ड मास्क का इस्तेमाल करें |
|---|---|
| रास्ते की पूरी जानकारी. | * |
| रास्ते के लेग के लिए ट्रांज़िट की जानकारी. | legs |
| रास्ते के हर चरण के लिए अनुमानित किराया और स्थानीय भाषा में अनुमानित किराया. | travelAdvisory |
| अवधि और दूरी के लिए स्थानीय भाषा में टेक्स्ट | localizedValues |
ट्रांज़िट रूट के लिए पैरामीटर सेट करना
सार्वजनिक परिवहन के रास्तों के लिए काम के पैरामीटर यहां दिए गए हैं:
| ऐसा करने के लिए | इस पैरामीटर का इस्तेमाल करें | नोट |
|---|---|---|
| ट्रांज़िट मोड चुनें | travelMode: "TRANSIT" |
ज़रूरी है. ज़्यादा जानें. |
| पहुंचने या निकलने का समय सेट करना | arrivalTime: new Date(yyyy-mm-ddThh:mm:ssZ)
या departureTime: new Date(yyyy-mm-ddThh:mm:ssZ) |
ज़रूरी नहीं. आपके पास पहुंचने या निकलने का समय तय करने का विकल्प होता है. अगर दोनों में से कोई भी समय नहीं दिया गया है, तो departureTime की डिफ़ॉल्ट वैल्यू, मौजूदा एक्ज़ीक्यूशन का समय (now) होती है. मौजूदा एक्ज़ीक्यूशन के समय (now) को रेफ़रंस के तौर पर इस्तेमाल करके, सिर्फ़ इस समयावधि के लिए आने और जाने का समय सेट किया जा सकता है:
Date ऑब्जेक्ट के तौर पर दिखाया जाता है.
ध्यान दें: ट्रांज़िट के शेड्यूल में अक्सर बदलाव होता रहता है. साथ ही, ट्रांज़िट की उपलब्ध यात्राओं में समय के साथ बदलाव हो सकता है. इसके अलावा, बहुत पहले से की गई यात्राओं के अनुमान के लिए, लगातार एक जैसे नतीजे मिलने की कोई गारंटी नहीं है. |
| वैकल्पिक रास्ते शामिल करना | computeAlternativeRoutes: true |
ज़रूरी नहीं. अगर computeRoutes को तीन अतिरिक्त रास्ते कंप्यूट करने की अनुमति देनी है, तो इस विकल्प को 'सही है' पर सेट करें.
ज़्यादा जानें |
| ट्रांज़िट के टाइप के लिए प्राथमिकताएं तय करना | transitPreference: {allowedTransitModes: ["BUS", "SUBWAY", "TRAIN", "LIGHT_RAIL", "RAIL"]}
ध्यान दें: अगर आपने यात्रा का कोई पसंदीदा तरीका चुना है, तो भी दिखाए गए रास्तों में परिवहन के अन्य तरीकों का इस्तेमाल किया जा सकता है. ऐसा हो सकता है कि सिर्फ़ परिवहन के अन्य तरीकों का इस्तेमाल किया जाए. ऐसा, चुने गए तरीके से यात्रा करने में लगने वाले समय और उसकी उपलब्धता के आधार पर होता है. |
ज़रूरी नहीं. सार्वजनिक परिवहन के पसंदीदा मोड तय करें. ज़्यादा जानें |
| सार्वजनिक परिवहन के रूट के लिए प्राथमिकताएं तय करना | transitPreference: {routingPreference: "LESS_WALKING|FEWER_TRANSFERS"} |
ज़रूरी नहीं. सार्वजनिक परिवहन के रूटिंग की प्राथमिकताएं तय करें. ज़्यादा जानें |
अनुरोध का उदाहरण
यहां दिए गए उदाहरण में, ट्रांज़िट रूट का अनुरोध करने का तरीका बताया गया है:
const request = { origin: 'Hunters Point San Francisco, CA 94124', destination: '201 Marine Dr, San Francisco, CA 94129', travelMode: 'TRANSIT', departureTime: new Date(), transitPreference: { allowedTransitModes: ['BUS', 'SUBWAY', 'TRAIN', 'LIGHT_RAIL', 'RAIL'], routingPreference: 'FEWER_TRANSFERS', // Alternatively, 'LESS_WALKING'. }, fields: ['path', 'legs', 'travelAdvisory', 'localizedValues'], };