Distance Matrix API (लेगसी) के बारे में खास जानकारी

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

परिचय

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 से 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
  • एक्सएमएल

Distance Matrix API (लेगसी) का इस्तेमाल कैसे करें

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

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

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

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

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