कम दूरी का रास्ता पाना

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

कम दूरी वाले रास्तों की सुविधा चालू करने पर, Compute Routes API, कम दूरी के हिसाब से ऑप्टिमाइज़ किए गए ड्राइविंग रूट दिखा सकता है.

कम दूरी वाले रास्ते का अनुरोध करने पर, सेवा यह जानकारी दिखाती है:

  • डिफ़ॉल्ट रूट, जिसे मुख्य रूप से पहुंचने के अनुमानित समय के लिए ऑप्टिमाइज़ किया जाता है.
  • छोटा रास्ता, जिसे पूरी यात्रा के दौरान तय की जाने वाली दूरी को कम करने के लिए ऑप्टिमाइज़ किया गया हो.

यह क्या है और इसका इस्तेमाल क्यों करना चाहिए

कम दूरी वाले रास्ते में, ड्राइविंग के दौरान मिलने वाली सुविधा या स्पीड के बजाय दूरी को प्राथमिकता दी जाती है. उदाहरण के लिए, यह हाइवे के बजाय स्थानीय सड़कों को प्राथमिकता दे सकता है, कच्ची सड़कों पर चल सकता है या पार्किंग लॉट से होकर जा सकता है. यह ऐसे किसी भी तरीके के बारे में जानकारी नहीं देता जिसे Google Maps गैर-कानूनी मानता है.

कम दूरी वाले रास्ते का अनुरोध करना

आपका अनुरोध इन शर्तों के मुताबिक होना चाहिए:

  • travelMode को DRIVE, BICYCLE या TWO_WHEELER पर सेट करें.
  • requestedReferenceRoutes को SHORTER_DISTANCE पर सेट करें.
  • कम दूरी वाले रास्ते से जुड़ी रिस्पॉन्स प्रॉपर्टी पाने के लिए, रिस्पॉन्स फ़ील्ड मास्क सेट करें:
    • routes.routeLabels: हर रास्ते को DEFAULT_ROUTE, SHORTER_DISTANCE या DEFAULT_ROUTE_ALTERNATE के तौर पर पहचानता है.
    • routes.routeToken: यह एक रूट टोकन है. इसे Navigation SDK को पास किया जा सकता है, ताकि कस्टम रूट वापस पाया जा सके.
  • Via इंटरमीडिएट वेपॉइंट शामिल न करें.
  • optimizeWaypointOrder पैरामीटर को शामिल न करें.
  • ज़रूरी नहीं: जवाब के लिए फ़ील्ड मास्क सेट करें, ताकि डिफ़ॉल्ट और कम दूरी वाले दोनों रास्तों से जुड़ी ये प्रॉपर्टी वापस मिल सकें:
    • routes.distanceMeters: यह रास्ते की दूरी दिखाता है.
    • routes.duration: इससे रास्ते की अवधि मिलती है.

रेफ़रंस जानकारी के लिए, ReferenceRoute और RouteLabel देखें.

अनुरोध का उदाहरण: कम दूरी वाला रास्ता

यहां दिए गए कोड में, कम दूरी वाले रास्ते का अनुरोध दिखाया गया है. इस उदाहरण में, रिस्पॉन्स फ़ील्ड मास्क का इस्तेमाल करके, डिफ़ॉल्ट और कम दूरी वाले रास्ते से जुड़े फ़ील्ड दिखाए गए हैं. इसके लिए, इन फ़ील्ड मास्क का इस्तेमाल किया गया है:

  • routes.distanceMeters
  • routes.duration
curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 41.76904801292959,
        "longitude": -72.67374935684933
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 41.823042361105024,
        "longitude": -71.40933143059424
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE",
  "requestedReferenceRoutes": ["SHORTER_DISTANCE"],
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

कम दूरी वाले रास्ते के जवाब का उदाहरण

