यह प्रॉडक्ट लेगसी स्टेटस में है. अक्टूबर 2026 से, Directions API (लेगसी) को नए Google Cloud प्रोजेक्ट के लिए चालू नहीं किया जा सकेगा. मौजूदा प्रोजेक्ट के लिए, सहायता जारी रहेगी. नई सुविधाओं और बेहतर परफ़ॉर्मेंस के लिए, Routes API पर माइग्रेट करें.

Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

निर्देशों के उदाहरण

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

यह प्रॉडक्ट लेगसी स्टेटस में है. अक्टूबर 2026 से, Directions API (लेगसी) को नए Google Cloud प्रोजेक्ट के लिए चालू नहीं किया जा सकेगा. मौजूदा प्रोजेक्ट पूरी तरह से काम करते रहेंगे. नई सुविधाओं और बेहतर परफ़ॉर्मेंस के लिए, Routes API पर माइग्रेट करें.

अनुरोधों के उदाहरण

नीचे दिए गए अनुरोध से, टोरंटो, ओंटारियो से मॉन्ट्रियल, क्यूबेक तक ड्राइविंग के लिए रास्ते के निर्देश मिलते हैं.

URL

https://maps.googleapis.com/maps/api/directions/json?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY'

mode और avoid पैरामीटर बदलकर, शुरुआती अनुरोध में बदलाव किया जा सकता है. इससे, साइकल से यात्रा के लिए ऐसे रास्ते की जानकारी मिलेगी जो हाईवे से होकर नहीं जाता और जहां से खूबसूरत नज़ारे दिखते हैं.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?avoid=highways
  &destination=Montreal
  &mode=bicycling
  &origin=Toronto
  &key=YOUR_API_KEYYOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&avoid=highways&mode=bicycling&key=YOUR_API_KEY'YOUR_API_KEY'

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

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Queens
  &mode=transit
  &origin=Brooklyn
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&keyYOUR_API_KEY'

बस, मेट्रो वगैरह के लिए किए गए इस अनुरोध में, रवानगी का समय शामिल है.

ध्यान दें: इस उदाहरण में, रवाना होने का समय 30 जुलाई, 2012 को सुबह 09:45 बजे बताया गया है. गड़बड़ी से बचने के लिए, अनुरोध सबमिट करने से पहले आपको पैरामीटर को आने वाले समय में बदलना होगा.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?departure_time=1343641500
  &destination=Queens
  &mode=transit
  &origin=Brooklyn
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&departure_time=1343641500&key=YOUR_API_KEY'

इस अनुरोध में, भारत के कोलकाता में H8MW+WP से GCG2+3M तक ड्राइविंग के लिए रास्ते के निर्देश पाने के लिए, Plus Codes का इस्तेमाल किया गया है.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=GCG2%2B3M%20Kolkata%20India
  &origin=H8MW%2BWP%20Kolkata%20India
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=H8MW%2BWP%20Kolkata%20India&destination=GCG2%2B3M%20Kolkata%20India&key=YOUR_API_KEY'

इस अनुरोध में, जगह के आईडी का इस्तेमाल करके, यूनाइटेड किंगडम के ग्लासगो से यूनाइटेड किंगडम के पर्थ तक ड्राइविंग के लिए रास्ते के निर्देश दिखाए गए हैं.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y
  &origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE
  &keyYOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE&destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y&key=YOUR_API_KEY'

यात्रा के मोड

निर्देशों का हिसाब लगाते समय, इस्तेमाल किए जाने वाले परिवहन के mode की जानकारी दी जा सकती है. डिफ़ॉल्ट रूप से, driving के हिसाब से निर्देश दिए जाते हैं. यात्रा के लिए ये मोड इस्तेमाल किए जा सकते हैं:

