रूट एपीआई Compute Routes
तरीका डिफ़ॉल्ट रूप से, आपके दिए गए क्रम में कई स्टॉप से होकर रूट का हिसाब लगाता है. इन्हें स्टॉपओवर वेपॉइंट कहते हैं.
स्टॉप को सही क्रम में लगाकर, Routes API को दिए गए रूट को ऑप्टिमाइज़ किया जा सकता है. वेपॉइंट ऑप्टिमाइज़ेशन, यात्रा में लगने वाले समय के लिए ऑप्टिमाइज़ होता है. हालांकि, सबसे बेहतर रास्ता तय करते समय, दूरी और मोड़ की संख्या जैसे फ़ैक्टर को भी ध्यान में रखा जाता है.
वेपॉइंट ऑप्टिमाइज़ करने के लिए
पक्का करें कि रास्ते के किसी भी वेपॉइंट के लिए
via
कोtrue
पर सेट न किया गया हो, जैसे कि:{"address": "Clare,SA", "via": true}
. इंटरमीडिएट वेपॉइंट के बारे में ज़्यादा जानकारी के लिए, इंटरमीडिएट वेपॉइंट तय करना देखें.पक्का करें कि
routing_preference
कोTRAFFIC_AWARE_OPTIMAL
पर सेट न किया गया हो.optimize_waypoint_order
कोtrue
पर सेट करें. उदाहरण के लिए:"optimizeWaypointOrder": "true",
फ़ील्ड मास्क में
routes.optimizedIntermediateWaypointIndex
फ़ील्ड की जानकारी दें:आराम
-H X-Goog-FieldMask: routes.optimizedIntermediateWaypointIndex
आरपीसी
const (fieldMask = "routes.optimizedIntermediateWaypointIndex")
वेपॉइंट ऑर्डर को ऑप्टिमाइज़ करने का तरीका जानें
यहां बताया गया है कि Routes API किसी रूट में वेपॉइंट के क्रम को कैसे ऑप्टिमाइज़ करता है:
आपने अनुरोध में जो ऑर्डर दिया है उसके आधार पर वेपॉइंट अपने-आप इंडेक्स हो जाते हैं. यह क्रम 0 से शुरू होता है.
अनुरोध में वेपॉइंट को असाइन किए गए इंडेक्स नंबर का इस्तेमाल करके, वेपॉइंट के क्रम को ऑप्टिमाइज़ करता है.
यह विकल्प
waypoint_order
फ़ील्ड में,routes.optimizedIntermediateWaypointIndex
के नीचे मौजूदroutes
ऑब्जेक्ट में, ऑप्टिमाइज़ किया गया वेपॉइंट का क्रम दिखाता है.
उदाहरण
इस अनुरोध में, ऐडलेड, साउथ ऑस्ट्रेलिया के हर मुख्य वाइन क्षेत्र के लिए एक रूट को ऑप्टिमाइज़ करने और फिर ऐडलेड वापस लौटने के लिए कहा गया है.
curl -X POST -H 'content-type: application/json' -d ' { "origin": { "address": "Adelaide,SA" }, "destination": { "address": "Adelaide,SA" }, "intermediates": [ {"address": "Barossa+Valley,SA"}, {"address": "Clare,SA"}, {"address": "Connawarra,SA"}, {"address": "McLaren+Vale,SA"} ], "travelMode": "DRIVE", "optimizeWaypointOrder": "true" }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.optimizedIntermediateWaypointIndex' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
रूट एपीआई अनुरोध में दिए गए इंटरमीडिएट वेपॉइंट को इंडेक्स करता है, जो 0 से शुरू होते हैं. उदाहरण के लिए:
0 {"address": "Barossa+Valley,SA"}, 1 {"address": "Clare,SA"}, 2 {"address": "Connawarra,SA"}, 3 {"address": "McLaren+Vale,SA"}
अनुरोध में दिए गए चार वेपॉइंट के लिए इंडेक्स नंबर का इस्तेमाल करके, सेवा, ऑप्टिमाइज़ किया गया ऑर्डर दिखाती है:
"optimizedIntermediateWaypointIndex": [ 3, 2, 0, 1 ]