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 से डाउनलोड करें. यहां आपको इंस्टॉल करने के निर्देश और सैंपल कोड भी मिल सकते हैं.

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