इस पेज का अनुवाद Cloud Translation API से किया गया है.

निर्देश से जुड़ी एपीआई की खास जानकारी

निर्देशों एपीआई की खास जानकारी

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

निर्देश एपीआई का इस्तेमाल क्यों करें

दिशा-निर्देश API से, आपको यात्रा के कई साधनों के लिए निर्देश मिल सकते हैं. जैसे, बस, मेट्रो वगैरह से यात्रा, गाड़ी चलाना, पैदल चलना या साइकल चलाना.

दिशा-निर्देश एपीआई से आप क्या कर सकते हैं?

निर्देश API की मदद से, जगहों के बीच दिशा-निर्देशों की गिनती की जा सकती है. इसमें, नीचे दी गई जानकारी भी शामिल है:

परिवहन के कई साधनों के लिए दिशा-निर्देश, जिनमें शामिल हैं ट्रांज़िट, गाड़ी चलाना, पैदल चलना या साइकल चलाना.
वेपॉइंट की एक सीरीज़ का इस्तेमाल करके एक से ज़्यादा दिशा-निर्देशों का पालन करें.
ऑरिजिन, डेस्टिनेशन, और वेपॉइंट की जानकारी कई तरीकों से दी जा सकती है. इनमें टेक्स्ट स्ट्रिंग (उदाहरण के लिए, "शिकागो, IL" या "डारविन, एनटी, ऑस्ट्रेलिया") जगह के आईडी या अक्षांश/देशांतर कोऑर्डिनेट शामिल हैं.

निर्देश एपीआई कैसे काम करता है

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

यात्रा का समय (मुख्य)
दूरी
मोड़ों की संख्या

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

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

संसाधन

नीचे दी गई टेबल में, निर्देश एपीआई की मदद से उपलब्ध कराए गए रिसॉर्स के साथ-साथ, मिलने वाले डेटा की खास जानकारी भी दी गई है.

डेटा रिसॉर्स	डेटा वापस किया गया	वापस करने का फ़ॉर्मैट
निर्देश जगह के आईडी, पते या अक्षांश/देशांतर कोऑर्डिनेट के रूप में, ऑरिजिन और डेस्टिनेशन की जानकारी दें. ज़्यादा जानकारी के लिए, ज़रूरी पैरामीटर देखें.	रास्तों, पैरों, और कदमों के हिसाब से बंटी हुई निर्देशों की पूरी जानकारी. ज़्यादा जानकारी के लिए, निर्देशों के जवाब देखें.	JSON XML

निर्देश एपीआई इस्तेमाल करने का तरीका

1	सेट अप करें.	सबसे पहले अपना Google Cloud प्रोजेक्ट सेट अप करें और सेटअप से जुड़े निर्देशों का पालन करें.
2	डेमो आज़माएं	एपीआई पासकोड और क्लाउड प्रोजेक्ट ऐक्सेस करने के बाद, निर्देशों का डेमो बिना किसी शुल्क के आज़माएं. निर्देश API का डेमो देखें.
3	अनुरोध करें	अनुरोधों के उदाहरण देखें और उपलब्ध विकल्पों के बारे में जानें. जैसे, यात्रा के मोड, वेपॉइंट, और रास्तों की पाबंदियां. निर्देशों के उदाहरण देखें.
4	जवाबों से जुड़ी बुनियादी बातों को समझना	अपने ऐप्लिकेशन में निर्देशों के डेटा का इस्तेमाल करने के लिए, दिए गए डेटा के जवाबों को एक्सप्लोर करें. ज़्यादा जानकारी के लिए, निर्देशों के जवाब देखें.
5	अपने ऐप्लिकेशन में, निर्देश का डेटा शामिल करें!	यात्रा की दूरी और समय का हिसाब लगाने के लिए, इस डेटा का इस्तेमाल किया जा सकता है.

उपलब्ध क्लाइंट लाइब्रेरी

नीचे दी गई क्लाइंट लाइब्रेरी में से किसी एक के ज़रिए, इस एपीआई को अपनी पसंद की भाषा में कॉल करें:

Java Client, Python Client, Go Client, और 'Google Maps सेवाओं के लिए Node.js क्लाइंट', समुदाय के साथ काम करने वाली क्लाइंट लाइब्रेरी हैं. इन्हें Apache 2.0 लाइसेंस के तहत ओपन सोर्स किया जाता है. इन्हें GitHub से डाउनलोड करें. यहां आपको इंस्टॉल करने के निर्देश और सैंपल कोड भी मिल जाएंगे.

आगे क्या करना है

निर्देश एपीआई का इस्तेमाल शुरू करना: शुरू करें पर जाएं.
निर्देशों के अनुरोध करना शुरू करना: निर्देश पाएं पर जाएं.
सबसे सही तरीके अपनाएं: वेब सेवा के सबसे सही तरीके पर जाएं.