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

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

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

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

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

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

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

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

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

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

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

उदाहरण के लिए, अगर आपका अनुरोध 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 Client, और Node.js क्लाइंट सेवाएं समुदाय द्वारा समर्थित क्लाइंट लाइब्रेरी होती हैं, जिन्हें Apache 2.0 लाइसेंस. उन्हें GitHub से डाउनलोड करें. यहां आपको इंस्टॉल करने के निर्देश और सैंपल कोड भी मिल सकता है.

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