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

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

Distance Matrix API का इस्तेमाल क्यों करना चाहिए

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

Distance Matrix API की मदद से क्या-क्या किया जा सकता है

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

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 दूरी के मैट्रिक्स का अनुरोध करने की कोशिश करें एपीआई पासकोड मिलने के बाद, सीधे अपने ब्राउज़र से Distance Matrix API की जांच शुरू की जा सकती है. उदाहरणों के लिए, शुरू करें गाइड में अनुरोध के सैंपल देखें.
3 ज़्यादा जटिल अनुरोध लिखना ऐसा अनुरोध आज़माएं जिसमें कई ऑरिजिन और डेस्टिनेशन शामिल हों. कैलकुलेशन पर पाबंदी लगाने के लिए, वैकल्पिक पैरामीटर के बारे में जानें. जैसे, तय किया गया ऑफ़र शुरू होने का समय या रास्ते से जुड़ी पाबंदियां. डिस्टेंस मैट्रिक के अनुरोध और जवाब गाइड में, ज़रूरी नहीं पैरामीटर देखें.
4 जवाब की बुनियादी बातें समझना अपने ऐप्लिकेशन के लिए, दूरी के मैट्रिक्स डेटा का इस्तेमाल करने के लिए, डेटा के जवाबों को एक्सप्लोर करें. ज़्यादा जानकारी के लिए, दूरी के मैट्रिक्स के जवाब देखें.
5 अपने ऐप्लिकेशन में, दूरी के मैट्रिक्स का डेटा शामिल करें! इस डेटा का इस्तेमाल, यात्रा की दूरी और समय का हिसाब लगाने के लिए किया जा सकता है.

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

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

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

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