अन्य रास्ते देखना

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