driving (डिफ़ॉल्ट) से पता चलता है कि सड़क नेटवर्क का इस्तेमाल करके, ड्राइविंग के लिए रास्ते के स्टैंडर्ड निर्देश दिए गए हैं.
walking, पैदल रास्ते की जानकारी पाने का अनुरोध करता है. इसमें पैदल चलने के लिए बने रास्ते और फ़ुटपाथ (जहां उपलब्ध हों) शामिल हैं.
bicycling, साइकल चलाने के लिए बने रास्तों और पसंदीदा सड़कों (जहां उपलब्ध हों) के ज़रिए, साइकल से यात्रा करने के लिए रास्ते के निर्देश पाने का अनुरोध करता है.
transit, बस, मेट्रो वगैरह के रास्तों के ज़रिए दिशा-निर्देश पाने का अनुरोध करता है. हालांकि, ऐसा सिर्फ़ उन जगहों के लिए किया जा सकता है जहां ये सुविधाएं उपलब्ध हैं. अगर मोड को transit पर सेट किया जाता है, तो आपके पास departure_time या arrival_time में से किसी एक को चुनने का विकल्प होता है. अगर दोनों में से कोई भी समय नहीं बताया गया है, तो departure_time डिफ़ॉल्ट रूप से अभी का समय सेट हो जाता है. इसका मतलब है कि रवानगी का समय डिफ़ॉल्ट रूप से मौजूदा समय पर सेट हो जाता है. आपके पास transit_mode और/या transit_routing_preference को शामिल करने का विकल्प भी होता है.

ध्यान दें: कभी-कभी पैदल चलने और साइकल से यात्रा करने के निर्देशों में, पैदल चलने वालों या साइकल से यात्रा करने वालों के लिए साफ़ तौर पर रास्ते नहीं दिखते. इसलिए, ये निर्देश नतीजे में warnings दिखाएंगे. आपको इसे उपयोगकर्ता को दिखाना होगा.

ट्रैफ़िक जानकारी

ट्रैफ़िक की जानकारी का इस्तेमाल तब किया जाता है, जब यहां दी गई सभी शर्तें लागू हों. रास्ते की जानकारी के रिस्पॉन्स में duration_in_traffic फ़ील्ड पाने के लिए, ये शर्तें ज़रूरी हैं:

travel mode पैरामीटर driving है या इसकी जानकारी नहीं दी गई है (driving, यात्रा का डिफ़ॉल्ट मोड है).
अनुरोध में मान्य departure_time पैरामीटर शामिल हो. departure_time को मौजूदा समय या आने वाले समय पर सेट किया जा सकता है. यह बीते हुए समय की नहीं हो सकती.
अनुरोध में स्टॉपओवर वेपॉइंट शामिल नहीं हैं. अगर अनुरोध में वेपॉइंट शामिल हैं, तो हर वेपॉइंट के आगे via: लगाएं. इससे रास्ते पर असर पड़ेगा, लेकिन स्टॉपओवर से बचा जा सकेगा. उदाहरण के लिए,
```
&waypoints=via:San Francisco|via:Mountain View|...
```

आपके पास अपने अनुरोध में traffic_model पैरामीटर को शामिल करने का विकल्प होता है. इससे, ट्रैफ़िक में लगने वाले समय का हिसाब लगाते समय, इस्तेमाल किए जाने वाले अनुमानों की जानकारी दी जा सकती है.

यहां दिया गया यूआरएल, बॉस्टन, एमए से कॉनकोर्ड, एमए तक की यात्रा के लिए, निर्देश पाने का अनुरोध शुरू करता है. यह यात्रा, चार्ल्सटाउन और लेक्सिंगटन से होकर गुज़रती है. अनुरोध में, रवाना होने का समय शामिल है. साथ ही, Directions के रिस्पॉन्स में duration_in_traffic फ़ील्ड को दिखाने के लिए सभी ज़रूरी शर्तें पूरी की गई हैं.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?departure_time=now
  &destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&departure_time=now&key=YOUR_API_KEY'

वे-पाइंट

Directions API (लेगसी) का इस्तेमाल करके रास्ते का हिसाब लगाते समय, वेपॉइंट तय किए जा सकते हैं. इससे आपको ऐसा रास्ता मिलेगा जिसमें बीच की जगहों पर रुकने या वहां से गुज़रने की जानकारी शामिल होगी. गाड़ी चलाने, पैदल चलने या साइकल चलाने के लिए रास्ते की जानकारी में वेपॉइंट जोड़े जा सकते हैं. हालांकि, बस, मेट्रो वगैरह के रास्ते के लिए निर्देश में वेपॉइंट नहीं जोड़े जा सकते.

`waypoints` पैरामीटर में जगहें बताएं.

