यह प्रॉडक्ट लेगसी स्टेटस में है. अक्टूबर 2026 से, Directions API (लेगसी) को नए Google Cloud प्रोजेक्ट के लिए चालू नहीं किया जा सकेगा. मौजूदा प्रोजेक्ट पूरी तरह से काम करते रहेंगे. नई सुविधाओं और बेहतर परफ़ॉर्मेंस के लिए, Routes API पर माइग्रेट करें.
जवाब के उदाहरण
निर्देशों के जवाब, यूआरएल अनुरोध पाथ में output फ़्लैग से बताए गए फ़ॉर्मैट में दिखाए जाते हैं.
यहां एचटीटीपी अनुरोध का एक सैंपल दिया गया है. इसमें शिकागो, इलिनॉय से लॉस एंजेलिस, कैलिफ़ोर्निया तक का रास्ता कैलकुलेट किया गया है. इस रास्ते में, जॉप्लिन, मिसौरी और ओक्लाहोमा सिटी, ओक्लाहोमा, ये दो वेपॉइंट शामिल हैं.
URL
https://maps.googleapis.com/maps/api/directions/json ?destination=Los%20Angeles%2C%20CA &origin=Chicago%2C%20IL &waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Chicago%2C%20IL&destination=Los%20Angeles%2C%20CA&waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK&key=YOUR_API_KEY'
ऊपर दिए गए उदाहरण में, JSON आउटपुट का अनुरोध किया गया है. एक्सएमएल आउटपुट का अनुरोध भी किया जा सकता है. JSON और एक्सएमएल रिस्पॉन्स के सैंपल देखने के लिए, यहां दिए गए टैब चुनें.
JSON
{ "geocoded_waypoints": [ { "geocoder_status": "OK", "place_id": "ChIJ7cv00DwsDogRAMDACa2m4K8", "types": ["locality", "political"], }, { "geocoder_status": "OK", "place_id": "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg", "types": ["locality", "political"], }, { "geocoder_status": "OK", "place_id": "ChIJgdL4flSKrYcRnTpP0XQSojM", "types": ["locality", "political"], }, { "geocoder_status": "OK", "place_id": "ChIJE9on3F3HwoAR9AhGJW_fL-I", "types": ["locality", "political"], }, ], "routes": [ { "bounds": { "northeast": { "lat": 41.8781139, "lng": -87.6297872 }, "southwest": { "lat": 34.0523525, "lng": -118.2435717 }, }, "copyrights": "Map data ©2022 Google, INEGI", "legs": [ { "distance": { "text": "579 mi", "value": 932311 }, "duration": { "text": "8 hours 48 mins", "value": 31653 }, "end_address": "Joplin, MO, USA", "end_location": { "lat": 37.0842449, "lng": -94.513284 }, "start_address": "Chicago, IL, USA", "start_location": { "lat": 41.8781139, "lng": -87.6297872 }, "steps": [ { "distance": { "text": "443 ft", "value": 135 }, "duration": { "text": "1 min", "value": 24 }, "end_location": { "lat": 41.8769003, "lng": -87.6297353 }, "html_instructions": "Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b>", "polyline": { "points": "eir~FdezuOdCEjBC" }, "start_location": { "lat": 41.8781139, "lng": -87.6297872 }, "travel_mode": "DRIVING", }, { "distance": { "text": "269 ft", "value": 82 }, "duration": { "text": "1 min", "value": 20 }, "end_location": { "lat": 41.8768866, "lng": -87.63073 }, "html_instructions": "Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b>", "maneuver": "turn-right", "polyline": { "points": "sar~FzdzuO@fC?|@" }, "start_location": { "lat": 41.8769003, "lng": -87.6297353 }, "travel_mode": "DRIVING", }, // Additional steps omitted for brevity ], "traffic_speed_entry": [], "via_waypoint": [], }, // Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity ], "overview_polyline": { "points": "eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)", }, "summary": "I-55 S and I-44", "warnings": [], "waypoint_order": [0, 1], }, ], "status": "OK", }
XML
<DirectionsResponse> <status>OK</status> <route> <summary>I-55 S and I-44</summary> <leg> <step> <travel_mode>DRIVING</travel_mode> <start_location> <lat>41.8781139</lat> <lng>-87.6297872</lng> </start_location> <end_location> <lat>41.8769003</lat> <lng>-87.6297353</lng> </end_location> <polyline> <points>eir~FdezuOdCEjBC</points> </polyline> <duration> <value>24</value> <text>1 min</text> </duration> <html_instructions>Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b></html_instructions> <distance> <value>135</value> <text>443 ft</text> </distance> </step> <step> <travel_mode>DRIVING</travel_mode> <start_location> <lat>41.8769003</lat> <lng>-87.6297353</lng> </start_location> <end_location> <lat>41.8768866</lat> <lng>-87.6307300</lng> </end_location> <polyline> <points>sar~FzdzuO@fC?|@</points> </polyline> <duration> <value>20</value> <text>1 min</text> </duration> <html_instructions>Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b></html_instructions> <distance> <value>82</value> <text>269 ft</text> </distance> <maneuver>turn-right</maneuver> </step> <!-- Additional steps omitted for brevity --> <duration> <value>31653</value> <text>8 hours 48 mins</text> </duration> <distance> <value>932311</value> <text>579 mi</text> </distance> <start_location> <lat>41.8781139</lat> <lng>-87.6297872</lng> </start_location> <end_location> <lat>37.0842449</lat> <lng>-94.5132840</lng> </end_location> <start_address>Chicago, IL, USA</start_address> <end_address>Joplin, MO, USA</end_address> </leg> <!-- Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity --> <copyrights>Map data ©2022 Google, INEGI</copyrights> <overview_polyline> <points>eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)</points> </overview_polyline> <waypoint_index>0</waypoint_index> <waypoint_index>1</waypoint_index> <bounds> <southwest> <lat>34.0523525</lat> <lng>-118.2435717</lng> </southwest> <northeast> <lat>41.8781139</lat> <lng>-87.6297872</lng> </northeast> </bounds> </route> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJ7cv00DwsDogRAMDACa2m4K8</place_id> </geocoded_waypoint> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJ69Pk6jdlyIcRDqM1KDY3Fpg</place_id> </geocoded_waypoint> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJgdL4flSKrYcRnTpP0XQSojM</place_id> </geocoded_waypoint> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJE9on3F3HwoAR9AhGJW_fL-I</place_id> </geocoded_waypoint> </DirectionsResponse>
इस दस्तावेज़ के बाकी हिस्से में, JSON सिंटैक्स का इस्तेमाल किया जाएगा. ज़्यादातर मामलों में, दस्तावेज़ में कॉन्सेप्ट या फ़ील्ड के नाम समझाने के लिए, आउटपुट फ़ॉर्मैट से कोई फ़र्क़ नहीं पड़ता. हालांकि, इन बातों पर ध्यान दें छोटे-छोटे अंतर:
- एक्सएमएल के नतीजे, रूट
<DirectionsResponse>एलिमेंट में रैप किए जाते हैं. - JSON, एक से ज़्यादा एलिमेंट वाली एंट्री को प्लूरल कलेक्शन (जैसे,
stepsऔरlegs) के तौर पर दिखाता है. वहीं, एक्सएमएल इन्हें एक से ज़्यादा सिंगुलर एलिमेंट (जैसे,<step>और<leg>) के तौर पर दिखाता है. - JSON,
waypoint_orderफ़ील्ड के ज़रिए वेपॉइंट का क्रम दिखाता है. वहीं, एक्सएमएल, अलग-अलग<waypoint_index>एलिमेंट का इस्तेमाल करके इन्हें दिखाता है. - खाली एलिमेंट को JSON में खाली कलेक्शन से दिखाया जाता है. हालांकि, एक्सएमएल में ऐसे किसी एलिमेंट की मौजूदगी नहीं होती. उदाहरण के लिए, अगर किसी रिस्पॉन्स में कोई नतीजा जनरेट नहीं होता है, तो JSON में खाली
routesकलेक्शन दिखेगा. हालांकि, एक्सएमएल में कोई<route>एलिमेंट नहीं दिखेगा.
DirectionsResponse
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी है | Array<DirectionsRoute> |
इसमें यात्रा शुरू करने की जगह से मंज़िल तक पहुंचने के रास्तों का कलेक्शन होता है. रूट में नेस्ट किए गए लेग और स्टेप शामिल होते हैं. ज़्यादा जानकारी के लिए, DirectionsRoute देखें. |
|
ज़रूरी है | DirectionsStatus |
इसमें अनुरोध की स्थिति की जानकारी होती है. साथ ही, इसमें डीबग करने की जानकारी भी हो सकती है. इससे आपको यह पता लगाने में मदद मिलती है कि अनुरोध क्यों पूरा नहीं हुआ. ज़्यादा जानकारी के लिए, DirectionsStatus देखें. |
|
ज़रूरी नहीं | Array<TravelMode> |
इसमें यात्रा के उपलब्ध मोड का कलेक्शन शामिल होता है. यह फ़ील्ड तब दिखता है, जब किसी अनुरोध में यात्रा का मोड बताया जाता है और कोई नतीजा नहीं मिलता. इस कलेक्शन में, वे रास्ते शामिल होते हैं जो वेपॉइंट के दिए गए सेट के देशों में यात्रा के लिए उपलब्ध होते हैं. अगर एक या उससे ज़्यादा वेपॉइंट, 'वाया वेपॉइंट' हैं, तो यह फ़ील्ड नहीं दिखता. ज़्यादा जानकारी के लिए, TravelMode देखें. |
|
ज़रूरी नहीं | स्ट्रिंग |
जब सेवा, |
|
ज़रूरी नहीं | Array<DirectionsGeocodedWaypoint> |
इसमें ऑरिजिन, डेस्टिनेशन, और वेपॉइंट की जियोकोडिंग के बारे में जानकारी देने वाला कलेक्शन होता है. geocoded_waypoints कलेक्शन में मौजूद एलिमेंट, शून्य पर आधारित पोज़िशन के हिसाब से, शुरुआत की जगह, तय किए गए क्रम में वेपॉइंट, और मंज़िल से मेल खाते हैं. अगर सेवा कोई नतीजा नहीं दिखाती है, तो टेक्स्ट के तौर पर अक्षांश/देशांतर की वैल्यू के तौर पर बताए गए वेपॉइंट के लिए, यह जानकारी मौजूद नहीं होगी. ऐसा इसलिए होता है, क्योंकि रास्ता मिलने के बाद ही, ऐसे वेपॉइंट को रिवर्स जियोकोड किया जाता है, ताकि उनके पते की जानकारी मिल सके. एक खाली JSON ऑब्जेक्ट, geocoded_waypoints कलेक्शन में संबंधित जगहों पर मौजूद होगा. ज़्यादा जानकारी के लिए, DirectionsGeocodedWaypoint देखें. |
DirectionsRoute
रास्तों में नेस्ट किए गए legs और steps शामिल होते हैं.
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी है | Bounds |
इसमें ज़्यादा जानकारी के लिए, सीमाएं देखें. |
|
ज़रूरी है | स्ट्रिंग |
इसमें इस रास्ते के लिए दिखाए जाने वाले कॉपीराइट नोटिस शामिल होते हैं. आपको यह जानकारी खुद मैनेज करनी होगी और दिखानी होगी. इस कॉन्टेंट को इसी तरह पढ़ा जाना चाहिए. सिर्फ़ डिसप्ले के लिए बनाए गए इस कॉन्टेंट को प्रोग्राम के हिसाब से पार्स न करें. |
|
ज़रूरी है | Array<DirectionsLeg> |
एक ऐरे, जिसमें दिए गए रास्ते में मौजूद दो जगहों के बीच के रास्ते की जानकारी होती है. हर वेपॉइंट या मंज़िल के लिए, एक अलग लेग मौजूद होगा. (जिस रास्ते में कोई वेपॉइंट नहीं है उसमें legs कलेक्शन में सिर्फ़ एक लेग होगा.) हर लेग में कई चरण होते हैं. ज़्यादा जानकारी के लिए, DirectionsLeg देखें. |
|
ज़रूरी है | DirectionsPolyline |
इसमें एक ऐसा ऑब्जेक्ट होता है जिसमें रास्ते की एन्कोड की गई पॉलीलाइन होती है. यह पॉलीलाइन, नतीजों में मिले निर्देशों का अनुमानित (स्मूद) पाथ है. ज़्यादा जानकारी के लिए, DirectionsPolyline देखें. |
|
ज़रूरी है | स्ट्रिंग |
इसमें रास्ते के बारे में कम शब्दों में जानकारी होती है. इससे रास्ते को नाम देने और अन्य रास्तों से अलग करने में मदद मिलती है. |
|
ज़रूरी है | Array<string> |
इसमें चेतावनियों की एक कैटगरी होती है, जो इन निर्देशों को दिखाते समय दिखती है. आपको इन चेतावनियों को खुद मैनेज करना होगा और दिखाना होगा. |
|
ज़रूरी है | Array<integer> |
एक कलेक्शन, जो तय किए गए रास्ते में मौजूद किसी भी वेपॉइंट का क्रम दिखाता है. अगर अनुरोध को उसके वेपॉइंट पैरामीटर में optimize:true के तौर पर पास किया गया था, तो इन वेपॉइंट का क्रम बदला जा सकता है. |
|
ज़रूरी नहीं | किराया |
अगर यह मौजूद है, तो इसमें इस रूट का कुल किराया (यानी कि टिकट की कुल कीमत) शामिल होता है. यह प्रॉपर्टी सिर्फ़ बस, मेट्रो वगैरह के अनुरोधों के लिए और सिर्फ़ उन रास्तों के लिए दिखाई जाती है जहां बस, मेट्रो वगैरह के सभी लेग के लिए किराये की जानकारी उपलब्ध होती है. ज़्यादा जानकारी के लिए, किराया देखें. |
परिबंध
दक्षिण-पश्चिम और उत्तर-पूर्व कोनों के पॉइंट से भौगोलिक निर्देशांकों में बना एक रेक्टैंगल.
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी है | LatLngLiteral | ज़्यादा जानकारी के लिए, LatLngLiteral देखें. |
|
ज़रूरी है | LatLngLiteral | ज़्यादा जानकारी के लिए, LatLngLiteral देखें. |
LatLngLiteral
यह एक ऐसा ऑब्जेक्ट है जो दशमलव डिग्री में अक्षांश और देशांतर के साथ किसी खास जगह की जानकारी देता है.
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी है | संख्या |
दशमलव डिग्री में अक्षांश |
|
ज़रूरी है | संख्या |
दशमलव डिग्री में देशांतर |
DirectionsLeg
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी है | स्ट्रिंग |
इसमें रिवर्स जियोकोडिंग से मिला पता (आम तौर पर, मोहल्ले का पता) शामिल होता है. यह पता, यात्रा के इस चरण के |
|
ज़रूरी है | LatLngLiteral |
इस लेग के दिए गए डेस्टिनेशन के अक्षांश/देशांतर निर्देशांक. Directions API, शुरुआती और आखिरी पॉइंट पर परिवहन के सबसे नज़दीकी विकल्प (आम तौर पर सड़क) का इस्तेमाल करके, जगहों के बीच के निर्देशों का हिसाब लगाता है. इसलिए, अगर मंज़िल के पास कोई सड़क नहीं है, तो ज़्यादा जानकारी के लिए, LatLngLiteral देखें. |
|
ज़रूरी है | स्ट्रिंग |
इसमें, किसी व्यक्ति के लिए आसानी से पढ़ा जा सकने वाला पता (आम तौर पर, मोहल्ले का पता) शामिल होता है. यह पता, इस लेग के |
|
ज़रूरी है | LatLngLiteral |
इस लेग के ऑरिजिन के अक्षांश/देशांतर निर्देशांक. Directions API, शुरुआती और आखिरी जगहों पर परिवहन के सबसे नज़दीकी विकल्प (आम तौर पर सड़क) का इस्तेमाल करके, जगहों के बीच के निर्देशों का हिसाब लगाता है. इसलिए, हो सकता है कि ज़्यादा जानकारी के लिए, LatLngLiteral देखें. |
|
ज़रूरी है | Array<DirectionsStep> |
यात्रा के हर चरण की जानकारी देने वाले चरणों का कलेक्शन. ज़्यादा जानकारी के लिए, DirectionsStep देखें. |
|
ज़रूरी नहीं | Array<DirectionsTrafficSpeedEntry> |
रास्ते के किसी हिस्से में ट्रैफ़िक की रफ़्तार के बारे में जानकारी. ज़्यादा जानकारी के लिए, DirectionsTrafficSpeedEntry देखें. |
|
ज़रूरी है | Array<DirectionsViaWaypoint> |
इस लेग के दौरान, रास्ते में आने वाले वेपॉइंट की जगहें. ज़्यादा जानकारी के लिए, DirectionsViaWaypoint देखें. |
|
ज़रूरी नहीं | TimeZoneTextValueObject |
इसमें यात्रा के इस चरण के लिए, पहुंचने का अनुमानित समय शामिल होता है. यह प्रॉपर्टी सिर्फ़ बस, मेट्रो वगैरह के रास्ते के लिए निर्देश के लिए दिखाई जाती है. ज़्यादा जानकारी के लिए, TimeZoneTextValueObject देखें. |
|
ज़रूरी नहीं | TimeZoneTextValueObject |
इसमें इस लेग के लिए, रवानगी का अनुमानित समय शामिल होता है. इसे Time ऑब्जेक्ट के तौर पर दिखाया जाता है. ज़्यादा जानकारी के लिए, TimeZoneTextValueObject देखें. |
|
ज़रूरी नहीं | TextValueObject |
इस लेग में तय की गई कुल दूरी. ज़्यादा जानकारी के लिए, TextValueObject देखें. |
|
ज़रूरी नहीं | TextValueObject |
इस लेग की कुल अवधि. ज़्यादा जानकारी के लिए, TextValueObject देखें. |
|
ज़रूरी नहीं | TextValueObject |
इससे इस लेग की कुल अवधि का पता चलता है. यह वैल्यू, ट्रैफ़िक की मौजूदा और पुरानी स्थितियों के आधार पर, ट्रैफ़िक में लगने वाले समय का अनुमान है.
ज़्यादा जानकारी के लिए, TextValueObject देखें. |
DirectionsStep
स्टेप अरे का हर एलिमेंट, कैलकुलेट किए गए निर्देशों के एक चरण के बारे में बताता है. स्टेप, किसी रास्ते के निर्देश की सबसे छोटी यूनिट होती है. इसमें एक स्टेप होता है, जो यात्रा के दौरान किसी खास निर्देश के बारे में बताता है. उदाहरण के लिए, "W पर लेफ़्ट मुड़ें. फ़ोर्थ स्ट्रीट." इस चरण में न सिर्फ़ निर्देश की जानकारी होती है, बल्कि दूरी और समय की जानकारी भी होती है. इससे पता चलता है कि यह चरण, अगले चरण से कैसे जुड़ा है. उदाहरण के लिए, "I-80 वेस्ट पर मर्ज करें" के तौर पर बताए गए चरण में, "37 मील" और "40 मिनट" की अवधि शामिल हो सकती है. इससे पता चलता है कि अगला चरण, इस चरण से 37 मील/40 मिनट की दूरी पर है.
बस, मेट्रो वगैरह के रास्ते के लिए निर्देश खोजने के लिए, Directions API का इस्तेमाल करने पर, स्टेप्स कलेक्शन में transit_details कलेक्शन के तौर पर, बस, मेट्रो वगैरह की अतिरिक्त जानकारी शामिल होगी. अगर निर्देशों में यात्रा के एक से ज़्यादा साधन शामिल हैं, तो पैदल चलने या गाड़ी चलाने के लिए, इनर स्टेप अरे में ज़्यादा जानकारी दी जाएगी. उदाहरण के लिए, पैदल चलने के निर्देश में, शुरुआती और आखिरी जगह के निर्देश शामिल होंगे: "इनिस एवेन्यू और फ़िच स्ट्रीट तक पैदल चलें". उस चरण में, इनर स्टेप अरे में उस रास्ते के लिए पैदल रास्ते की जानकारी शामिल होगी. जैसे: "उत्तर-पश्चिम की ओर बढ़ें", "अरेलियस वॉकर पर बाएं मुड़ें", और "इनेस एवेन्यू पर बाएं मुड़ें".
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी है | TextValueObject |
इसमें, अगले चरण तक पहुंचने के लिए, इस चरण को पूरा करने में लगने वाला सामान्य समय शामिल होता है. अगर अवधि की जानकारी नहीं है, तो हो सकता है कि इस फ़ील्ड को तय न किया गया हो. ज़्यादा जानकारी के लिए, TextValueObject देखें. |
|
ज़रूरी है | LatLngLiteral |
इसमें इस चरण के आखिरी पॉइंट की जगह की जानकारी होती है. ज़्यादा जानकारी के लिए, LatLngLiteral देखें. |
|
ज़रूरी है | स्ट्रिंग |
इसमें इस चरण के लिए फ़ॉर्मैट किए गए निर्देश शामिल हैं. इन्हें एचटीएमएल टेक्स्ट स्ट्रिंग के तौर पर दिखाया जाता है. इस कॉन्टेंट को इसी तरह पढ़ा जाना चाहिए. सिर्फ़ डिसप्ले के लिए उपलब्ध इस कॉन्टेंट को प्रोग्राम के हिसाब से पार्स न करें. |
|
ज़रूरी है | DirectionsPolyline |
इसमें एक पॉइंट ऑब्जेक्ट होता है, जिसमें चरण को दिखाने वाली एन्कोड की गई पॉलीलाइन होती है. यह पॉलीलाइन, चरण का अनुमानित (स्मूद) पाथ है. ज़्यादा जानकारी के लिए, DirectionsPolyline देखें. |
|
ज़रूरी है | LatLngLiteral |
इसमें इस चरण के शुरुआती पॉइंट की जगह की जानकारी होती है. ज़्यादा जानकारी के लिए, LatLngLiteral देखें. |
|
ज़रूरी है | TravelMode |
इसमें यात्रा के लिए इस्तेमाल किए गए मोड की जानकारी होती है. ज़्यादा जानकारी के लिए, TravelMode देखें. |
|
ज़रूरी नहीं | TextValueObject |
इसमें, इस चरण से लेकर अगले चरण तक की दूरी शामिल होती है. अगर दूरी की जानकारी नहीं है, तो हो सकता है कि इस फ़ील्ड को तय न किया गया हो. ज़्यादा जानकारी के लिए, TextValueObject देखें. |
|
ज़रूरी नहीं | स्ट्रिंग |
इसमें, मौजूदा चरण के लिए की जाने वाली कार्रवाई (बाएं मुड़ें, मर्ज करें, सीधे जाएं वगैरह) शामिल होती है. वैल्यू में बदलाव हो सकता है. साथ ही, बिना किसी पहले से दिए गए नोटिस के नई वैल्यू जोड़ी जा सकती हैं.
The allowed values include:
turn-slight-left, turn-sharp-left,
turn-left, turn-slight-right, turn-sharp-right,
keep-right, keep-left, uturn-left,
uturn-right, turn-right, straight,
ramp-left, ramp-right, merge,
fork-left, fork-right, ferry,
ferry-train, roundabout-left, and
roundabout-right
|
|
ज़रूरी नहीं |
इसमें बस, मेट्रो वगैरह के रास्ते के लिए निर्देश में, पैदल चलने या ड्राइविंग के लिए सिलसिलेवार निर्देश शामिल होते हैं. सबस्टेप सिर्फ़ तब उपलब्ध होते हैं, जब travel_mode को "transit" पर सेट किया गया हो. इनर स्टेप अरे, स्टेप के टाइप का ही होता है. |
|
|
ज़रूरी नहीं | DirectionsTransitDetails |
अगर यात्रा का मोड ज़्यादा जानकारी के लिए, DirectionsTransitDetails देखें. |
TextValueObject
ऐसा ऑब्जेक्ट जिसमें कोई संख्या वाली वैल्यू और फ़ॉर्मैट किया गया टेक्स्ट शामिल हो.
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी है | स्ट्रिंग |
स्ट्रिंग वैल्यू. |
|
ज़रूरी है | संख्या |
संख्यात्मक मान. |
DirectionsPolyline
पॉलीलाइन एन्कोडिंग एक लॉसी कंप्रेशन एल्गोरिदम है. इसकी मदद से, निर्देशांकों की सीरीज़ को एक स्ट्रिंग के तौर पर सेव किया जा सकता है. पॉइंट के निर्देशांकों को साइन की गई वैल्यू का इस्तेमाल करके एन्कोड किया जाता है. अगर आपके पास सिर्फ़ कुछ स्टैटिक पॉइंट हैं, तो इंटरैक्टिव पॉलीलाइन एन्कोडिंग यूटिलिटी का भी इस्तेमाल किया जा सकता है.
एन्कोडिंग की प्रोसेस, बाइनरी वैल्यू को ASCII वर्णों के लिए वर्ण कोड की सीरीज़ में बदल देती है. इसके लिए, बेस64 एन्कोडिंग स्कीम का इस्तेमाल किया जाता है. इन वर्णों को सही तरीके से दिखाने के लिए, एन्कोड की गई वैल्यू को ASCII में बदलने से पहले, उनमें 63 (ASCII वर्ण '?') जोड़ दिया जाता है. एल्गोरिदम, हर बाइट ग्रुप की सबसे कम अहम बिट की जांच करके, किसी दिए गए पॉइंट के लिए अतिरिक्त वर्ण कोड की भी जांच करता है. अगर यह बिट 1 पर सेट है, तो इसका मतलब है कि पॉइंट अभी पूरी तरह से नहीं बना है और अतिरिक्त डेटा की ज़रूरत है.
इसके अलावा, जगह बचाने के लिए, पॉइंट में सिर्फ़ पिछले पॉइंट से ऑफ़सेट शामिल होता है. हालांकि, पहले पॉइंट के लिए ऐसा नहीं होता. सभी पॉइंट, Base64 में साइंड इंटीजर के तौर पर कोड में बदले जाते हैं. ऐसा इसलिए, क्योंकि अक्षांश और देशांतर, साइंड वैल्यू होते हैं. पॉलीलाइन में एन्कोडिंग फ़ॉर्मैट को दो निर्देशांकों को दिखाना चाहिए. ये निर्देशांक, अक्षांश और देशांतर को सटीक तरीके से दिखाते हैं. ज़्यादा से ज़्यादा +/- 180 डिग्री देशांतर के लिए, दशमलव के बाद पांच अंकों (180.00000 से -180.00000) तक की सटीक वैल्यू दी जा सकती है. इसके लिए, 32 बिट की साइंड बाइनरी इंटीजर वैल्यू की ज़रूरत होती है.
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी है | स्ट्रिंग |
पॉलीलाइन को दिखाने वाली सिंगल स्ट्रिंग. |
TravelMode
DRIVING(डिफ़ॉल्ट) से पता चलता है कि कैलकुलेशन के लिए रोड नेटवर्क का इस्तेमाल किया गया है.-
BICYCLING, साइकल चलाने के लिए बने रास्तों और पसंदीदा सड़कों (जहां उपलब्ध हों) का इस्तेमाल करके, साइकल से यात्रा करने के लिए अनुरोध करता है. TRANSITअनुरोधों के लिए, सार्वजनिक परिवहन के रास्तों का इस्तेमाल करके कैलकुलेशन की गई (जहां उपलब्ध हो).-
WALKING, पैदल चलने के लिए रास्ते और फ़ुटपाथ (जहां उपलब्ध हों) का इस्तेमाल करके, पैदल चलने के लिए अनुरोध करता है.
DirectionsTransitDetails
ऐसी अतिरिक्त जानकारी जो यात्रा के अन्य साधनों के लिए काम की नहीं है.
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी नहीं | DirectionsTransitStop |
बस, मेट्रो वगैरह का स्टॉप, जहां आपको पहुंचना है. ज़्यादा जानकारी के लिए, DirectionsTransitStop देखें. |
|
ज़रूरी नहीं | TimeZoneTextValueObject | ज़्यादा जानकारी के लिए, TimeZoneTextValueObject देखें. |
|
ज़रूरी नहीं | DirectionsTransitStop |
बस, मेट्रो वगैरह का स्टॉप, जहां से यात्रा शुरू होगी. ज़्यादा जानकारी के लिए, DirectionsTransitStop देखें. |
|
ज़रूरी नहीं | TimeZoneTextValueObject | ज़्यादा जानकारी के लिए, TimeZoneTextValueObject देखें. |
|
ज़रूरी नहीं | स्ट्रिंग |
इससे पता चलता है कि इस लाइन पर किस दिशा में यात्रा करनी है. यह जानकारी, वाहन पर या बस स्टॉप पर दी जाती है. आम तौर पर, यह टर्मिनल स्टेशन होगा. |
|
ज़रूरी नहीं | पूर्णांक |
इससे पता चलता है कि इस समय, एक ही स्टॉप से निकलने वाली बसों के बीच कितने सेकंड का अंतर हो सकता है. उदाहरण के लिए, |
|
ज़रूरी नहीं | DirectionsTransitLine |
इसमें इस चरण में इस्तेमाल की गई ट्रांज़िट लाइन की जानकारी होती है. ज़्यादा जानकारी के लिए, DirectionsTransitLine देखें. |
|
ज़रूरी नहीं | पूर्णांक |
बस के छूटने से लेकर पहुंचने तक के स्टॉप की संख्या. इसमें बस के पहुंचने का स्टॉप शामिल है, लेकिन बस के रवाना होने का स्टॉप शामिल नहीं है. उदाहरण के लिए, अगर आपको स्टॉप A से निकलकर, स्टॉप B और C से होते हुए स्टॉप D पर पहुंचना है, तो |
|
ज़रूरी नहीं | स्ट्रिंग |
शेड्यूल और साइन बोर्ड पर दिखने वाला टेक्स्ट, जिससे यात्रियों को बस, मेट्रो वगैरह की यात्रा की जानकारी मिलती है. टेक्स्ट से, सेवा के दिन की किसी यात्रा की खास तौर पर पहचान होनी चाहिए. उदाहरण के लिए, "538" एमट्रैक ट्रेन का |
DirectionsTransitStop
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी है | LatLngLiteral |
स्टॉप की जगह. ज़्यादा जानकारी के लिए, LatLngLiteral देखें. |
|
ज़रूरी है | स्ट्रिंग |
बस, मेट्रो वगैरह के स्टॉप का नाम. |
TimeZoneTextValueObject
एक ऑब्जेक्ट, जिसमें Unix epoch टाइम, टाइम ज़ोन, और फ़ॉर्मैट किया गया टेक्स्ट शामिल होता है.
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी है | स्ट्रिंग |
टाइम ज़ोन में स्ट्रिंग के तौर पर बताया गया समय. |
|
ज़रूरी है | स्ट्रिंग |
इसमें टाइम ज़ोन की जानकारी होती है. यह वैल्यू, टाइम ज़ोन का नाम होती है.इसे आईएएनए टाइम ज़ोन डेटाबेस में तय किया जाता है. उदाहरण के लिए, "America/New_York". |
|
ज़रूरी है | संख्या |
समय को Unix epoch टाइम या 1 जनवरी, 1970 यूटीसी की आधी रात के बाद से सेकंड के तौर पर बताया जाता है. |
DirectionsTransitLine
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी है | Array<DirectionsTransitAgency> |
इस ट्रांज़िट लाइन को ऑपरेट करने वाली ट्रांसपोर्ट एजेंसी (या एजेंसियां). ज़्यादा जानकारी के लिए, DirectionsTransitAgency देखें. |
|
ज़रूरी है | स्ट्रिंग |
इस ट्रांज़िट लाइन का पूरा नाम, जैसे कि "8 एवेन्यू लोकल". |
|
ज़रूरी नहीं | स्ट्रिंग |
इस लाइन के साइनेज में आम तौर पर इस्तेमाल किया जाने वाला रंग. |
|
ज़रूरी नहीं | स्ट्रिंग |
इसमें इस लाइन से जुड़े आइकॉन का यूआरएल शामिल होता है. |
|
ज़रूरी नहीं | स्ट्रिंग |
इस ट्रांज़िट लाइन का छोटा नाम. आम तौर पर, यह लाइन नंबर होता है, जैसे कि "M7" या "355". |
|
ज़रूरी नहीं | स्ट्रिंग |
इस लाइन के साइनेज में आम तौर पर इस्तेमाल किया जाने वाला रंग. |
|
ज़रूरी नहीं | स्ट्रिंग |
इसमें इस बस, मेट्रो वगैरह की लाइन का यूआरएल होता है. यह यूआरएल, ट्रांसपोर्ट एजेंसी उपलब्ध कराती है. |
|
ज़रूरी नहीं | DirectionsTransitVehicle |
इस ट्रांज़िट लाइन पर चलने वाले वाहन का टाइप. ज़्यादा जानकारी के लिए, DirectionsTransitVehicle देखें. |
DirectionsTransitAgency
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी नहीं | स्ट्रिंग |
इस ट्रांसपोर्ट एजेंसी का नाम. |
|
ज़रूरी नहीं | स्ट्रिंग |
ट्रांसपोर्ट एजेंसी का फ़ोन नंबर. |
|
ज़रूरी नहीं | स्ट्रिंग |
ट्रांसपोर्ट एजेंसी का यूआरएल. |
DirectionsTransitVehicle
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी है | स्ट्रिंग |
इस वाहन का नाम, कैपिटल लेटर में. |
|
ज़रूरी है | स्ट्रिंग |
इस्तेमाल किए गए वाहन का टाइप.
The allowed values include:
BUS, CABLE_CAR,
COMMUTER_TRAIN, FERRY, FUNICULAR,
GONDOLA_LIFT, HEAVY_RAIL, HIGH_SPEED_TRAIN,
INTERCITY_BUS, LONG_DISTANCE_TRAIN, METRO_RAIL,
MONORAIL, OTHER, RAIL, SHARE_TAXI,
SUBWAY, TRAM, and
TROLLEYBUS
|
|
ज़रूरी नहीं | स्ट्रिंग |
इसमें इस तरह के वाहन से जुड़े आइकॉन का यूआरएल शामिल होता है. |
|
ज़रूरी नहीं | स्ट्रिंग |
इसमें इस वाहन के टाइप से जुड़े आइकॉन का यूआरएल शामिल होता है. यह यूआरएल, स्थानीय परिवहन के साइनबोर्ड पर आधारित होता है. |
DirectionsTrafficSpeedEntry
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी है | संख्या |
रास्ते के साथ ऑफ़सेट (मीटर में), जहां तक स्पीड की यह कैटगरी मान्य है. |
|
ज़रूरी है | स्ट्रिंग |
रास्ते के इस हिस्से पर ट्रैफ़िक/स्पीड की मौजूदा स्थिति. |
DirectionsViaWaypoint
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी नहीं | LatLngLiteral |
वेपॉइंट की जगह. ज़्यादा जानकारी के लिए, LatLngLiteral देखें. |
|
ज़रूरी नहीं | पूर्णांक |
वेपॉइंट वाले चरण का इंडेक्स. |
|
ज़रूरी नहीं | संख्या |
स्टेप की पॉलीलाइन के साथ वेपॉइंट की पोज़िशन. इसे 0 से 1 के अनुपात के तौर पर दिखाया जाता है. |
किराया
रास्ते का कुल किराया.
{
"currency" : "USD",
"value" : 6,
"text" : "$6.00"
}
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी है | स्ट्रिंग |
ISO 4217 करंसी कोड, जो उस मुद्रा को दिखाता है जिसमें रकम को दिखाया गया है. |
|
ज़रूरी है | स्ट्रिंग |
किराये की कुल रकम, जिसे अनुरोध की गई भाषा में फ़ॉर्मैट किया गया है. |
|
ज़रूरी है | संख्या |
किराये की कुल रकम, बताई गई मुद्रा में. |
DirectionsStatus
Directions API के रिस्पॉन्स ऑब्जेक्ट में मौजूद स्टेटस फ़ील्ड में, अनुरोध का स्टेटस शामिल होता है. इसमें डीबग करने की जानकारी भी शामिल हो सकती है, ताकि आपको यह पता लगाने में मदद मिल सके कि Directions API की सेवा क्यों काम नहीं कर रही है. स्टेटस फ़ील्ड में ये वैल्यू हो सकती हैं:
OKसे पता चलता है कि जवाब में मान्य नतीजा शामिल है.-
NOT_FOUNDसे पता चलता है कि अनुरोध के ऑरिजिन, डेस्टिनेशन या वेपॉइंट में बताई गई कम से कम एक जगह को जियोकोड नहीं किया जा सका. -
ZERO_RESULTSसे पता चलता है कि यात्रा शुरू करने की जगह और मंज़िल के बीच कोई रास्ता नहीं मिला. -
MAX_WAYPOINTS_EXCEEDEDसे पता चलता है कि अनुरोध में बहुत ज़्यादा वेपॉइंट दिए गए थे. Directions API को वेब सेवा के तौर पर इस्तेमाल करने वाले ऐप्लिकेशन या Maps JavaScript API में निर्देश देने वाली सेवा के लिए, वेपॉइंट की ज़्यादा से ज़्यादा संख्या 25 हो सकती है. इसमें शुरुआती और आखिरी जगह शामिल नहीं है. -
MAX_ROUTE_LENGTH_EXCEEDEDसे पता चलता है कि अनुरोध किया गया रास्ता बहुत लंबा है और उसे प्रोसेस नहीं किया जा सकता. यह गड़बड़ी तब होती है, जब ज़्यादा जटिल निर्देश दिखाए जाते हैं. वेपॉइंट, टर्न या निर्देशों की संख्या कम करके देखें. -
INVALID_REQUESTसे पता चलता है कि किया गया अनुरोध अमान्य था. इस स्थिति की आम वजहों में, अमान्य पैरामीटर या पैरामीटर वैल्यू शामिल है. -
OVER_DAILY_LIMITका मतलब इनमें से कोई एक हो सकता है:- एपीआई पासकोड मौजूद नहीं है या अमान्य है.
- आपके खाते के लिए बिलिंग की सुविधा चालू नहीं की गई है.
- आपने इस्तेमाल की जो सीमा तय की थी वह पूरी हो गई है.
- पेमेंट का दिया गया तरीका अब मान्य नहीं है. उदाहरण के लिए, क्रेडिट कार्ड की समयसीमा खत्म हो गई है.
-
OVER_QUERY_LIMITसे पता चलता है कि सेवा को तय समयावधि में, आपके ऐप्लिकेशन से बहुत ज़्यादा अनुरोध मिले हैं. -
REQUEST_DENIEDसे पता चलता है कि सेवा ने आपके ऐप्लिकेशन को निर्देश देने वाली सेवा का इस्तेमाल करने की अनुमति नहीं दी. -
UNKNOWN_ERRORसे पता चलता है कि सर्वर की गड़बड़ी की वजह से, दिशा-निर्देशों का अनुरोध प्रोसेस नहीं किया जा सका. फिर से कोशिश करने पर, अनुरोध पूरा हो सकता है.
DirectionsGeocodedWaypoint
| फ़ील्ड | ज़रूरी है | टाइप | ब्यौरा |
|---|---|---|---|
|
ज़रूरी नहीं | स्ट्रिंग |
इससे जियोकोडिंग ऑपरेशन से मिलने वाले स्टेटस कोड का पता चलता है. इस फ़ील्ड में ये वैल्यू हो सकती हैं.
The allowed values include:
OK, and
ZERO_RESULTS
|
|
ज़रूरी नहीं |
इससे पता चलता है कि जियोकोडर को मूल अनुरोध के लिए एग्ज़ैक्ट मैच नहीं मिला. हालांकि, वह अनुरोध किए गए पते के कुछ हिस्से से मैच कर पाया. आपको मूल अनुरोध की जांच करनी चाहिए, ताकि यह पता चल सके कि उसमें गलत वर्तनी और/या अधूरा पता तो नहीं है. अधूरे मैच अक्सर उन मोहल्लों के पतों के लिए होते हैं जो अनुरोध में पास किए गए इलाके में मौजूद नहीं होते. जब कोई अनुरोध एक ही इलाके में दो या उससे ज़्यादा जगहों से मैच करता है, तो कुछ हद तक मैच होने वाले नतीजे भी दिखाए जा सकते हैं. उदाहरण के लिए, "21 Henr St, Bristol, UK" डालने पर, हेनरी स्ट्रीट और हेनरिएटा स्ट्रीट, दोनों के लिए कुछ हद तक मैच करने वाला नतीजा मिलेगा. ध्यान दें कि अगर किसी अनुरोध में पते के कॉम्पोनेंट की स्पेलिंग गलत है, तो जियोकोडिंग सेवा कोई दूसरा पता सुझा सकती है. इस तरह से ट्रिगर किए गए सुझावों को भी कुछ हद तक मैच के तौर पर मार्क किया जाएगा. |
|
|
ज़रूरी नहीं | स्ट्रिंग |
एक यूनीक आइडेंटिफ़ायर, जिसका इस्तेमाल Google के अन्य एपीआई के साथ किया जा सकता है. जगह के आईडी के बारे में खास जानकारी देखें. |
|
ज़रूरी नहीं | Array<string> |
इससे पता चलता है कि निर्देश कैलकुलेट करने के लिए, जियोकोडिंग के नतीजे में किस तरह के पते का इस्तेमाल किया गया है.
अगर टाइप की सूची खाली है, तो इसका मतलब है कि पते के उस कॉम्पोनेंट के लिए कोई टाइप मौजूद नहीं है. उदाहरण के लिए, फ़्रांस में ल्यू-डिट. |