परिचय
Compute Routes, Routes API सेवा का एक तरीका है. यह एचटीटीपीएस अनुरोध स्वीकार करता है और दो जगहों के बीच का सबसे सही रास्ता दिखाता है. अलग-अलग जगहों पर साइकल, मोटरसाइकल, कार, बस, मेट्रो वगैरह से या पैदल जाने के लिए, रीयल-टाइम ट्रैफ़िक के साथ रास्ते की जानकारी पाने की सुविधा दें.
क्या आपको रूट मैट्रिक की ज़रूरत है? अगर आपको रास्ते की मैट्रिक में दिलचस्पी है, तो Compute Routes Matrix की खास जानकारी देखें.
क्या माइग्रेट किया जा रहा है? अगर आपको Distance Matrix API (लेगसी) से माइग्रेट करना है, तो Routes API पर माइग्रेट क्यों करना चाहिए से शुरू होने वाले, माइग्रेशन के निर्देश देखें.
Compute Routes का इस्तेमाल क्यों करना चाहिए
'रास्ते का हिसाब लगाएं' सुविधा की मदद से, रास्ते की कई तरह की जानकारी मिलती है. इसकी मदद से, अपनी पसंद के हिसाब से वाहनों या पैकेज को रास्ता दिया जा सकता है. साथ ही, लागत और क्वालिटी को ऑप्टिमाइज़ किया जा सकता है.
Compute Routes की मदद से क्या किया जा सकता है?
Routes API Compute Routes
तरीके की मदद से, ये काम किए जा सकते हैं:
यात्रा के अलग-अलग तरीकों के लिए निर्देश पाएं. साथ ही, एक या एक से ज़्यादा डेस्टिनेशन के लिए निर्देश पाएं:
यात्रा के तरीके: बस, मेट्रो वगैरह, कार, दोपहिया वाहन, पैदल या साइकल.
वे रास्ते जिन पर यात्रा करने के लिए, सबसे सही क्रम में उन्हें ऑप्टिमाइज़ किया जा सकता है.
ऑरिजिन, डेस्टिनेशन, और रास्ते में रुकने के लिए जगहों की जानकारी देने के लिए, कई तरीकों का इस्तेमाल करें:
टेक्स्ट स्ट्रिंग. उदाहरण के लिए: "मुंबई, भारत", "दिल्ली, भारत", "1800 Amphitheatre Parkway, Mountain View, CA 94043" या "CWF6+FWX Mountain View, California"
जगह के आईडी
अक्षांश और देशांतर के निर्देशांक. इसके साथ, वाहन की दिशा की जानकारी भी दी जा सकती है
अपनी ज़रूरतों और लक्ष्यों के आधार पर, रास्ते के विकल्पों को बेहतर बनाएं:
अपने वाहन के इंजन के हिसाब से, ईंधन या ऊर्जा की कम खपत वाले रास्ते चुनें: डीज़ल, इलेक्ट्रिक, हाइब्रिड, पेट्रोल. ज़्यादा जानकारी के लिए, ईको-फ़्रेंडली रास्ता पाना लेख पढ़ें.
ट्रैफ़िक का हिसाब लगाने के लिए बेहतर विकल्प सेट करें. इससे, आपको क्वालिटी बनाम इंतज़ार के समय के बीच के फ़ैसले लेने में मदद मिलती है. ज़्यादा जानकारी के लिए, ट्रैफ़िक डेटा को शामिल करने का तरीका और यह तय करना कि उसे शामिल करना है या नहीं लेख पढ़ें.
ईटीए की सटीक जानकारी पाने के लिए, व्यू पॉइंट के लिए वाहन की हेडिंग (यात्रा की दिशा) और सड़क के किनारे की जानकारी सेट करें. ज़्यादा जानकारी के लिए, वाहन की दिशा और सड़क की साइड की जानकारी दें लेख पढ़ें.
बताएं कि सामान को कहां भेजा जाएगा और कहां से वापस लाया जाएगा. साथ ही, बताएं कि सामान को कहां सुरक्षित रखा जाएगा. ज़्यादा जानकारी के लिए, रास्ते में स्टॉप सेट करना और रास्ते में सेट किया जाने वाला पॉइंट लेख पढ़ें.
रास्ते की दूरी और ईटीए के साथ-साथ, टोल की जानकारी का अनुरोध करें. ज़्यादा जानकारी के लिए, किसी रास्ते के लिए टोल शुल्क का हिसाब लगाना लेख पढ़ें.
फ़ील्ड मास्क का इस्तेमाल करके, सिर्फ़ उस डेटा का अनुरोध करके अपने इंतज़ार का समय और क्वालिटी कंट्रोल करें जिसकी आपको ज़रूरत है. इससे, डेटा प्रोसेस करने में लगने वाले समय और अनुरोध की बिलिंग दरों में बढ़ोतरी से बचा जा सकता है. ज़्यादा जानकारी के लिए, चुनें कि कौनसी जानकारी दिखानी है लेख पढ़ें.
Compute Routes का काम करने का तरीका
Routes API ComputeRoutes
का तरीका, एचटीटीपी पोस्ट अनुरोध को स्वीकार करता है. इसमें अनुरोध के बारे में जानकारी देने वाला JSON अनुरोध बॉडी होता है. ऑरिजिन, डिस्टिनेशन, travelMode
, और फ़ील्ड मास्क की वैल्यू देना ज़रूरी है. इससे यह तय होता है कि कौनसे फ़ील्ड दिखाने हैं.
उदाहरण
curl -X POST -d '{ "origin": { "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043" }, "destination": { "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132" }, "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
इसके बाद, सेवा उस रास्ते का हिसाब लगाती है जिसके लिए अनुरोध किया गया है. साथ ही, वे फ़ील्ड दिखाती है जिनका अनुरोध किया गया है.
संसाधन
नीचे दी गई टेबल में, Routes API के Compute Routes तरीके से मिलने वाले संसाधनों के साथ-साथ, उससे मिलने वाले डेटा के बारे में खास जानकारी दी गई है.
डेटा संसाधन | डेटा वापस पाना | रिटर्न का फ़ॉर्मैट |
---|---|---|
ComputeRoutes | अगर अनुरोध किया जाता है, तो किसी रास्ते के लिए रास्ते, लेग, और चरणों के साथ-साथ, वैकल्पिक रास्तों की जानकारी देता है. | JSON |
Compute Routes का इस्तेमाल करने का तरीका
1 | सेट अप करना | अपना Google Cloud प्रोजेक्ट सेट अप करें से शुरू करें और सेटअप के लिए दिए गए निर्देशों का पालन करें. |
2 | Routes API के बिलिंग सिस्टम के बारे में जानकारी | ज़्यादा जानकारी के लिए, इस्तेमाल और बिलिंग लेख पढ़ें. |
3 | रास्ता तय करना और जवाब की समीक्षा करना | ज़्यादा जानकारी के लिए, रास्ता पाना और रास्ते के जवाबों की समीक्षा करना लेख पढ़ें. |
उपलब्ध क्लाइंट लाइब्रेरी
Compute Routes के लिए उपलब्ध क्लाइंट लाइब्रेरी की सूची देखने के लिए, क्लाइंट लाइब्रेरी देखें.
आगे क्या करना है
- रास्ते की जानकारी पाना
- रास्ते के उपलब्ध विकल्प
- चुनें कि कौनसी जानकारी वापस लानी है
- Directions API (लेगसी) से माइग्रेट करना
- Routes API की झलक से GA पर माइग्रेट करना