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

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

परिचय

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

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

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

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

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