डिस्टेंस मैट्रिक्स एपीआई का इस्तेमाल क्यों करना चाहिए
आप एक से ज़्यादा जगहों और मंज़िलों के बीच, यात्रा के सबसे बेहतर रास्तों का पता लगाने के लिए डिस्टेंस मैट्रिक्स एपीआई का इस्तेमाल कर सकते हैं. उदाहरण के लिए, कौनसे वर्कर को नौकरी वाली जगहों पर भेजना है या किस वेयरहाउस से पैकेज भेजना है.
डिस्टेंस मैट्रिक्स एपीआई की मदद से क्या-क्या किया जा सकता है
डिस्टेंस मैट्रिक्स एपीआई की मदद से, यात्रा की शुरुआत की जगह और मंज़िलों के मैट्रिक्स के लिए, यात्रा की दूरी और समय की जानकारी दी जा सकती है. आपके पास यात्रा के कई विकल्प तय करने का विकल्प होता है. जैसे, ड्राइविंग, साइकल चलाना, बस, मेट्रो वगैरह के लिए यात्रा के साधन के साथ-साथ बस, सबवे, ट्रेन, ट्राम या रेल जैसे ट्रांज़िट मोड.
डिस्टेंस मैट्रिक्स एपीआई, शुरू और खत्म होने के समय के बीच सुझाए गए रास्ते के हिसाब से जानकारी देता है. दूरी से जुड़े इस तरह के डेटा के लिए अनुरोध किया जा सकता है:
- चुने गए यात्रा के साधन के लिए दूरी
- किलोमीटर या मील में दूरी
- ट्रैफ़िक में यात्रा का अनुमानित समय
दूरी का मैट्रिक्स एपीआई कैसे काम करता है
दूरी मैट्रिक्स एपीआई, ऑरिजिन (शुरुआत की जगह) और डेस्टिनेशन की किसी भी संख्या का इस्तेमाल करता है. यह हर ऑरिजिन और अनुरोध की गई सभी डेस्टिनेशन के बीच की दूरी और यात्रा में लगने वाला समय दिखाता है. यह अनुरोध, अनुरोध में पहले ऑरिजिन से शुरू होता है और अगले ऑरिजिन पर जाता है.
उदाहरण के लिए, अगर आपका अनुरोध 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
संसाधन
इस टेबल में, डिस्टेंस मैट्रिक्स एपीआई के ज़रिए उपलब्ध संसाधनों और उसके लौटाए गए डेटा की खास जानकारी दी गई है.
डेटा रिसॉर्स | डेटा वापस किया गया | रिटर्न फ़ॉर्मैट |
---|---|---|
दूरी का मैट्रिक्स
जगह के आईडी, पते या अक्षांश/देशांतर निर्देशांक के तौर पर ऑरिजिन और डेस्टिनेशन की जानकारी दें. |
|
|
दूरी का मैट्रिक्स एपीआई इस्तेमाल करने का तरीका
1 | सेट अप करें. | सबसे पहले, अपना Google Cloud प्रोजेक्ट सेट अप करें और दिए गए सेटअप निर्देशों को पूरा करें. |
2 | दूरी का मैट्रिक्स देखने का अनुरोध करें | एपीआई पासकोड हासिल करने के बाद, सीधे अपने ब्राउज़र से डिस्टेंस मैट्रिक्स एपीआई को टेस्ट करना शुरू किया जा सकता है. उदाहरणों के लिए, शुरू करें गाइड में अनुरोध के सैंपल देखें. |
3 | ज़्यादा मुश्किल अनुरोध लिखना | ऐसा अनुरोध करें जो कई ऑरिजिन और डेस्टिनेशन उपलब्ध कराता हो. कैलकुलेशन में रुकावट डालने के लिए वैकल्पिक पैरामीटर के बारे में जानें. जैसे, जाने का तय समय या रास्ते से जुड़ी पाबंदियां. दूरी का मैट्रिक्स अनुरोध और जवाब गाइड में वैकल्पिक पैरामीटर देखें. |
4 | जवाब देने से जुड़ी बुनियादी बातें समझना | अपने ऐप्लिकेशन के लिए डिस्टेंस मैट्रिक्स डेटा का इस्तेमाल करने के लिए, डेटा से मिले जवाबों को एक्सप्लोर करें. ज़्यादा जानकारी के लिए, डिस्टेंस मैट्रिक्स देखें. |
5 | अपने ऐप्लिकेशन में डिस्टेंस मैट्रिक्स डेटा शामिल करें! | आप इस डेटा का इस्तेमाल, यात्रा की दूरी और समय का हिसाब लगाने के लिए कर सकते हैं. |
उपलब्ध क्लाइंट लाइब्रेरी
इस एपीआई को अपनी पसंद की भाषा में कॉल करें. इसके लिए, इनमें से किसी एक क्लाइंट लाइब्रेरी का इस्तेमाल करें:
- Google Maps सेवाओं के लिए Java क्लाइंट
- Google Maps की सेवाओं के लिए Python क्लाइंट
- Google Maps की सेवाओं के लिए क्लाइंट इंस्टॉल करें
- Google Maps सेवाओं के लिए Node.js क्लाइंट
Google Maps के लिए Java क्लाइंट, Python क्लाइंट, Go क्लाइंट, और Node.js क्लाइंट, समुदाय के साथ काम करने वाली क्लाइंट लाइब्रेरी हैं. ये Apache 2.0 लाइसेंस के तहत ओपन सोर्स के तौर पर उपलब्ध होती हैं. उन्हें GitHub से डाउनलोड करें. यहां आपको इंस्टॉल करने के निर्देश और सैंपल कोड भी मिल सकता है.
आगे क्या करना है
- दूरी का मैट्रिक्स इस्तेमाल करना शुरू करें: शुरू करें पर जाएं.
- सैंपल अनुरोधों और जवाबों का इस्तेमाल शुरू करना: दूरी के मैट्रिक्स के लिए अनुरोध और उनका जवाब पेज पर जाएं
- सबसे सही तरीके अपनाना: वेब सेवा के सबसे सही तरीके पर जाएं.