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

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

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

सार्वजनिक परिवहन के रास्ते, अन्य रास्तों से कैसे अलग होते हैं

TRANSIT का travelMode सेट करके अनुरोध किए गए सार्वजनिक परिवहन के रास्ते, travelMode के अलग-अलग विकल्पों का इस्तेमाल करके तय किए गए रास्तों से अलग होते हैं. एक जैसे सभी ऑब्जेक्ट और विकल्पों का अनुरोध नहीं किया जा सकता. साथ ही, अन्य रास्तों की तुलना में जवाब में अलग-अलग फ़ील्ड दिखते हैं.

Routes API में, हर चरण में नेविगेशन से जुड़ा एक निर्देश होता है. यह निर्देश, यात्रा के सभी तरीकों के लिए एक जैसा होता है. इसलिए, नेविगेशन से जुड़ा हर निर्देश एक चरण होता है. बस, मेट्रो वगैरह के रूट का जवाब, यात्रा के अन्य तरीकों के रूट के जवाब से काफ़ी मिलता-जुलता है. हालांकि, इन दोनों के बीच कुछ मुख्य अंतर हैं:

अंतर का अनुरोध करना जवाबों में अंतर
रास्ते में पड़ने वाले इंटरमीडिएट वेपॉइंट तय नहीं किए जा सकते. इसमें ट्रांज़िट की जानकारी शामिल होती है.
ईको-फ़्रेंडली रास्ते नहीं मिल सके इसमें यात्रा के हर मोड के लिए मेटाडेटा शामिल होता है. इसमें यात्रा के उस मोड के लिए चरणों की खास जानकारी होती है. यह जानकारी `stepsOverview` में होती है. इस मेटाडेटा का अनुरोध करने के लिए, `routes.legs.stepsOverview` फ़ील्ड मास्क का इस्तेमाल करें.
यह नहीं बताया जा सकता कि ट्रैफ़िक डेटा को कैसे और कब शामिल करना है
रास्ते की उन सुविधाओं के बारे में नहीं बताया जा सकता जिनसे बचना है
routingPreference के लिए, सिर्फ़ transitPreferences की जानकारी दी जा सकती है. ज़्यादा जानकारी के लिए, 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 या departure_time में से किसी एक की जानकारी दी जा सकती है. अगर दोनों में से कोई भी समय नहीं दिया गया है, तो departure_time की डिफ़ॉल्ट वैल्यू, मौजूदा एक्ज़ीक्यूशन का समय (now) होती है. मौजूदा एक्ज़ीक्यूशन के समय (now) को रेफ़रंस के तौर पर इस्तेमाल करके, सिर्फ़ इस समयावधि के लिए आने और जाने का समय सेट किया जा सकता है:
  • now से सात दिन पहले तक
  • now के 100 दिनों तक
समय को आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में टाइमस्टैंप के तौर पर दिखाया जाता है. ज़्यादा जानें

ध्यान दें: ट्रांज़िट के शेड्यूल में अक्सर बदलाव होता रहता है. साथ ही, ट्रांज़िट की उपलब्ध यात्राओं में समय के साथ बदलाव हो सकता है. इसके अलावा, बहुत पहले से की गई यात्राओं के अनुमान के लिए, लगातार एक जैसे नतीजे देने की कोई गारंटी नहीं है.
वैकल्पिक रास्ते शामिल करें "computeAlternativeRoutes": true ज़रूरी नहीं. इस विकल्प को 'सही' पर सेट करने से, Compute Routes एपीआई ज़्यादा से ज़्यादा तीन अतिरिक्त रास्ते दिखाएगा. हालांकि, ऐसा सिर्फ़ तब होगा, जब अतिरिक्त रास्ते उपलब्ध होंगे. ज़्यादा जानें
ट्रांज़िट के टाइप के लिए प्राथमिकताएं तय करना "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
          }
        },
        {},
        {},
        {},
        {},
        {},
        {}
        ]
      }
    ]
  }
]
}