रूट एपीआई का इस्तेमाल क्यों करना चाहिए
रूट एपीआई की मदद से, आपको रास्तों और यात्रा की सटीक जानकारी मिल सकती है परिवहन विवरण, अप-टू-डेट ट्रैफ़िक और सड़क की स्थिति और रास्ते का इस्तेमाल करके प्राथमिकताएं:
परिवहन के अलग-अलग साधनों का टाइप और क्षमता
कोई वाहन किस दिशा में है
पिक अप या ड्रॉप-ऑफ़ के लिए सड़क के किनारे का हिस्सा
ट्रैफ़िक का हाल और बंद सड़कें
सुरक्षा से जुड़ी समस्याएं, जैसे कि खतरनाक जगहों से बचना या सुरक्षित तरीके से पिकअप करना क्षेत्र
रूटिंग की सभी ज़रूरतों के लिए, इंतज़ार के समय, क्वालिटी, और कीमत के बीच संतुलन बनाएं. हालांकि, ऐसा करना ज़रूरी नहीं है टोल और यात्रा का मेटाडेटा जैसी सुविधाएँ, जैसे कि समय और दूरी, और ईंधन दक्षता
आप डिस्पैच शेड्यूल करने के लिए, सबसे बेहतर रास्ते तय कर सकते हैं, जैसे जैसे:
पैकेज की सीरीज़ चुनने के लिए, कर्मचारियों के सेट को असाइन करना बेहतर तरीका है
सबसे अच्छे वेयरहाउस का पता लगाएं, जहां से पैकेज को उनके आखिरी हिस्से तक शिप किया जा सकता है डेस्टिनेशन
रूट एपीआई की मदद से क्या-क्या किया जा सकता है?
रूट एपीआई के साथ, आपको रूटिंग की दो मुख्य कैटगरी मिल सकती हैं जानकारी:
एक जगह से किसी एक या एक से ज़्यादा मंज़िलों के रास्ते
कई शुरू और खत्म होने की जगहों के बीच के संभावित रास्तों का मैट्रिक्स.
एक या एक से ज़्यादा गंतव्यों के लिए रास्ते पाएं
रूट एपीआई Compute Routes
तरीके का इस्तेमाल करके,
जगहों के बीच आकलन किया जा सकता है:
यात्रा के अलग-अलग तरीकों के लिए दिशा-निर्देश पाएं और एक या एक से ज़्यादा रास्तों के लिए दिशा-निर्देश पाएं गंतव्य:
परिवहन के साधन, जिनमें बस, मेट्रो वगैरह, ड्राइविंग, दोपहिया वाहन, पैदल या साइकिल से.
वेपॉइंट की एक सीरीज़, जिसे आप सबसे बेहतर ढंग से काम करने के लिए ऑप्टिमाइज़ कर सकते हैं सफ़र करना आसान हो जाता है.
ऑरिजिन, डेस्टिनेशन, और वेपॉइंट की जानकारी देने के कई तरीके:
टेक्स्ट स्ट्रिंग. उदाहरण के लिए: "शिकागो, IL", "डारविन, NT, ऑस्ट्रेलिया", "1800 Amphitheatre Parkway, Mountain View, CA 94043" या "CWF6+FWX Mountain कैलिफ़ोर्निया में व्यू देखें"
जगह के आईडी
अक्षांश और देशांतर निर्देशांक, वाहन की हेडिंग के साथ विकल्प
अपनी ज़रूरतों और लक्ष्यों के हिसाब से, रास्ते के विकल्पों को बेहतर बनाएं:
अपने वाहन के इंजन के हिसाब से, ईंधन या ऊर्जा की कम खपत वाले रास्ते चुनें: डीज़ल, इलेक्ट्रिक, हाइब्रिड, गैस. ज़्यादा जानकारी के लिए, यह देखें ईको-फ़्रेंडली रास्ता चुनें.
ट्रैफ़िक का हिसाब लगाने के लिए सटीक विकल्प सेट करें, ताकि आप अच्छी क्वालिटी बना पाएं बनाम इंतज़ार के समय के बदले छूट के फ़ैसले. जानकारी के लिए, यह देखें तय करें कि ट्रैफ़िक डेटा को कैसे शामिल करना है और अगर शामिल करना है या नहीं.
इनके लिए वाहन का शीर्षक (यात्रा की दिशा) और सड़क के किनारे की जानकारी सेट करें ईटीए के सटीक होने को बढ़ाने के लिए वेपॉइंट. जानकारी के लिए, यह देखें वाहन का टाइटल और सड़क का हिस्सा बताएं.
पास-थ्रू बनाम टर्मिनल की जगहों और सुरक्षित स्टॉपओवर की जगहों के बारे में बताएं. इसके लिए विवरण, देखें किसी रास्ते पर स्टॉप सेट करना और किसी रास्ते से गुज़रने के लिए एक पॉइंट सेट करें.
रास्ते की दूरी और ETA के साथ टोल की जानकारी मांगें. जानकारी के लिए, किसी रास्ते के लिए टोल शुल्क का हिसाब लगाना देखें.
सिर्फ़ उस डेटा का अनुरोध करें जिसके इस्तेमाल की आपको ज़रूरत है. इसकी मदद से इंतज़ार का समय और क्वालिटी कंट्रोल करें फ़ील्ड मास्क की सुविधा, जिससे डेटा प्रोसेस होने में लगने वाले ग़ैर-ज़रूरी समय और ज़्यादा समय से बचा जा सकता है बिलिंग दरों का अनुरोध करें. जानकारी के लिए, यह देखें चुनें कि कौनसी जानकारी दी जाए.
संभावित रास्तों का मैट्रिक्स पाएं
रूट एपीआई Compute Route Matrix
वाला तरीका
कई शुरुआती और आखिरी के बीच के सुझाए गए रास्तों की जानकारी का मैट्रिक्स
दूरी और पहुंचने का अनुमानित समय समेत पॉइंट की मदद से,
आपकी जानकारी के आधार पर
कारोबार की ज़रूरतों को पूरा करता है. दूरी से जुड़े इस तरह के डेटा के लिए अनुरोध किया जा सकता है:
चुने गए यात्रा के साधन के लिए दूरी
किलोमीटर या मील में दूरी
ट्रैफ़िक में यात्रा का अनुमानित समय
दूरी के डेटा की मदद से, रास्ते का सबसे सही रास्ता पता किया जा सकता है यात्रियों, शिपमेंट, या कर्मचारियों को अलग-अलग संभावित ऑरिजिन और गंतव्य.
जवाब के एलिमेंट को पूरा मैट्रिक्स से पहले स्ट्रीम किया जा सकता है इसकी गिनती की जाती है. इससे जवाब मिलने में लगने वाला समय कम हो जाता है.
हर सर्वर साइड अनुरोध के लिए, एक से ज़्यादा ऑरिजिन और डेस्टिनेशन तय किए जा सकते हैं ऑरिजिन की संख्या गुणा 625 तक डेस्टिनेशन की संख्या.
रूट एपीआई कैसे काम करता है
रूट एपीआई में दो तरीके हैं: ComputeRoutes
और
ComputeRouteMatrix
.
ComputeRoutes
रूट एपीआई 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'
इसके बाद, सेवा अनुरोध किए गए रास्ते का हिसाब लगाती है और आपके अनुरोध किए गए फ़ील्ड दिखाती है.
ComputeRouteMatrix
रूट एपीआई ComputeRouteMatrix
, एचटीटीपी पोस्ट अनुरोध को इसके साथ स्वीकार करता है
JSON के अनुरोध का मुख्य हिस्सा, जिसमें अनुरोध की जानकारी होती है. कम से कम एक फ़ील्ड ज़रूरी है
ऑरिजिन, दो या उससे ज़्यादा डेस्टिनेशन, TravelMode, और फ़ील्ड मास्क की मदद से यह तय करता है कि
लौटाने के लिए फ़ील्ड.
उदाहरण
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420761, "longitude": -122.081356 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.403184, "longitude": -122.097371 } } } } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420999, "longitude": -122.086894 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.383047, "longitude": -122.044651 } } } } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
रिस्पॉन्स में उन सभी ऑरिजिन के कॉम्बिनेशन के लिए संभावित रूट शामिल होते हैं और डेस्टिनेशन वेपॉइंट शामिल हैं.
संसाधन
यहां दी गई टेबल में, रूट एपीआई और उससे मिलने वाला डेटा.
डेटा रिसॉर्स | डेटा वापस किया गया | रिटर्न फ़ॉर्मैट |
---|---|---|
ComputeRoutes | वैकल्पिक रास्तों के साथ किसी रास्ते के रास्ते, पैर और चरण लौटाता है, अगर आपसे संपर्क किया जाए. | JSON |
ComputeRouteMatrix | एक मूल वेपॉइंट से एक गंतव्य तक के रास्तों की श्रेणी देता है वेपॉइंट. |
रूट एपीआई को इस्तेमाल करने का तरीका
1 | सेट अप करना | सबसे पहले, अपना Google Cloud प्रोजेक्ट सेट अप करें और दिए गए सेटअप निर्देशों को पूरा करें. |
2 | किसी रूट का पता लगाना और जवाब की समीक्षा करना | ज़्यादा जानकारी के लिए, रास्ते की जानकारी पाना देखें और रास्ते के जवाब देखें. |
3 | रूट्स के मैट्रिक्स का हिसाब लगाना और रिस्पॉन्स की समीक्षा करना | ज़्यादा जानकारी के लिए, रूट मैट्रिक्स पाना देखें और रूट मैट्रिक्स जवाब की समीक्षा करें. |
उपलब्ध क्लाइंट लाइब्रेरी
रूट एपीआई के लिए उपलब्ध क्लाइंट लाइब्रेरी की सूची देखने के लिए, देखें क्लाइंट लाइब्रेरी.