दूरी का मैट्रिक्स एपीआई की खास जानकारी

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

परिचय

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

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

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

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

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