दूरी का मैट्रिक्स एपीआई की खास जानकारी

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

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

Distance Matrix API का इस्तेमाल करके, एक से ज़्यादा संभावित ऑरिजिन और डेस्टिनेशन के बीच सबसे बेहतर यात्रा के रास्ते तय किए जा सकते हैं. उदाहरण के लिए, कौनसे कर्मचारियों को नौकरी वाली साइटों पर भेजना है या किन गोदामों से पैकेज भेजने हैं.

Distance Matrix API की मदद से क्या-क्या किया जा सकता है

Distance Matrix API की मदद से, ऑरिजिन और डेस्टिनेशन के मैट्रिक्स के लिए, यात्रा की दूरी और समय की जानकारी दी जा सकती है. कई विकल्प दिए जा सकते हैं. जैसे, यात्रा का मोड, जैसे कि ड्राइविंग, साइकल चलाना, सार्वजनिक परिवहन या पैदल चलना. साथ ही, सार्वजनिक परिवहन के मोड, जैसे कि बस, मेट्रो, ट्रेन, ट्राम या रेल.

डिस्टेंस मैट्रिक्स एपीआई, शुरू और आखिरी पॉइंट के बीच सुझाए गए रास्ते के आधार पर जानकारी देता है. दूरी के इस तरह के डेटा का अनुरोध किया जा सकता है:

  • यात्रा के लिए चुने गए मोड की दूरी
  • दूरी, किलोमीटर या मील में
  • ट्रैफ़िक में यात्रा में लगने वाला अनुमानित समय

मैप पर और एपीआई रिस्पॉन्स में, ऑरिजिन और डेस्टिनेशन दिखाने वाला मैप

Distance Matrix API के काम करने का तरीका

Distance Matrix API, किसी भी संख्या में ऑरिजिन (शुरुआती पॉइंट) और डेस्टिनेशन का इस्तेमाल करता है. साथ ही, हर ऑरिजिन और अनुरोध किए गए सभी डेस्टिनेशन के बीच की दूरी और यात्रा का समय दिखाता है. यह अनुरोध में दिए गए पहले ऑरिजिन से शुरू होकर, अगले ऑरिजिन तक सिलसिलेवार तरीके से आगे बढ़ता है.

उदाहरण के लिए, अगर आपके अनुरोध में A और B को ऑरिजिन और C और D को डेस्टिनेशन के तौर पर बताया गया है, तो यह इस क्रम में दूरी और यात्रा का समय दिखाता है:

  • A से C
  • A से D
  • B to C
  • B से D

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

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=New%20York%20City%2C%20NY
  &origins=Washington%2C%20DC%7CBoston
  &units=imperial
  &key=YOUR_API_KEY

संसाधन

नीचे दी गई टेबल में, Distance Matrix API के ज़रिए उपलब्ध संसाधनों के साथ-साथ, उससे मिलने वाले डेटा की खास जानकारी दी गई है.

डेटा संसाधन डेटा वापस पाना रिटर्न का फ़ॉर्मैट
डिस्टेंस मैट्रिक्स

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

  • हर जगह से हर मंज़िल के बीच की दूरी और यात्रा में लगने वाला समय
  • अगर आपने ड्राइविंग मोड और जाने का समय बताया है, तो ट्रैफ़िक में लगने वाला समय
  • JSON
  • XML

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

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

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

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

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

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