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 से डाउनलोड करें. यहां आपको इंस्टॉलेशन के निर्देश और सैंपल कोड भी मिल सकता है.

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