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

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