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