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

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