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