निर्देश API की खास जानकारी

डायरेक्शन एपीआई ऐसी सेवा है जो एचटीटीपी अनुरोध को स्वीकार करती है और जगहों के बीच JSON या एक्सएमएल फ़ॉर्मैट वाले निर्देश दिखाती है.

Directions API का इस्तेमाल क्यों करना चाहिए

दिशा-निर्देश API से, आप परिवहन के कई साधनों के लिए दिशा निर्देश प्राप्त कर सकते हैं, जैसे बस, परिवहन, ड्राइविंग, पैदल या साइकिल.

Directions API की मदद से क्या किया जा सकता है?

दिशा-निर्देश API की मदद से, जगहों के बीच जाने के रास्तों का हिसाब लगाया जा सकता है. इसमें नीचे दी गई जानकारी शामिल है:

  • यात्रा के कई तरीकों के लिए निर्देश, जैसे कि बस, मेट्रो, ड्राइविंग, पैदल या साइकल से.
  • बीच में रुकने की जगहों की सीरीज़ का इस्तेमाल करके, अलग-अलग हिस्सों में दिए गए निर्देश.
  • ऑरिजिन, डेस्टिनेशन, और वेस्टपॉइंट की जानकारी कई तरीकों से दी जा सकती है. जैसे, टेक्स्ट स्ट्रिंग (उदाहरण के लिए, "मुंबई, भारत" या "दिल्ली, भारत"), प्लेस आईडी या अक्षांश/देशांतर निर्देशांक.

निर्देश एपीआई कैसे काम करता है

Directions API, निर्देशों का हिसाब लगाते समय सबसे कम खर्च वाले रास्ते दिखाता है. सबसे सही रास्ता तय करते समय, प्रॉडक्ट इन बातों का ध्यान रखता है:

  • यात्रा में लगने वाला समय (मुख्य)
  • दूरी
  • टर्न की संख्या

यहां दिए गए अनुरोध के उदाहरण में, JSON फ़ॉर्मैट में ओंटारियो के टोरंटो से क्यूबेक के मॉन्ट्रियल तक ड्राइविंग के निर्देश दिखाए गए हैं:

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

संसाधन

इस टेबल में, डायरेक्शन एपीआई के ज़रिए उपलब्ध संसाधनों की खास जानकारी दी गई है. साथ ही, इससे मिला डेटा भी बताया गया है.

डेटा रिसॉर्स डेटा वापस किया गया रिटर्न फ़ॉर्मैट
रास्ता

जगह के आईडी, पतों या अक्षांश/देशांतर के निर्देशांक के तौर पर, ऑरिजिन और डेस्टिनेशन की जानकारी दें. ज़्यादा जानकारी के लिए ज़रूरी पैरामीटर देखें.

ज़्यादा जानकारी वाले निर्देश, जिन्हें रूट, लेग, और चरणों में बांटा गया है. ज़्यादा जानकारी के लिए निर्देशों के जवाब देखें.
  • JSON
  • XML

Directions API का इस्तेमाल करने का तरीका

1 सेट अप करें. अपना Google Cloud प्रोजेक्ट सेट अप करें से शुरू करें और इसके बाद, सेट अप करने के निर्देशों का पालन करें.
2 डेमो देखें एपीआई पासकोड और क्लाउड प्रोजेक्ट हासिल करने के बाद, निर्देशों का डेमो बिना किसी शुल्क के आज़माया जा सकता है. निर्देशों के एपीआई का डेमो देखें.
3 अनुरोध करें अनुरोधों के उदाहरण देखें और उन उपलब्ध विकल्पों के बारे में जानें जो आप उपलब्ध करा सकते हैं. जैसे, यात्रा के मोड, वेपॉइंट, और रास्ते की पाबंदियां. रास्ते के निर्देश के उदाहरण देखें.
4 जवाब से जुड़ी बुनियादी बातें समझना अपने ऐप्लिकेशन के लिए दिशा-निर्देशों का डेटा इस्तेमाल करने के लिए, डेटा से मिले जवाबों को एक्सप्लोर करें. ज़्यादा जानकारी के लिए, निर्देशों के जवाब देखें.
5 अपने ऐप्लिकेशन में, निर्देश देने वाला डेटा शामिल करें! इस डेटा का इस्तेमाल, यात्रा की दूरी और समय का हिसाब लगाने के लिए किया जा सकता है.

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

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

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

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