Directions 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 का डेमो आज़माया जा सकता है. Directions API (लेगसी) का डेमो देखें.
3 अनुरोध बनाना अनुरोधों के उदाहरण देखें और उपलब्ध विकल्पों के बारे में जानें. जैसे, यात्रा के मोड, वेपॉइंट, और रास्ते से जुड़ी पाबंदियां. निर्देशों के उदाहरण देखें.
4 जवाबों से जुड़ी बुनियादी बातें समझना अपने ऐप्लिकेशन के लिए, दिशा-निर्देशों से जुड़े डेटा का इस्तेमाल करने के लिए, डेटा रिस्पॉन्स एक्सप्लोर करें. ज़्यादा जानकारी के लिए, दिशा-निर्देशों से जुड़े रिस्पॉन्स देखें.
5 अपने ऐप्लिकेशन में दिशा-निर्देशों का डेटा शामिल करें! इस डेटा का इस्तेमाल करके, यात्रा की दूरी और समय का हिसाब लगाया जा सकता है.

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

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

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

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