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

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

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

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

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 दिखाएंगे. आपको इसे उपयोगकर्ता को दिखाना होगा.

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

ट्रैफ़िक की जानकारी का इस्तेमाल तब किया जाता है, जब यहां दी गई सभी शर्तें लागू हों. Directions के जवाब में 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 (इसमें किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा भी शामिल है) से, जगह के आईडी वापस पाए जा सकते हैं. किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा से, जगह के आईडी इस्तेमाल करने का उदाहरण देखने के लिए, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा और निर्देश देखें. जगह के आईडी के बारे में ज़्यादा जानने के लिए, जगह के आईडी की खास जानकारी देखें.
बेहतर और सटीक नतीजे पाने के लिए, जहां तक हो सके जगह के आईडी का इस्तेमाल करें. ये आईडी, अक्षांश/देशांतर वैल्यू पेयर की तरह यूनीक होते हैं. साथ ही, ये ऐक्सेस पॉइंट और ट्रैफ़िक वैरिएबल जैसे रूटिंग के लिए, जियोकोडिंग के फ़ायदे देते हैं. किसी पते के उलट, आईडी को किसी जगह की जानकारी खोजने या उसके लिए इंटरमीडिएट अनुरोध करने की ज़रूरत नहीं होती. इसलिए, परफ़ॉर्मेंस बेहतर होती है.
अगर अक्षांश/देशांतर निर्देशांक पास किए जाते हैं, तो वैल्यू सीधे फ़्रंटएंड सर्वर पर जाती हैं. इससे, जियोकोडिंग के बिना ही दिशा-निर्देशों का हिसाब लगाया जा सकता है. पॉइंट, सड़कों पर स्नैप किए जाते हैं. इसलिए, हो सकता है कि वे आपके ऐप्लिकेशन के लिए ज़रूरी सटीक जानकारी न दें. निर्देशांकों का इस्तेमाल तब करें, जब आपको पूरा भरोसा हो कि वैल्यू, उन जगहों की सटीक जानकारी देती हैं जिनकी ज़रूरत आपके ऐप्लिकेशन को रूटिंग के लिए होती है. भले ही, ऐक्सेस पॉइंट या जियोकोडिंग की अन्य जानकारी उपलब्ध हो या न हो. पक्का करें कि अक्षांश और देशांतर की वैल्यू को कॉमा (%2C) से अलग किया गया हो, न कि स्पेस (%20) से.
अगर कोई पता पास किया जाता है, तो 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 सेवा उनके रास्ते को ऑप्टिमाइज़ कर सके.

अगर आपने Directions service को वेपॉइंट के क्रम को ऑप्टिमाइज़ करने का निर्देश दिया है, तो उनका क्रम 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 पैरामीटर का इस्तेमाल करके, Directions सेवा को किसी खास इलाके के नतीजे दिखाने के लिए सेट किया जा सकता है. यह पैरामीटर, दो वर्णों वाले 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` पैरामीटर में जगहें बताएं.