सार्वजनिक परिवहन के किसी रास्ते पर जाने के निर्देश मिलते हैं. इसके लिए, इलाके में उपलब्ध सार्वजनिक परिवहन (बस, मेट्रो वगैरह) के विकल्प इस्तेमाल किए जाते हैं. बस, मेट्रो वगैरह के विकल्पों में बस, सबवे, ट्रेन वगैरह शामिल हैं. आम तौर पर, ट्रांज़िट रास्ते में ट्रांज़िट स्टेशन से आने-जाने, वहां से जाने, और उनके बीच आने-जाने के निर्देश भी शामिल होते हैं. आम तौर पर, किसी ट्रांज़िट रास्ते के लिए आपको एक से ज़्यादा यात्रा के साधन इस्तेमाल करने पड़ते हैं. इसलिए, रूट का अनुरोध करने का आपका तरीका और रिस्पॉन्स के कुछ हिस्से अलग-अलग होते हैं.
बस, मेट्रो वगैरह के रास्ते, दूसरे रास्तों से अलग कैसे होते हैं
ट्रांज़िट रास्ते, जिनका अनुरोध आप Transit के TravelMode विकल्प को सेट करके करते हैं, वे अलग-अलग TravelMode विकल्पों का इस्तेमाल करने वाले रूट से अलग होते हैं. एक जैसे सभी ऑब्जेक्ट और विकल्पों का अनुरोध नहीं किया जा सकता. रिस्पॉन्स के तौर पर, दूसरे रूट की तुलना में अलग फ़ील्ड दिखते हैं.
रूट एपीआई में, सीढ़ियों को हर तरह की यात्रा के लिए एक नेविगेशन निर्देश माना जाता है. इसलिए, नेविगेशन के लिए दिया गया हर निर्देश एक चरण है. बस, मेट्रो वगैरह के रास्ते के लिए रिस्पॉन्स, यात्रा के दूसरे मोड के रास्तों जैसा ही होता है. इनमें कुछ मुख्य अंतर होते हैं:
अनुरोध में अंतर | जवाबों में अंतर |
---|---|
आप मध्यवर्ती वेपॉइंट तय नहीं कर सकते. | सार्वजनिक परिवहन की जानकारी शामिल है. |
ईको-फ़्रेंडली रास्ते का विकल्प नहीं मिल सका | इसमें हर यात्रा के उस मोड का मेटाडेटा शामिल होता है जिसमें उस यात्रा के मोड से जुड़े चरणों की खास जानकारी शामिल होती है. यह जानकारी `stepOverview` में होती है. इस मेटाडेटा का अनुरोध करने के लिए, `routes.legs.stepOverview` फ़ील्ड मास्क का इस्तेमाल करें. |
यह तय नहीं किया जा सकता कि ट्रैफ़िक डेटा को कैसे और कैसे शामिल किया जाए | |
बचने के लिए रास्ते की सुविधाएं तय नहीं कर सकते | |
routingPreference के लिए सिर्फ़ transitPreferences तय कर सकता है. ज़्यादा जानकारी के लिए,
[TransitPreferences](reference/rest/v2/TransitPreferences) देखें. |
रूट एपीआई से मिले रिस्पॉन्स के बारे में ज़्यादा जानकारी के लिए, बस, मेट्रो वगैरह के रास्ते के जवाबों की समीक्षा करना देखें.
बस, मेट्रो वगैरह का रूट पाने के लिए
अपनी यात्रा का शुरुआत की जगह और मंज़िल सेट करें.
यात्रा मोड को ट्रांज़िट पर सेट करें:
travelMode: "TRANSIT"
अपने हिसाब से रिस्पॉन्स फ़ील्ड पाने के लिए, फ़ील्ड मास्क जोड़ें. अपनी ज़रूरत के मुताबिक बस, मेट्रो वगैरह के रास्ते के लिए फ़ील्ड का अनुरोध करें देखें.
ज़रूरत पड़ने पर, वैकल्पिक पैरामीटर सेट करें. बस, मेट्रो वगैरह के रास्ते के लिए पैरामीटर सेट करना देखें.
अपनी ज़रूरत के हिसाब से बस, मेट्रो वगैरह के रास्ते के लिए फ़ील्ड का अनुरोध करें
फ़ील्ड मास्क का इस्तेमाल करके, बस, मेट्रो वगैरह के रास्ते के फ़ील्ड के लिए अनुरोध करें. नीचे दी गई टेबल में, ट्रांज़िट रूट के लिए सुझाए गए कुछ रिस्पॉन्स दिए गए हैं. साथ ही, उनका अनुरोध करने के लिए फ़ील्ड मास्क भी दिया गया है.
इस जानकारी का अनुरोध करने के लिए | इस फ़ील्ड मास्क का इस्तेमाल करें |
---|---|
सभी रास्तों की जानकारी | routes.* |
बस, मेट्रो वगैरह की पूरी जानकारी | routes.legs.steps.transitDetails |
हर पैर के लिए शुरू होने की जगह | routes.legs.steps.startLocation |
हर पैर के लिए खत्म होने की जगह | routes.legs.steps.endLocation |
हर चरण के लिए पॉलीलाइन का इस्तेमाल करें | routes.legs.steps.polyline |
हर चरण के लिए इस्तेमाल किया गया ट्रांज़िट किस तरह का है | routes.legs.steps.travelMode |
हर कदम और रास्ते के लिए अनुमानित किराया और स्थानीय भाषा में अनुमानित किराया | routes.travel_advisory.transitFare
localized routes.localizedValues.transitFare
ध्यान दें: |
अवधि और दूरी के लिए स्थानीय जगह के अनुसार टेक्स्ट | routes.localizedValues |
फ़ील्ड मास्क सेट करने के बारे में ज़्यादा जानकारी के लिए, लौटाने के लिए फ़ील्ड चुनें देखें.
बस, मेट्रो वगैरह के रास्ते के लिए पैरामीटर सेट करें
यहां बस, मेट्रो वगैरह के रूट के लिए काम के पैरामीटर दिए गए हैं:
ऐसा करने के लिए | इस पैरामीटर का इस्तेमाल करें | ज़रूरी जानकारी |
---|---|---|
बस, मेट्रो वगैरह का मोड चुनें | travelMode: "TRANSIT" |
ज़रूरी है. ज़्यादा जानें. |
पहुंचने या रवाना होने का समय सेट करें | "arrivalTime": "yyyy-mm-ddThh:mm:ssZ"
OR "departureTime": "yyyy-mm-ddThh:mm:ssZ" |
ज़रूरी नहीं. आप arrival_time या flight_time तय कर सकते हैं. अगर
कोई भी समय तय नहीं किया गया है, तो departure_time डिफ़ॉल्ट रूप से,
एक्ज़ीक्यूशन के मौजूदा समय (now ) पर सेट होता है. आपके पास आने और
रवाना होने का समय, सिर्फ़ इस समयावधि में सेट करने का विकल्प होता है. हालांकि, रेफ़रंस के तौर पर,
एक्ज़ीक्यूशन का मौजूदा समय (now ) सेट किया जा सकता है:
|
वैकल्पिक रास्ते शामिल करें | "computeAlternativeRoutes": true |
ज़रूरी नहीं. राऊटर के लिए एपीआई उपलब्ध होने पर, इसे 3 और रूट तक कैलकुलेट करने के लिए, 'सही है' पर सेट करें. ज़्यादा जानें |
ट्रांज़िट प्रकार के लिए प्राथमिकताएं तय करें | "transitPreferences": { allowedTravelModes: ["BUS","SUBWAY","TRAIN","LIGHT_RAIL","RAIL"]}
ध्यान दें: अगर आपने यात्रा का कोई पसंदीदा मोड चुना है, तो हो सकता है कि लौटाए गए रास्तों पर दूसरे ट्रांज़िट मोड का भी इस्तेमाल किया जा सके. भले ही, वे सिर्फ़ दूसरे ट्रांज़िट मोड का इस्तेमाल कर रहे हों. यह इस बात पर निर्भर करता है कि खरीदे गए रास्ते की क्षमता और यात्रा के लिए चुनी गई जगह की जानकारी उपलब्ध है या नहीं. |
ज़रूरी नहीं. यात्रा के पसंदीदा मोड तय करें. ज़्यादा जानें |
ट्रांज़िट रास्ते के लिए प्राथमिकताएं तय करें | "transitPreferences": {routingPreference: "LESS_WALKING|FEWER_TRANSFERS"} |
ज़रूरी नहीं. ट्रांज़िट रूटिंग प्राथमिकताएं तय करें. ज़्यादा जानें |
उदाहरण: बस, मेट्रो वगैरह के लिए कोई रास्ता पाएं
नीचे दिए गए उदाहरण में, इन पैरामीटर के साथ सार्वजनिक परिवहन के रूट को दिखाया गया है:
ट्रेन में यात्रा और कम पैदल यात्रा के लिए प्राथमिकताएं तय करता है.
दूसरे रास्तों के लिए अनुरोध करता है.
ऐसा फ़ील्ड मास्क देता है जो ट्रांज़िट की जानकारी देता है:
curl -X POST -H 'content-type: application/json' -d '{ "origin": { "address": "Humberto Delgado Airport, Portugal" }, "destination": { "address": "Basílica of Estrela, Praça da Estrela, 1200-667 Lisboa, Portugal" }, "travelMode": "TRANSIT", "computeAlternativeRoutes": true, "transitPreferences": { routingPreference: "LESS_WALKING", allowedTravelModes: ["TRAIN"] }, }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.legs.steps.transitDetails' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
रिस्पॉन्स में इन दोनों रूट के लिए route.legs.steps.transitDetails
फ़ील्ड दिखते हैं:
{ "routes": [ { "legs": [ { "steps": [ {}, {}, {}, { "transitDetails": { "stopDetails": { "arrivalStop": { "name": "Saldanha", "location": { "latLng": { "latitude": 38.73532, "longitude": -9.14543 } } }, "arrivalTime": "2023-08-26T10:49:42Z", "departureStop": { "name": "Aeroporto", "location": { "latLng": { "latitude": 38.769047799999996, "longitude": -9.1284593 } } }, "departureTime": "2023-08-26T10:32:10Z" }, "localizedValues": { "arrivalTime": { "time": { "text": "11:49" }, "timeZone": "Europe/Lisbon" }, "departureTime": { "time": { "text": "11:32" }, "timeZone": "Europe/Lisbon" } }, "headsign": "São Sebastião", "transitLine": { "agencies": [ { "name": "Metropolitano de Lisboa, E.P.E.", "phoneNumber": "+351 21 350 0115", "uri": "https://www.metrolisboa.pt/" } ], "name": "Vermelha", "color": "#f23061", "nameShort": "Vm", "textColor": "#000000", "vehicle": { "name": { "text": "Metrô" }, "type": "SUBWAY", "iconUri": "//maps.gstatic.com/mapfiles/transit/iw2/6/subway2.png" } }, "stopCount": 11 } }, {}, { "transitDetails": { "stopDetails": { "arrivalStop": { "name": "Rato", "location": { "latLng": { "latitude": 38.7201022, "longitude": -9.1540562 } } }, "arrivalTime": "2023-08-26T11:01:37Z", "departureStop": { "name": "Saldanha", "location": { "latLng": { "latitude": 38.73527, "longitude": -9.1455200000000012 } } }, "departureTime": "2023-08-26T10:57:57Z" }, "localizedValues": { "arrivalTime": { "time": { "text": "12:01" }, "timeZone": "Europe/Lisbon" }, "departureTime": { "time": { "text": "11:57" }, "timeZone": "Europe/Lisbon" } }, "headsign": "Rato", "transitLine": { "agencies": [ { "name": "Metropolitano de Lisboa, E.P.E.", "phoneNumber": "+351 21 350 0115", "uri": "https://www.metrolisboa.pt/" } ], "name": "Amarela", "color": "#f2c200", "nameShort": "Am", "textColor": "#000000", "vehicle": { "name": { "text": "Metrô" }, "type": "SUBWAY", "iconUri": "//maps.gstatic.com/mapfiles/transit/iw2/6/subway2.png" } }, "stopCount": 4 } }, {}, {}, {}, {}, {}, {} ] } ] } ] }