Directions API (लेगसी) के बारे में खास जानकारी

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

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

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 Client, Python Client, Go Client, और Node.js Client, कम्यूनिटी की ओर से सपोर्ट की जाने वाली क्लाइंट लाइब्रेरी हैं. इन्हें Apache 2.0 License के तहत ओपन सोर्स किया गया है. इन्हें GitHub से डाउनलोड करें. यहां आपको इंस्टॉलेशन के निर्देश और सैंपल कोड भी मिल सकता है.

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