एक या उससे ज़्यादा जगहों की जानकारी दी जा सकती है. इसके लिए, जगह के आईडी, पते या अक्षांश/देशांतर निर्देशांक का इस्तेमाल करें. साथ ही, पाइप वर्ण (| या %7C) का इस्तेमाल करके, उन्हें अलग-अलग करें. डिफ़ॉल्ट रूप से, Directions सेवा किसी रास्ते का हिसाब लगाने के लिए, वेपॉइंट का इस्तेमाल उसी क्रम में करती है जिस क्रम में वे दिए गए हैं. वेपॉइंट की वैल्यू को पार्स करने के लिए, जगह के आईडी, अक्षांश/देशांतर निर्देशांक, और फिर पते को प्राथमिकता दी जाती है.

अगर आपने जगह का आईडी पास किया है, तो आपको उससे पहले place_id: लगाना होगा. Geocoding API और Places API (इसमें किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा भी शामिल है) से, जगह के आईडी वापस पाए जा सकते हैं. किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा से मिले जगह के आईडी इस्तेमाल करने का उदाहरण देखने के लिए, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा और निर्देश देखें. जगह के आईडी के बारे में ज़्यादा जानने के लिए, जगह के आईडी की खास जानकारी देखें.
बेहतर और सटीक नतीजे पाने के लिए, जहां तक हो सके जगह के आईडी का इस्तेमाल करें. ये आईडी, अक्षांश/देशांतर वैल्यू पेयर की तरह यूनीक होते हैं. साथ ही, ये ऐक्सेस पॉइंट और ट्रैफ़िक वैरिएबल जैसे रूटिंग के लिए जियोकोडिंग के फ़ायदे देते हैं. किसी पते के उलट, आईडी को किसी जगह की जानकारी खोजने या उसके लिए इंटरमीडिएट अनुरोध करने की ज़रूरत नहीं होती. इसलिए, आईडी की परफ़ॉर्मेंस बेहतर होती है.
अगर अक्षांश/देशांतर के निर्देशांक पास किए जाते हैं, तो वैल्यू सीधे फ़्रंटएंड सर्वर पर जाती हैं. इससे जियोकोडिंग के बिना ही दिशा-निर्देशों का हिसाब लगाया जा सकता है. पॉइंट, सड़कों पर स्नैप किए जाते हैं. इसलिए, हो सकता है कि वे आपके ऐप्लिकेशन के लिए ज़रूरी सटीक जानकारी न दें. निर्देशांकों का इस्तेमाल तब करें, जब आपको भरोसा हो कि वैल्यू, उन पॉइंट के बारे में सही जानकारी देती हैं जिनकी ज़रूरत आपके ऐप्लिकेशन को रूटिंग के लिए होती है. इसके लिए, ऐक्सेस पॉइंट या जियोकोडिंग की अन्य जानकारी की ज़रूरत नहीं होती. पक्का करें कि अक्षांश और देशांतर की वैल्यू को स्पेस (%20) के बजाय, कॉमा (%2C) से अलग किया गया हो.
अगर आपने कोई पता पास किया है, तो Directions सेवा स्ट्रिंग को जियोकोड करेगी और उसे अक्षांश/देशांतर निर्देशांकों में बदल देगी, ताकि निर्देश का हिसाब लगाया जा सके. अगर पते की वैल्यू साफ़ तौर पर नहीं दी गई है, तो हो सकता है कि वैल्यू से मिलती-जुलती जगहों के पते खोजे जाएं, ताकि साफ़ तौर पर पता लगाया जा सके कि कौनसा पता सही है. उदाहरण के लिए, "1st Street", "1st street NE" या "1st St SE" के लिए पूरी वैल्यू या अधूरी वैल्यू हो सकती है. यह नतीजा, Geocoding API से मिले नतीजे से अलग हो सकता है. जगह के आईडी का इस्तेमाल करके, गलत जानकारी देने से बचा जा सकता है. रास्ते के अनुरोध के नतीजों से जुड़ी समस्या हल करना देखें.

इसके अलावा, एन्कोड की गई पॉलीलाइन एल्गोरिदम का इस्तेमाल करके, एन्कोड किए गए पॉइंट का सेट भी दिया जा सकता है. आपको पता चलेगा कि एन्कोड किया गया सेट, कई वेपॉइंट के लिए मददगार होता है. ऐसा इसलिए, क्योंकि यूआरएल काफ़ी छोटा होता है. सभी वेब सेवाओं के लिए, यूआरएल में ज़्यादा से ज़्यादा 16,384 वर्ण हो सकते हैं.

