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