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

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

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

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

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