एन्कोड की गई पॉलीलाइन से पहले enc: और उसके बाद कोलन (:) लगाना ज़रूरी है. उदाहरण के लिए: waypoints=enc:gfo}EtohhU:.
पाइप वर्ण (|) से अलग करके, एन्कोड की गई कई पॉलीलाइन भी शामिल की जा सकती हैं. उदाहरण के लिए, waypoints=via:enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:| via:enc:udymA{~bxM:

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

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'

स्टॉपओवर और पास थ्रू पॉइंट की मदद से, रास्तों पर असर डालना

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

अगर आपको स्टॉपओवर जोड़े बिना, वेपॉइंट का इस्तेमाल करके रास्ते में बदलाव करना है, तो वेपॉइंट में प्रीफ़िक्स via: जोड़ें. जिन वेपॉइंट के पहले via: लगा होता है वे legs कलेक्शन में कोई एंट्री नहीं जोड़ते. हालांकि, वे यात्रा को वेपॉइंट से होकर ले जाते हैं.

यहां दिए गए यूआरएल में, पिछले अनुरोध में बदलाव किया गया है, ताकि यात्रा को लेक्सिंगटन से होकर गुज़ारा जा सके:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'

via: प्रीफ़िक्स का इस्तेमाल तब सबसे ज़्यादा असरदार होता है, जब उपयोगकर्ता मैप पर वेपॉइंट को खींचकर रूट बनाता है. इससे उपयोगकर्ता को यह देखने में मदद मिलती है कि आखिरी रास्ता रीयल-टाइम में कैसा दिखेगा. साथ ही, यह पक्का करने में मदद मिलती है कि वेपॉइंट ऐसी जगहों पर रखे जाएं जिन्हें Directions API (लेगसी) से ऐक्सेस किया जा सके.

चेतावनी: स्टॉपओवर से बचने के लिए, via: प्रीफ़िक्स का इस्तेमाल करने पर, आपको ऐसे निर्देश मिलते हैं जो वेपॉइंट की व्याख्या के हिसाब से सख्त होते हैं. इस वजह से, रास्ते में कई मोड़ आ सकते हैं. इसके अलावा, अगर Directions API (लेगसी) उस पॉइंट से रास्ते की जानकारी नहीं बना पाता है, तो रिस्पॉन्स स्टेटस कोड में ZERO_RESULTS दिख सकता है.

यहां दिए गए यूआरएल में, अक्षांश/देशांतर के निर्देशांकों का इस्तेमाल करके वेपॉइंट का अनुरोध किया गया है:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008&key=YOUR_API_KEY'

यहां कोड में बदली गई पॉलीलाइन का इस्तेमाल करके, वही अनुरोध किया गया है:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'

ध्यान दें कि via: स्पेसिफ़ायर को जगह के मॉडिफ़ायर के साथ आसानी से मिलाया जा सकता है. उदाहरण के लिए:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'

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

डिफ़ॉल्ट रूप से, निर्देश सेवा, दिए गए वेपॉइंट के क्रम के हिसाब से रास्ता तय करती है. इसके अलावा, waypoints पैरामीटर में पहले आर्ग्युमेंट के तौर पर optimize:true को पास किया जा सकता है. इससे, Directions सेवा को दिए गए रास्ते को ऑप्टिमाइज़ करने की अनुमति मिलती है. इसके लिए, वेपॉइंट को ज़्यादा बेहतर क्रम में फिर से व्यवस्थित किया जाता है. (यह ऑप्टिमाइज़ेशन, ट्रैवलिंग सेल्सपर्सन प्रॉब्लम का एक ऐप्लिकेशन है.) यात्रा में लगने वाला समय, सबसे अहम फ़ैक्टर है जिसे ऑप्टिमाइज़ किया जाता है. हालांकि, सबसे सही रास्ता तय करते समय, दूरी, टर्न की संख्या, और कई अन्य फ़ैक्टर को भी ध्यान में रखा जा सकता है. सभी वेपॉइंट, स्टॉपओवर होने चाहिए, ताकि Directions API उनके रास्ते को ऑप्टिमाइज़ कर सके.

अगर आपने निर्देश देने वाली सेवा को वेपॉइंट के क्रम को ऑप्टिमाइज़ करने का निर्देश दिया है, तो उनका क्रम routes ऑब्जेक्ट में मौजूद waypoint_order फ़ील्ड में दिखेगा. waypoint_order फ़ील्ड, शून्य पर आधारित वैल्यू दिखाता है.

नीचे दिए गए उदाहरण में, रूट ऑप्टिमाइज़ेशन का इस्तेमाल करके, दक्षिण ऑस्ट्रेलिया के एडिलेड से दक्षिण ऑस्ट्रेलिया के हर मुख्य वाइन क्षेत्र तक की सड़क यात्रा का हिसाब लगाया गया है.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Adelaide%2C%20SA
  &origin=Adelaide%2C%20SA
  &waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Adelaide%2C%20SA&destination=Adelaide%2C%20SA&waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA&key=YOUR_API_KEY'

कैलकुलेट किए गए रास्ते की जांच करने पर पता चलेगा कि कैलकुलेशन में, वेपॉइंट का इस्तेमाल इस क्रम में किया गया है:

"waypoint_order": [ 3, 2, 0, 1 ]

पाबंदियां

कुछ पाबंदियों के हिसाब से, रास्ते की जानकारी का हिसाब लगाया जा सकता है. पाबंदियों को दिखाने के लिए, avoid पैरामीटर का इस्तेमाल किया जाता है. साथ ही, उस पैरामीटर के लिए एक आर्ग्युमेंट का इस्तेमाल किया जाता है, जो पाबंदी से बचने के बारे में बताता है. इन पाबंदियों का इस्तेमाल किया जा सकता है:

avoid=tolls
avoid=highways
avoid=ferries

टोल, हाइवे, और फ़ेरी वाले रास्तों को शामिल न करने वाले रास्ते का अनुरोध किया जा सकता है. इसके लिए, avoid पैरामीटर में दोनों पाबंदियां पास करें. उदाहरण के लिए: avoid=tolls|highways|ferries.

ध्यान दें: पाबंदियां जोड़ने से, पाबंदी वाली सुविधा वाले रास्ते नहीं हटते. इससे, बेहतर रास्तों के नतीजे मिलते हैं.

यूनिट सिस्टम

निर्देशों के नतीजों में, distance फ़ील्ड में text शामिल होता है. इसे उपयोगकर्ता को दिखाया जा सकता है, ताकि रास्ते के किसी खास "चरण" की दूरी बताई जा सके. डिफ़ॉल्ट रूप से, इस टेक्स्ट में मूल देश या इलाके के यूनिट सिस्टम का इस्तेमाल किया जाता है.

उदाहरण के लिए, "शिकागो, आईएल" से "टोरंटो, ओएनटी" तक के रास्ते के नतीजे मील में दिखेंगे. वहीं, इसके उलट रास्ते के नतीजे किलोमीटर में दिखेंगे. अनुरोध के units पैरामीटर में, इनमें से कोई एक वैल्यू पास करके, इस यूनिट सिस्टम को बदला जा सकता है:

metric से पता चलता है कि मेट्रिक सिस्टम का इस्तेमाल किया जा रहा है. टेक्स्ट के तौर पर दूरी, किलोमीटर और मीटर में दिखाई जाती है.
imperial से पता चलता है कि इंपीरियल (इंग्लिश) सिस्टम का इस्तेमाल किया जा रहा है. टेक्स्ट के तौर पर दी गई दूरी, मील और फ़ुट में दिखाई जाती है.

ध्यान दें: इस यूनिट सिस्टम की सेटिंग का असर, सिर्फ़ distance फ़ील्ड में दिखने वाले text पर पड़ता है. distance फ़ील्ड में values भी शामिल होते हैं. इन्हें हमेशा मीटर में दिखाया जाता है.

इलाके के हिसाब से नतीजे दिखाना

region पैरामीटर का इस्तेमाल करके, निर्देश देने वाली सेवा को किसी खास इलाके के नतीजे दिखाने के लिए सेट किया जा सकता है. यह पैरामीटर, दो वर्णों वाले ccTLD (देश के कोड के हिसाब से टॉप लेवल डोमेन) आर्ग्युमेंट को लेता है. इससे इलाके के हिसाब से नतीजे दिखाने में मदद मिलती है. ज़्यादातर ccTLD कोड, ISO 3166-1 ऐल्फ़ा-2 कोड से मिलते-जुलते होते हैं. हालांकि, कुछ अपवाद भी होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि इसका आईएसओ 3166-1 कोड "gb" है. तकनीकी तौर पर, यह कोड "द यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन ऐंड नॉर्दर्न आयरलैंड" के लिए है. यह सुविधा किन देशों या इलाकों में उपलब्ध है, यह जानने के लिए Google Maps Platform की कवरेज की जानकारी देखें.

आपके पास ऐसे किसी भी डोमेन का इस्तेमाल करने का विकल्प है जिसमें Google Maps के मुख्य ऐप्लिकेशन ने ड्राइविंग के लिए रास्ते के निर्देश लॉन्च किए हैं.

उदाहरण के लिए, "टोलेडो" से "मैड्रिड" तक के रास्ते की जानकारी पाने के लिए, region को es पर सेट करने से सही नतीजे मिलते हैं. इसके बाद, "टोलेडो" को स्पेन के शहर के तौर पर समझा जाता है:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Madrid
  &origin=Toledo
  &region=es
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid®ion=es&key=YOUR_API_KEY'

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ8f21C60Lag0R_q11auhbf8Y",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 40.4165207, "lng": -3.7026134 },
            "southwest": { "lat": 39.862808, "lng": -4.029406799999999 },
          },
        "copyrights": "Map data ©2022 Inst. Geogr. Nacional",
        "legs":
          [
            {
              "distance": { "text": "74.3 km", "value": 74327 },
              "duration": { "text": "57 mins", "value": 3446 },
              "end_address": "Madrid, Spain",
              "end_location": { "lat": 40.4165207, "lng": -3.705076 },
              "start_address": "Toledo, Spain",
              "start_location": { "lat": 39.862808, "lng": -4.0273727 },
              "steps":
                [
                  {
                    "distance": { "text": "0.6 km", "value": 615 },
                    "duration": { "text": "2 mins", "value": 106 },
                    "end_location":
                      { "lat": 39.8681019, "lng": -4.029378299999999 },
                    "html_instructions": "Head <b>northwest</b> on <b>Av. de la Reconquista</b> toward <b>C. de la Diputación</b>",
                    "polyline":
                      {
                        "points": "quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC",
                      },
                    "start_location": { "lat": 39.862808, "lng": -4.0273727 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
          ],
        "overview_polyline":
          {
            "points": "quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)",
          },
        "summary": "A-42",
        "warnings": [],
        "waypoint_order": [],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>A-42</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>39.8628080</lat>
     <lng>-4.0273727</lng>
    </start_location>
    <end_location>
     <lat>39.8681019</lat>
     <lng>-4.0293783</lng>
    </end_location>
    <polyline>
     <points>quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC</points>
    </polyline>
    <duration>
     <value>106</value>
     <text>2 mins</text>
    </duration>
    <html_instructions>Head &lt;b&gt;northwest&lt;/b&gt; on &lt;b&gt;Av. de la Reconquista&lt;/b&gt; toward &lt;b&gt;C. de la Diputación&lt;/b&gt;</html_instructions>
    <distance>
     <value>615</value>
     <text>0.6 km</text>
    </distance>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>3446</value>
    <text>57 mins</text>
   </duration>
   <distance>
    <value>74327</value>
    <text>74.3 km</text>
   </distance>
   <start_location>
    <lat>39.8628080</lat>
    <lng>-4.0273727</lng>
   </start_location>
   <end_location>
    <lat>40.4165207</lat>
    <lng>-3.7050760</lng>
   </end_location>
   <start_address>Toledo, Spain</start_address>
   <end_address>Madrid, Spain</end_address>
  </leg>
  <copyrights>Map data ©2022 Inst. Geogr. Nacional</copyrights>
  <overview_polyline>
   <points>quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)</points>
  </overview_polyline>
  <bounds>
   <southwest>
    <lat>39.8628080</lat>
    <lng>-4.0294068</lng>
   </southwest>
   <northeast>
    <lat>40.4165207</lat>
    <lng>-3.7026134</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ8f21C60Lag0R_q11auhbf8Y</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

"टोलेडो" से "मैड्रिड" तक के रास्ते की जानकारी पाने के लिए, region पैरामीटर के बिना भेजा गया अनुरोध, नतीजे नहीं दिखाता. ऐसा इसलिए होता है, क्योंकि "टोलेडो" को स्पेन के बजाय, ओहायो के शहर के तौर पर समझा जाता है:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Madrid
  &origin=Toledo
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid&key=YOUR_API_KEY'

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJeU4e_C2HO4gRRcM6RZ_IPHw",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ",
        "types": ["locality", "political"],
      },
    ],
  "routes": [],
  "status": "ZERO_RESULTS",
}

