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

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