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
  • XML

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

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

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

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

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

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