वेपॉइंट ऑप्टिमाइज़ेशन, रूट के लिए पसंदीदा सुविधा है, जो 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"}
रिस्पॉन्स का उदाहरण
रिस्पॉन्स के मुख्य हिस्से के रूट ऑब्जेक्ट में, optimizedIntermediateWaypointIndex
फ़ील्ड में इंटरमीडिएट वेपॉइंट इंडेक्स का क्रम बदला जा सकता है. कोड में बदली गई पॉलीलाइन, निर्देशों एपीआई और 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 कि॰मी॰ से कम होनी चाहिए. इस दूरी में शुरुआत की जगह और मंज़िल, दोनों शामिल हैं.
यात्रा का मोड 'डिस्क' होना चाहिए.