अन्य रास्तों का अनुरोध करें

डिफ़ॉल्ट रूप से, Routes API डिफ़ॉल्ट रूट दिखाता है. यह आम तौर पर, मूल से मंज़िल तक का सबसे तेज़ रास्ता होता है. जब अन्य रूट का अनुरोध किया जाता है, तो एपीआई डिफ़ॉल्ट रूट के साथ तीन रूट तक दिखाता है. इसके बाद, आपके ग्राहक अपनी ज़रूरत के हिसाब से सबसे सही रास्ता चुन सकते हैं.

दूसरे रास्तों का अनुरोध करते समय इन बातों का ध्यान रखें

दूसरे रास्तों का अनुरोध करने के लिए, इन बातों का ध्यान रखें:

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

  • जवाब में ज़्यादा से ज़्यादा तीन वैकल्पिक रास्ते शामिल होते हैं. हालांकि, कभी-कभी कोई दूसरा रास्ता उपलब्ध नहीं होता, इसलिए जवाब में सिर्फ़ डिफ़ॉल्ट रास्ता शामिल होता है.

  • वैकल्पिक रूट का पता लगाने के लिए अतिरिक्त प्रोसेसिंग की ज़रूरत होती है, इसलिए दूसरे रूट का अनुरोध करने से एपीआई का रिस्पॉन्स टाइम बढ़ सकता है.

वैकल्पिक रास्तों के अनुरोध का उदाहरण

दूसरे रास्तों का अनुरोध करने के लिए, computeAlternativeRoutes को true पर सेट करें. इस उदाहरण में, computeRoutes तरीके (REST) अनुरोध की मदद से, दूसरे रूट के लिए अनुरोध करने का तरीका बताया गया है.

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude":42.340173523716736,
        "longitude":-71.05997968330408
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":42.075698891472804,
        "longitude": -72.59806562080408
      }
    }
  },
  "travelMode": "DRIVE",
  "routingPreference":"TRAFFIC_AWARE",
  "computeAlternativeRoutes": true
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

इस उदाहरण में, आपने फ़ील्ड मास्क तय किया है, ताकि रिस्पॉन्स में हर रूट के लिए सिर्फ़ duration, distanceMeters,, और routeLabels प्रॉपर्टी शामिल हों. इसके बाद, आपका ग्राहक उस जानकारी का इस्तेमाल करके, सही रास्ता चुन सकता है. ज़्यादा जानकारी के लिए, चुनें कि कौनसी जानकारी दिखानी है.

वैकल्पिक रास्तों के रिस्पॉन्स का उदाहरण

जवाब में, रीच रूट की पहचान करने के लिए routeLabels कलेक्शन प्रॉपर्टी का इस्तेमाल करें:

  • डिफ़ॉल्ट रास्ते के लिए, routeLabels प्रॉपर्टी में DEFAULT_ROUTE शामिल है.

  • किसी भी दूसरे रास्ते के लिए, routeLabels प्रॉपर्टी में DEFAULT_ROUTE_ALTERNATE शामिल होता है.

इस उदाहरण में, जवाब में डिफ़ॉल्ट रास्ता और दो वैकल्पिक रास्ते शामिल हैं. ध्यान दें कि हर रूट के लिए duration और distanceMeters प्रॉपर्टी की वैल्यू अलग-अलग होती हैं:

{
  "routes": [
    {
      "distanceMeters": 150322,
      "duration": "5309s",
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 157614,
      "duration": "6879s",
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    },
    {
      "distanceMeters": 189311,
      "duration": "7376s",
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    }
   ]
}

जवाब में पॉलीलाइन शामिल करें

उपयोगकर्ता आसानी से रास्ता चुन सके, इसके लिए जवाब में हर रास्ते के लिए पॉलीलाइन जोड़ें. इसके बाद, हर पॉलीलाइन को मैप पर दिखाया जा सकता है.

पॉलीलाइन जोड़ने के लिए, फ़ील्ड मास्क में routes.polyline शामिल करें:

-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels,routes.polyline'

इसके बाद, जवाब में हर रास्ते के लिए पॉलीलाइन शामिल होती है:

{
  "routes": [
    {
      "distanceMeters": 150322,
      "duration": "5309s",
      "polyline": {
        "encodedPolyline": "mrlaGtavpLPLBTm…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 157614,
      "duration": "6879s",
      "polyline": {
        "encodedPolyline": "DmEd`@e@pCo@pCs@z…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    },
    {
      "distanceMeters": 189311,
      "duration": "7376s",
      "polyline": {
        "encodedPolyline": "FVLL|Af@HPAV…PgA^qC"
      },
      "routeLabels": [
        "DEFAULT_ROUTE_ALTERNATE"
      ]
    }
   ]
}