अपने रास्ते वेपॉइंट ऑप्टिमाइज़ करें

वेपॉइंट ऑप्टिमाइज़ेशन, 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 होना चाहिए.

सुझाया गया कॉन्टेंट