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

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

डिस्टेंस मैट्रिक्स एपीआई का इस्तेमाल क्यों करना चाहिए

डिस्टेंस मैट्रिक्स एपीआई का इस्तेमाल करके, यह पता लगाया जा सकता है कि किस जगह आपके प्रॉडक्ट की खपत सबसे कम होगी कई संभावित मूल और मंज़िलों के बीच यात्रा के कई रास्ते. उदाहरण के लिए, कौनसे कर्मचारियों को नौकरी वाली साइटों पर भेजना है या किन गोदामों से पैकेज भेजने हैं.

डिस्टेंस मैट्रिक्स एपीआई की मदद से क्या-क्या किया जा सकता है

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

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

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

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

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

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

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

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

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