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

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

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

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

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

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

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

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

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

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

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

दूरी का मैट्रिक्स एपीआई इस्तेमाल करने का तरीका

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

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

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

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

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