{
  "routes": [
    {
      "distanceMeters": 138943,
      "duration": "5373s",
      "routeToken": "CrsCCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXcklWWFo2cjhDZmltdk9NUDQ3aU1nUU0QBRpPCk0KGAoNCgIIAREAAAAAAIBmQBF56SYxqDm4QBISCAAQAxAGEBMQEhgCQgQaAggFIhsKF3JJVlhaLWFOQnZpbXZPTVA0N2lNZ1FNcAEoASIVAACBmRY1BjeCiUQewJGTrQ3DuHRp",
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 112610,
      "duration": "7165s",
      "routeToken": "CqgCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdySVZYWjZHR0RiTzV2T01QOUpiQXlBTRAFGk8KTQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhIIABADEAYQExASGAJCBBoCCAUiGwoXcklWWFo3S09Cck81dk9NUDlKYkF5QU1wASgCIhUAAIGZFlj_CmMgGE6KGZcsE-tEywM",
      "routeLabels": [
        "SHORTER_DISTANCE"
      ]
    }
  ]
}

अनुरोध का उदाहरण: कम दूरी और ईंधन की कम खपत वाला रास्ता

नीचे दिए गए कोड में, कम दूरी वाले रास्ते और ईंधन की कम खपत वाले रास्ते, दोनों के लिए अनुरोध दिखाया गया है.

`

 curl -X POST -d '{
"origin": {  "location": {  "latLng": {  "latitude": 41.76904801292959,
"longitude": -72.67374935684933  }  }  },  "destination": {  "location": {
"latLng": {  "latitude": 41.823042361105024,  "longitude": -71.40933143059424  }
 }  },  "travelMode":"DRIVE",  "routingPreference":"TRAFFIC_AWARE_OPTIMAL",
"requestedReferenceRoutes": ["SHORTER_DISTANCE", "FUEL_EFFICIENT"] }' 

-H 'Content-Type: application/json' 

-H 'X-Goog-Api-Key: YOUR_API_KEY' 

-H 'X-Goog-FieldMask:
routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' 

'https://routes.googleapis.com/directions/v2:computeRoutes'

जवाब का उदाहरण: कम दूरी और ईंधन की कम खपत वाला रास्ता

इस मामले में, कम दूरी वाला और ईंधन की सबसे कम खपत वाला रास्ता एक ही है. इसलिए, उस रास्ते की जानकारी दिखाई जाती है. साथ ही, दोनों तरह के रास्तों के लिए routeLabel शामिल किया जाता है.

{  "routes": [  {  "distanceMeters": 138943,  "duration": "5375s",
"routeToken":
"Cr8CCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXS1laWFo4T19JcWVCM2ZFUDFMbms4UXcQBRpTClEKGAoNCgIIAREAAAAAAIBmQBFOYhBYGTy4QBIWCAAQAxAGEBMQEhgCQgQaAggFSgIIASIbChdLWVpYWjlpV0g2ZUIzZkVQMUxuazhRd3ABKAEiFQAAgZkW4Df4cspNNJZWlMZuUUxLPQ",
 "routeLabels": [  "DEFAULT_ROUTE"  ]  },  {  "distanceMeters": 112610,
"duration": "7156s",  "routeToken":
"CqwCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdLWVpYWi1UNklfT055OVlQczhhcWlRSRAFGlMKUQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhYIABADEAYQExASGAJCBBoCCAVKAggBIhsKF0tZWlhaNERXSF9PTnk5WVBzOGFxaVFJcAEoAiIVAACBmRaESp2EJS5nmwiEF8KH15_f",
 "routeLabels": [  "FUEL_EFFICIENT",  "SHORTER_DISTANCE"  ]  }  ] }

इन देशों और इलाकों में मान्य है

कम दूरी वाले रास्ते, सभी देशों/इलाकों में उपलब्ध हैं.

बिलिंग

Google Maps Platform, एक्सपेरिमेंट के तौर पर उपलब्ध किसी सुविधा का इस्तेमाल करने के लिए अतिरिक्त शुल्क नहीं लेता. आपने जो अन्य पैरामीटर सेट किए हैं उनके आधार पर, एपीआई के इस्तेमाल के लिए आपसे शुल्क लिया जाएगा.

Routes API के लिए, बिलिंग के बारे में ज़्यादा जानें.