वेपॉइंट ऑप्टिमाइज़ेशन, Routes Preferred की एक सुविधा है. यह ComputeRoutes की सुविधा को बेहतर बनाती है.
यह सुविधा, यात्रा करने वाले व्यक्ति के रास्ते में पड़ने वाले इंटरमीडिएट वेपॉइंट के क्रम को ऑप्टिमाइज़ करती है. इससे यह पक्का होता है कि वे सबसे बेहतर रास्ते से यात्रा करें. ComputeRoutes
वेपॉइंट ऑप्टिमाइज़ेशन की सुविधा, यात्रा के इन तरीकों के लिए काम करती है:
- ड्राइविंग
- मोटर वाला दोपहिया वाहन
- साइकलिंग
- पैदल
वेपॉइंट ऑप्टिमाइज़ेशन का इस्तेमाल क्यों करना चाहिए?
अगर आपको ऐसा ऐप्लिकेशन बनाना है जो उपयोगकर्ताओं को किसी जगह पर पहुंचने के रास्ते में कई वेपॉइंट के बारे में जानकारी देता है, तो यह ज़रूरी है कि यात्री वेपॉइंट से सही क्रम में गुज़रें. इससे यह पक्का होता है कि यात्री हर वेपॉइंट पर कम से कम समय में पहुंचे.
यह कैसे काम करता है
डिफ़ॉल्ट रूप से, ComputeRoutes अपने वेपॉइंट के हिसाब से रास्ते का हिसाब लगाता है. ऐसा उस क्रम में किया जाता है जिस क्रम में वेपॉइंट दिए गए थे. ComputeRoutes की मदद से, रास्ते को ऑप्टिमाइज़ किया जा सकता है. इसके लिए, बीच के वेपॉइंट को ज़्यादा असरदार क्रम में फिर से व्यवस्थित करें.
अगर अनुरोध के मुख्य हिस्से में optimizeWaypointOrder फ़ील्ड को true पर सेट किया जाता है, तो आपको ऑप्टिमाइज़ किए गए वेपॉइंट वाला रूट मिलेगा.
ध्यान दें: वेपॉइंट ऑप्टिमाइज़ेशन की कैलकुलेशन मुख्य रूप से यात्रा में लगने वाले समय पर आधारित होती है. हालांकि, यह सुविधा अन्य बातों को भी ध्यान में रखती है. जैसे, दूरी और मुड़ना.
फिर से क्रम में लगाए गए वेपॉइंट पाना
रास्ते के क्रम में लगाए गए वेपॉइंट के साथ कोई रास्ता पाने के लिए, अपने अनुरोध के मुख्य हिस्से में ComputeRoutes के लिए बूलियन फ़ील्ड optimizeWaypointOrder को true पर सेट करें. साथ ही, फ़ील्ड मास्क में optimizedIntermediateWaypointIndex फ़ील्ड को भी शामिल करें. जवाब के मुख्य हिस्से में, optimizedIntermediateWaypointIndex फ़ील्ड में वेपॉइंट का ऑप्टिमाइज़ किया गया क्रम शामिल होता है.
ध्यान दें: optimizedIntermediateWaypointIndex फ़ील्ड, शून्य पर आधारित वैल्यू दिखाता है.
अनुरोध का उदाहरण
अनुरोध के इस उदाहरण में, स्टैनफ़र्ड यूनिवर्सिटी कैंपस के पास का रास्ता दिखाया गया है. अनुरोध में, रास्ते के वेपॉइंट क्रम से दिए गए हैं. अनुरोध में, यात्रा शुरू करने की जगह और मंज़िल के साथ-साथ, रास्ते में रुकने के लिए दो जगहों की जानकारी शामिल है.
POST /v1alpha:computeRoutes
Host: routespreferred.googleapis.com
Content-Type: application/json
X-Server-Timeout: 10
X-Goog-Api-Key: YOUR_API_KEY
X-Goog-FieldMask: routes.optimizedIntermediateWaypointIndex,routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
{
"origin":{
"location":{
"latLng":{
"latitude": 37.418956,
"longitude": -122.160815
}
}
},
"intermediates": [
{
"location":{
"latLng":{
"latitude": 37.4176423,
"longitude":-122.1102246
}
}
},
{
"location":{
"latLng":{
"latitude": 37.407689,
"longitude": -122.1360597
}
}
}
],
"destination":{
"location":{
"latLng":{
"latitude": 37.4032137,
"longitude": -122.0349119
}
}
},
"travelMode": "DRIVE",
"optimizeWaypointOrder": true,
"routingPreference": "TRAFFIC_AWARE"}
जवाब का उदाहरण
आपको जवाब के मुख्य हिस्से में मौजूद routes ऑब्जेक्ट में, optimizedIntermediateWaypointIndex फ़ील्ड में, बीच के वेपॉइंट के फिर से क्रम में लगाए गए इंडेक्स मिल सकते हैं. एनकोड की गई पॉलीलाइन, Directions API और ComputeRoutes में मौजूद पॉलीलाइन के जैसी ही होती है.
routes {
distance_meters: 17647
duration {
seconds: 1866
}
polyline {
encoded_polyline: "wkkcFvorhVU{@Ec@C}CG}@Mm@[}@i@y@[[g@_@Tk@BSjCgGfF|D\\Pv@Lj@@XaCTeC\\aCTs@`ByD`@k@h@e@x@Yh@GtADhBF|@G`AWpAs@lAsAdA{A`BmDr@cBmUqQoS}OyGmFiBsAgEwD}CaCU_@Og@@e@Hy@nGkO~@sBr@cBlDqIlByEp@}AjIfGnBbBHLLd@^p@~ErDfNrKrA~@DIhEeBTQ~AqDlE{KjBgE|FnEh@aAi@`A}FoE~AmD`A}BcAm@mHwFwD}CkLwIsDqCgF_EG[GKnCsDrA_BrC_CnCoBpEkD`EyClCsBcBeBIAkGkH]k@eJmKQKsAuA_@g@wCoDGQmEmFmIqROKaDuHvBkBxAgANCRH^f@v@dBHDD?`AUiBqEhBpEaATMCQYm@wAY]SIOByAfAwBjB_ByDaAwBiCeIA[c@aBqEuNOm@IQbA{c@p@aZFmCTuBLg@Tc@BUAKxOeV~Vy_@nBoDv@_BvAcDzA_EdG{RdC{HtIsY|B{Hx@mDbAuFdBsMbKsv@TaBf@}AdF{Sn@_DJq@Lo@aE`@]GUQmAmAQk@@g@RK`Ce@d@UDEPc@f@cCrAyGJs@X{AbIem@bA{JD_AIaAMg@o@{A_Ad@y@NaCLCsCK_FGI"
}
optimizedIntermediateWaypointIndex: 1
optimizedIntermediateWaypointIndex: 0
}
इस उदाहरण में ध्यान दें कि वेपॉइंट को ऑप्टिमाइज़ करने से, उनका ओरिजनल क्रम बदल जाता है.
सुझाए गए तरीके
ऑप्टिमाइज़ किए गए वेपॉइंट वाले अनुरोध को प्रोसेस होने में, सामान्य राउटिंग के अनुरोध से ज़्यादा समय लगता है. इसलिए, हमारा सुझाव है कि आप X-Server-Timeout अनुरोध हेडर के लिए कम से कम दस सेकंड की वैल्यू सेट करके, तरीके को कॉल करने पर ज़्यादा टाइमआउट सेट करें. अगर आपको अब भी टाइमआउट से जुड़ी गड़बड़ियां मिल रही हैं, तो एक सेकंड और जोड़कर फिर से कोशिश करें.
इस्तेमाल करने से जुड़ी सीमाएं
वेपॉइंट ऑप्टिमाइज़ेशन का इस्तेमाल करने के लिए, आपको इस्तेमाल से जुड़ी इन सीमाओं और शर्तों का पालन करना होगा:
अपने रास्ते पर मौजूद इंटरमीडिएट वेपॉइंट के लिए, इस्तेमाल की सीमा तय की जा सकती है:
- सिर्फ़ अक्षांश और देशांतर निर्देशांकों का इस्तेमाल करके, ज़्यादा से ज़्यादा 98 वेपॉइंट.
- जगह के आईडी का इस्तेमाल करके, बीच में रुकने की जगहों की जानकारी देने पर, ज़्यादा से ज़्यादा 25 जगहों की जानकारी दी जा सकती है.
आपके सभी वेपॉइंट, स्टॉपओवर टाइप के होने चाहिए. आपके किसी भी वेपॉइंट का टाइप वाया नहीं होना चाहिए.
आपको फ़ील्ड मास्क में
routes.optimizedIntermediateWaypointIndexजोड़ना होगा.अगर आपके अनुरोध में 25 या इससे ज़्यादा इंटरमीडिएट वेपॉइंट हैं, तो यह ज़रूरी है कि वह इन शर्तों का भी पालन करे:
सभी वेपॉइंट के बीच की कुल दूरी 1,000 कि॰मी॰ से कम होनी चाहिए. इस दूरी में, यात्रा शुरू करने की जगह और मंज़िल, दोनों शामिल हैं.
यात्रा का मोड DRIVE होना चाहिए.