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

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

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

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

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

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

निर्देशों एपीआई की मदद से, आप जगहों के बीच दिशा-निर्देशों की गणना कर सकते हैं, जिसमें नीचे दिए गए ब्यौरे भी शामिल हैं:

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

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

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

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

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

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

रिसॉर्स

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

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

निर्देश API का इस्तेमाल कैसे करें

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

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

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

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

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

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