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

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

Directions API का इस्तेमाल क्यों करना चाहिए

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

Directions API की मदद से क्या-क्या किया जा सकता है?

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

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

Directions API के काम करने का तरीका

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

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

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

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

संसाधन

नीचे दी गई टेबल में, Directions API से मिलने वाले डेटा के साथ-साथ, इससे मिलने वाले संसाधनों के बारे में खास जानकारी दी गई है.

डेटा संसाधन मिला डेटा रिटर्न का फ़ॉर्मैट
रास्ता

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

ज़्यादा जानकारी वाले निर्देश, जिन्हें रूट, लेग, और चरणों में बांटा गया है. ज़्यादा जानकारी के लिए, निर्देश के जवाब देखें.
  • JSON
  • XML

Directions API का इस्तेमाल करने का तरीका

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

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

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

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

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