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