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

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