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

डिफ़ॉल्ट रूप से, 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"
      ]
    }
   ]
}