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

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

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

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

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

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

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

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

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

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

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

उदाहरण के लिए, अगर आपका अनुरोध 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

संसाधन

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

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

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

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

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

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

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

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

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

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