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

वेपॉइंट ऑप्टिमाइज़ेशन, 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"}

जवाब का उदाहरण

जवाब के मुख्य हिस्से में मौजूद रूट ऑब्जेक्ट के 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 वेपॉइंट.

  • आपके सभी वेपॉइंट, स्टॉपओवर टाइप के होने चाहिए. आपका कोई भी वेपॉइंट, via टाइप का नहीं हो सकता.

  • आपको फ़ील्ड मास्क में routes.optimizedIntermediateWaypointIndex जोड़ना होगा.

  • अगर आपके अनुरोध में 25 या उससे ज़्यादा इंटरमीडिएट वेपॉइंट हैं, तो उसे इन शर्तों का भी पालन करना होगा:

    • सभी वेपॉइंट के बीच की कुल सीधी दूरी 1,000 कि॰मी॰ से कम होनी चाहिए. इस दूरी में, यात्रा शुरू करने की जगह और मंज़िल, दोनों शामिल हैं.

    • यात्रा का मोड DRIVE होना चाहिए.

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