बस, मेट्रो वगैरह का रास्ता पाएं

बस, मेट्रो वगैरह के रास्ते से जाने के लिए निर्देश मिलते हैं में आपको ये विकल्प मिल सकते हैं. बस, मेट्रो वगैरह के विकल्पों में बस, सबवे, और ट्रेन वगैरह. आम तौर पर, बस, मेट्रो वगैरह के रास्ते में ट्रांज़िट स्टेशन तक पैदल जाने, वहां से जाने, और उनके बीच आने-जाने के लिए. क्योंकि बस, मेट्रो वगैरह के रास्ते से आम तौर पर, आपको यात्रा के एक से ज़्यादा साधन इस्तेमाल करके यात्रा करनी पड़ती है, तो मेरे रूट का अनुरोध करते हैं और जवाब के कुछ हिस्से अलग हैं.

बस, मेट्रो वगैरह के रास्ते, दूसरे रास्तों से अलग कैसे होते हैं

ट्रांज़िट रास्ते, जिनका अनुरोध आप Transit के लिए TravelMode सेट करके करते हैं, ये अलग-अलग होते हैं जो अलग-अलग TravelMode विकल्पों का इस्तेमाल करके रूट किए जाते हैं. एक जैसे सभी ऑब्जेक्ट और विकल्पों के लिए, अनुरोध नहीं किया जा सकता और रिस्पॉन्स मिलता है पर क्लिक करें.

रूट एपीआई में, सिलसिलेवार तरीके से एक नेविगेशन निर्देश होता है ट्रैक कर सकते हैं. इसलिए, नेविगेशन के लिए दिया गया हर निर्देश एक चरण है. बस, मेट्रो वगैरह रूट रिस्पॉन्स, यात्रा के अन्य मोड वाले रास्तों जैसा ही होता है. हालांकि, बस कुछ बटन को दबाकर रखें. अंतर:

अनुरोध में अंतर जवाबों में अंतर
आप मध्यवर्ती वेपॉइंट तय नहीं कर सकते. सार्वजनिक परिवहन की जानकारी शामिल है.
ईको-फ़्रेंडली रास्ते का विकल्प नहीं मिल सका इसमें हर यात्रा के साधन का मेटाडेटा शामिल होता है, जिसमें उस यात्रा मोड का इस्तेमाल करना होगा. `StepOverview` में (इस मेटाडेटा का अनुरोध करने के लिए, `routes.legs.stepsOverview` फ़ील्ड मास्क).
यह तय नहीं किया जा सकता कि ट्रैफ़िक डेटा को कैसे और कैसे शामिल किया जाए
बचने के लिए रास्ते की सुविधाएं तय नहीं कर सकते
इसके लिए सिर्फ़ transitPreferences तय कर सकता है routingPreference. जानकारी के लिए, यह देखें [TransitPreferences](reference/rest/v2/TransitPreferences).

Routes API से मिलने वाले रिस्पॉन्स के बारे में ज़्यादा जानकारी के लिए देखें बस, मेट्रो वगैरह के रास्ते के रिस्पॉन्स की समीक्षा करें.

बस, मेट्रो वगैरह का रूट पाने के लिए

  1. अपनी यात्रा का शुरुआत की जगह और मंज़िल सेट करें.

  2. यात्रा मोड को ट्रांज़िट पर सेट करें:

    travelMode: "TRANSIT"

  3. अपने हिसाब से रिस्पॉन्स फ़ील्ड पाने के लिए, फ़ील्ड मास्क जोड़ें. यहां जाएं: अपनी ज़रूरत के मुताबिक बस, मेट्रो वगैरह के रास्ते के लिए फ़ील्ड का अनुरोध करें.

  4. ज़रूरत पड़ने पर, वैकल्पिक पैरामीटर सेट करें. यहां जाएं: बस, मेट्रो वगैरह के रास्ते के लिए पैरामीटर सेट करें.

अपनी ज़रूरत के हिसाब से बस, मेट्रो वगैरह के रास्ते के लिए फ़ील्ड का अनुरोध करें

फ़ील्ड मास्क का इस्तेमाल करके, बस, मेट्रो वगैरह के रास्ते के फ़ील्ड के लिए अनुरोध करें. नीचे दी गई टेबल इसमें बस, मेट्रो वगैरह के लिए सुझाए गए कुछ जवाब शामिल हैं और फ़ील्ड मास्क का इस्तेमाल किया जा सकता है.

इस जानकारी का अनुरोध करने के लिए इस फ़ील्ड मास्क का इस्तेमाल करें
सभी रास्तों की जानकारी 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

ध्यान दें: transitFare सिर्फ़ तब उपलब्ध कराया जाता है, जब एपीआई यह काम कर सकता है सभी चरणों के लिए ट्रांज़िट किराये की जानकारी तय करें.

अवधि और दूरी के लिए स्थानीय जगह के अनुसार टेक्स्ट routes.localizedValues

फ़ील्ड मास्क सेट करने के बारे में ज़्यादा जानकारी के लिए, देखें लौटाए जाने वाले फ़ील्ड चुनें.

ट्रांज़िट रास्ते के लिए पैरामीटर सेट करें

यहां बस, मेट्रो वगैरह के रूट के लिए काम के पैरामीटर दिए गए हैं:

ऐसा करने के लिए इस पैरामीटर का इस्तेमाल करें नोट
बस, मेट्रो वगैरह का मोड चुनें travelMode: "TRANSIT" ज़रूरी है. ज़्यादा जानें.
पहुंचने या रवाना होने का समय सेट करें "arrivalTime": "yyyy-mm-ddThh:mm:ssZ"

या

"departureTime": "yyyy-mm-ddThh:mm:ssZ"
ज़रूरी नहीं. आप arrival_time या flight_time तय कर सकते हैं. अगर आपने कोई भी समय तय नहीं किया गया है, departure_time डिफ़ॉल्ट रूप से लागू होने का मौजूदा समय (now). पहुंचने का समय सेट किया जा सकता है और रवानगी का समय, नीचे दिए गए समय के अंदर हो, जिसमें मौजूदा समय भी शामिल हो एक्ज़ीक्यूशन का समय (now) रेफ़रंस के तौर पर:
  • now से पहले के 7 दिन और शामिल
  • now के बाद 100 दिनों तक और
समय को आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप के तौर पर दिखाया जाता है फ़ॉर्मैट. ज़्यादा जानें
वैकल्पिक रास्ते शामिल करें "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
          }
        },
        {},
        {},
        {},
        {},
        {},
        {}
        ]
      }
    ]
  }
]
}