परिवहन का रास्ता, उस इलाके में उपलब्ध सार्वजनिक परिवहन विकल्पों का इस्तेमाल करके नेविगेशन निर्देश देता है. परिवहन के विकल्पों में बस, सबवे, ट्रेन वगैरह शामिल हो सकते हैं. आम तौर पर सार्वजनिक परिवहन के रास्ते में ट्रांज़िट स्टेशन तक, से और उनके बीच पैदल जाने के निर्देश होते हैं. आम तौर पर, सार्वजनिक परिवहन से यात्रा के लिए एक से ज़्यादा मोड का इस्तेमाल करना पड़ता है. इसलिए, रास्ते का अनुरोध करने का तरीका और रिस्पॉन्स के कुछ हिस्से अलग-अलग होते हैं.
सार्वजनिक परिवहन के रास्ते दूसरे रास्तों से कैसे अलग हैं
बस, मेट्रो वगैरह के जिन रास्तों का अनुरोध किया जाता है वे ट्रांज़िट मोड के लिए TravelMode सेट करके अनुरोध करते हैं. ये रास्ते, उन रास्तों से अलग होते हैं जो अलग-अलग TravelMode विकल्पों का इस्तेमाल करते हैं. आप एक ही तरह के सभी ऑब्जेक्ट और विकल्पों के लिए अनुरोध नहीं कर सकते. साथ ही, जवाब में दूसरे रूट की तुलना में अलग-अलग फ़ील्ड दिखते हैं.
Routes API में, सभी तरह की यात्राओं के लिए नेविगेशन के निर्देश एक ही होते हैं. इसलिए, नेविगेशन के लिए हर निर्देश एक चरण होता है. बस, मेट्रो वगैरह के रूट का जवाब, यात्रा के अन्य मोड वाले रास्तों से काफ़ी मिलता-जुलता होता है. हालांकि, इन रास्तों में कुछ अंतर होते हैं:
| अनुरोधों में अंतर | जवाबों में अंतर |
|---|---|
| आप मध्यवर्ती वेपॉइंट तय नहीं कर सकते. | इसमें बस, मेट्रो वगैरह की जानकारी शामिल है. |
| ईको-फ़्रेंडली रास्ते का विकल्प नहीं मिल सका | इसमें यात्रा के हर मोड का मेटाडेटा शामिल होता है. इसमें उस यात्रा के मोड के चरणों की खास जानकारी शामिल होती है. यह जानकारी `stepsOverview` में है. इस मेटाडेटा का अनुरोध करने के लिए, `routes.legs.stepsOverview` फ़ील्ड मास्क का इस्तेमाल करें. |
| यह तय नहीं किया जा सकता कि ट्रैफ़िक डेटा को कैसे और अगर शामिल करना है, तो | |
| से बचने के लिए मार्ग विशेषताएं तय नहीं कर सकते | |
सिर्फ़ routingPreference के लिए, transitPreferences की जानकारी दी जा सकती है. ज़्यादा जानकारी के लिए,
[TransitPreferences](reference/rest/v2/TransitPreferences) देखें. |
Routes API से मिलने वाले रिस्पॉन्स के बारे में ज़्यादा जानने के लिए, बस, मेट्रो वगैरह के रास्ते के रिस्पॉन्स की समीक्षा करें देखें.
सार्वजनिक परिवहन के रास्ते की जानकारी पाने के लिए
अपनी यात्रा की शुरुआत की जगह और मंज़िल सेट करें.
यात्रा के मोड को सार्वजनिक परिवहन पर सेट करें:
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" |
ज़रूरी नहीं. आप पंक्तियों में से किसी एक का समय तय कर सकते हैं, उसका समय तय कर सकते हैं या रवाना होने का समय बता सकते हैं. अगर
कोई भी समय तय नहीं किया जाता है, तो departure_time डिफ़ॉल्ट रूप से
मौजूदा लागू होने का समय (now) को सेट कर देता है. पहुंचने और जाने का समय,
सिर्फ़ अगली समयावधि में ही सेट किया जा सकता है. इसके लिए, मौजूदा समय (now) को रेफ़रंस के तौर पर
इस्तेमाल किया जा सकता है:
|
| वैकल्पिक रास्ते शामिल करें | "computeAlternativeRoutes": true |
ज़रूरी नहीं. रूट एपीआई उपलब्ध होने पर, तीन अन्य रूट तक कंप्यूट करने के लिए, 'सही है' पर सेट करें. ज़्यादा जानें |
| बस, मेट्रो वगैरह के टाइप के लिए प्राथमिकताएं बताएं | "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
}
},
{},
{},
{},
{},
{},
{}
]
}
]
}
]
}