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

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

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

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

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