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

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

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

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

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