निर्देश API की खास जानकारी

दिशा-निर्देश API की खास जानकारी

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

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

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

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

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

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

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

दिशा-निर्देश API, दिशा-निर्देशों का हिसाब लगाते समय सबसे कारगर रास्ते दिखाता है. सबसे सही रास्ता तय करते समय, प्रॉडक्ट की इन बातों में यात्रा से जुड़े एलिमेंट शामिल होते हैं:

यात्रा में लगने वाला समय (मुख्य)
दूरी
टर्न की संख्या

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

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

संसाधन

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

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

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

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

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

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

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

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

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