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

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

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

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

दूरी मैट्रिक्स 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

रिसॉर्स

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

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

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

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

दूरी मैट्रिक्स API का इस्तेमाल कैसे करें

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

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

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

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

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