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

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