XML

      
<DirectionsResponse>
 <status>ZERO_RESULTS</status>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJeU4e_C2HO4gRRcM6RZ_IPHw</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

जगह के आधार पर बिड मॉडिफ़ायर

लोकेशन मॉडिफ़ायर का इस्तेमाल करके, यह बताया जा सकता है कि ड्राइवर को किसी खास जगह पर कैसे पहुंचना चाहिए. इसके लिए, side_of_road पैरामीटर का इस्तेमाल करके यह बताएं कि सड़क के किस तरफ़ जाना है या यात्रा की सही दिशा बताने के लिए हेडिंग बताएं. इन मॉडिफ़ायर को बीच के वेपॉइंट के लिए, via: मॉडिफ़ायर के साथ आसानी से इस्तेमाल किया जा सकता है.

यह तय करना कि रास्ते, सड़क के किसी खास हिस्से से होकर गुज़रें

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

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=side_of_road%3A37.7663444%2C-122.4412006
  &origin=37.7680296%2C-122.4375126
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=37.7680296%2C-122.4375126&destination=side_of_road%3A37.7663444%2C-122.4412006&key=YOUR_API_KEY'

एन्कोड की गई पॉलीलाइन के साथ side_of_road: का इस्तेमाल करने पर, पैरामीटर को पॉलीलाइन की हर जगह पर लागू किया जाता है.

