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

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

परिचय

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

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

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

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

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

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