वेपॉइंट ऑप्टिमाइज़ेशन, रूट को पसंद आने वाली सुविधा है. यह सुविधा
ComputeRoutes
का दायरा बढ़ाती है.
यह किसी यात्री के रास्ते में इंटरमीडिएट वेपॉइंट के क्रम को ऑप्टिमाइज़ करता है, ताकि वह सबसे बेहतर रास्ते से यात्रा कर सके. वेपॉइंट ऑप्टिमाइज़ेशन को लागू करने पर, ComputeRoutes
की सुविधा इन यात्रा के मोड के साथ काम करती है:
- ड्राइविंग
- मोटर वाले दोपहिया वाहन
- साइकल
- पैदल घूमना
वेपॉइंट ऑप्टिमाइज़ेशन का इस्तेमाल क्यों करना चाहिए?
कोई ऐसा ऐप्लिकेशन बनाते समय जो उपयोगकर्ताओं को किसी मंज़िल के लिए कई वेपॉइंट पर गाइड करता है, यह ज़रूरी है कि यात्री सही क्रम में वेपॉइंट को पार करे. इससे यह पक्का हो जाता है कि यात्री कम से कम समय में हर जगह पहुंच जाए.
स्पेस कैसे काम करता है
डिफ़ॉल्ट रूप से, ComputeRoutes
अपने वेपॉइंट से रूट का हिसाब लगाता है. साथ ही, यह उसी क्रम में तय करता है जिसमें वे मूल रूप से दिए गए थे. इंटरमीडिएट वेपॉइंट को फिर से बेहतर क्रम में सेट करके, रास्ते को ऑप्टिमाइज़ करने के लिए ComputeRoutes
मिल सकता है.
अगर अनुरोध के मुख्य भाग में optimizeWaypointOrder
फ़ील्ड को true
पर सेट किया जाता है, तो आपको ऑप्टिमाइज़ किए गए वेपॉइंट वाला एक रूट मिलेगा.
ध्यान दें: वेपॉइंट ऑप्टिमाइज़ेशन का हिसाब मुख्य रूप से, यात्रा में लगने वाले समय पर आधारित होता है. लेकिन यह सुविधा अन्य फ़ैक्टर को भी ध्यान में रखती है, जैसे कि दूरी और टर्न की संख्या.
फिर से क्रम में लगाए गए वेपॉइंट पाएं
फिर से क्रम में लगाए गए वेपॉइंट वाला रूट पाने के लिए, बूलियन फ़ील्ड
optimizeWaypointOrder
को true
पर सेट करें. यह आपके अनुरोध के मुख्य भाग में
ComputeRoutes
पर सेट होगा. साथ ही, फ़ील्ड मास्क में 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"}
रिस्पॉन्स का उदाहरण
रिस्पॉन्स के मुख्य भाग के रूट ऑब्जेक्ट में मौजूद optimizedIntermediateWaypointIndex
फ़ील्ड में, क्रम से लगाए गए इंटरमीडिएट वेपॉइंट इंडेक्स देखे जा सकते हैं. कोड में बदली गई polyline, दिशा-निर्देश एपीआई और 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
अनुरोध के हेडर की वैल्यू को कम से कम 10 सेकंड पर सेट करके, कॉल के तरीके के लिए ज़्यादा टाइम आउट सेट करें. अगर आपको टाइम आउट की गड़बड़ियां लगातार मिल रही हैं, तो एक सेकंड बाद फिर से कोशिश करें.
इस्तेमाल करने की सीमाएं
वेपॉइंट ऑप्टिमाइज़ेशन का इस्तेमाल करने के लिए, आपको इस्तेमाल की इन सीमाओं और शर्तों का पालन करना होगा:
आप अपने रूट पर इंटरमीडिएट वेपॉइंट के लिए इस्तेमाल की सीमा तक तय कर सकते हैं:
- सिर्फ़ अक्षांश और देशांतर निर्देशांक का इस्तेमाल करके, 98 वेपॉइंट तक पहुंचा जा सकता है.
- अगर प्लेस आईडी का इस्तेमाल करके कोई वेपॉइंट तय किया जाता है, तो ज़्यादा से ज़्यादा 25 वेपॉइंट.
आपके सभी वेपॉइंट स्टॉपओवर टाइप के होने चाहिए. आपका कोई भी वेपॉइंट के ज़रिए अलग तरह का नहीं हो सकता.
आपको फ़ील्ड मास्क में
routes.optimizedIntermediateWaypointIndex
जोड़ना होगा.अगर आपके अनुरोध में 25 या उससे ज़्यादा इंटरमीडिएट वेपॉइंट हैं, तो उसे इन शर्तों का भी पालन करना होगा:
सभी वेपॉइंट के बीच सीधी रेखा की दूरी 1,000 कि॰मी॰ से कम होनी चाहिए. इस दूरी में शुरुआत की जगह और मंज़िल, दोनों शामिल हैं.
यात्रा मोड Drive होना चाहिए.