side_of_road: मॉडिफ़ायर का इस्तेमाल, सिर्फ़ इन पाबंदियों के साथ किया जा सकता है:

travel mode पैरामीटर driving है या इसकी जानकारी नहीं दी गई है (driving, यात्रा का डिफ़ॉल्ट मोड है).

यह तय करना कि रास्तों में कोई खास हेडिंग होनी चाहिए

वेपॉइंट तय करते समय, यह अनुरोध किया जा सकता है कि रास्ता किसी खास दिशा में वेपॉइंट से होकर गुज़रे. इस हेडिंग को प्रीफ़िक्स heading=X: के साथ तय किया जाता है. इसमें X, 0 (शामिल है) और 360 (शामिल नहीं है) के बीच की कोई पूर्णांक डिग्री वैल्यू होती है. 0 का मतलब उत्तर दिशा है, 90 का मतलब पूर्व दिशा है. इसी तरह, घड़ी की सुई की दिशा में आगे बढ़ते हुए अन्य दिशाओं का पता चलता है. उदाहरण के लिए, दिशा-निर्देशों के इस अनुरोध में, रास्ता ऑरिजिन से पूर्व की ओर जाता है और फिर यू-टर्न लेता है:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=37.773245%2C-122.469502
  &origin=heading%3D90%3A37.773279%2C-122.468780
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=heading%3D90%3A37.773279%2C-122.468780&destination=37.773245%2C-122.469502&key=YOUR_API_KEY'

heading=X: मॉडिफ़ायर का इस्तेमाल सिर्फ़ इन पाबंदियों के साथ किया जा सकता है:

travel mode पैरामीटर की वैल्यू driving, bicycling या तय नहीं है (driving, यात्रा का डिफ़ॉल्ट मोड है).
side_of_road मॉडिफ़ायर को उसी जगह के लिए तय नहीं किया गया है.
जगह की जानकारी, अक्षांश/देशांतर की वैल्यू से दी जाती है. heading का इस्तेमाल पतों, जगह के आईडी या एन्कोड की गई पॉलीलाइन के साथ नहीं किया जा सकता.

अनुरोधों के उदाहरण

URL

curl

URL

curl

URL

curl

URL

curl

URL

curl

URL

curl

यात्रा के मोड

ट्रैफ़िक जानकारी

URL

curl

वे-पाइंट

waypoints पैरामीटर में जगहें बताएं.

URL

curl

स्टॉपओवर और पास थ्रू पॉइंट की मदद से, रास्तों पर असर डालना

URL

curl

URL

curl

URL

curl

URL

curl

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

URL

curl

पाबंदियां

यूनिट सिस्टम

इलाके के हिसाब से नतीजे दिखाना

URL

curl

JSON

XML

URL

curl

JSON

XML

जगह के आधार पर बिड मॉडिफ़ायर

यह तय करना कि रास्ते, सड़क के किसी खास हिस्से से होकर गुज़रें

URL

curl

यह तय करना कि रास्तों में कोई खास हेडिंग होनी चाहिए

URL

curl

`waypoints` पैरामीटर में जगहें बताएं.