Routes API एक वेब सेवा है, जिसमें दो तरीके शामिल हैं: Compute Routes, दो जगहों के बीच का रास्ता दिखाता है. इसमें, रास्ते में पड़ने वाली जगहों की जानकारी भी शामिल की जा सकती है. वहीं, Compute Route Matrix, शुरुआत की जगहों और मंज़िलों के कॉम्बिनेशन के लिए, यात्रा की दूरी और समय दिखाता है. इसमें ज़्यादा से ज़्यादा 625 रूट एलिमेंट शामिल किए जा सकते हैं.
Routes API: अहम जानकारी
- प्रॉडक्ट: Routes API
- इसे इस नाम से भी जाना जाता है: Routes API v2, Compute Routes, Compute Route Matrix
- कैटगरी: रास्ते
- प्लैटफ़ॉर्म: वेब सेवा (REST)
- इस पर चलता है: सर्वर (बैकएंड कोड)
- लॉन्च स्टेज: GA
- लाइफ़साइकल: चालू है
- खास जानकारी: Routes API के बारे में खास जानकारी
- क्षेत्र के हिसाब से उपलब्धता: दुनिया भर में. दोपहिया वाहन के लिए रास्ता दिखाने, ईको-फ़्रेंडली रास्ते दिखाने, और टोल की कीमत का हिसाब लगाने की सुविधा, चुनिंदा देशों और शहरों में ही उपलब्ध है. साथ ही, जिन देशों के अधीन आने वाले इलाकों का अपना सीएलडीआर कोड है वहां यह सुविधा तब तक उपलब्ध नहीं होगी, जब तक कि उन्हें सूची में शामिल न किया गया हो. यूरोपियन इकनॉमिक एरिया (ईईए) के बिलिंग पतों के लिए, https://developers.google.com/maps/comms/eea/routes पर मौजूद ईईए की शर्तें, किसी भी मैप के साथ रास्ते की जानकारी या निर्देशों का इस्तेमाल करने पर पाबंदी लगाती हैं. (कवरेज की जानकारी)
Routes API: इसका इस्तेमाल कब करना चाहिए
Routes API का इस्तेमाल तब करें, जब:
- आपको ड्राइविंग, पैदल चलने, साइकल चलाने, दोपहिया वाहन या बस, मेट्रो वगैरह से यात्रा करने के लिए, शुरुआती जगह और मंज़िल के बीच का रास्ता चाहिए. इसमें, रास्ते में पड़ने वाले वेपॉइंट भी शामिल किए जा सकते हैं.
- आपको एक ही अनुरोध में, शुरुआत की जगह और मंज़िल के कई जोड़ों के लिए, यात्रा की दूरी और समय की जानकारी चाहिए. एक अनुरोध में ज़्यादा से ज़्यादा 625 एलिमेंट शामिल किए जा सकते हैं.
- आपको टोल शुल्क के अनुमान (चुनिंदा शहरों के लिए), ईको-फ़्रेंडली रास्ते (चुनिंदा इलाकों के लिए), ट्रैफ़िक की जानकारी देने वाली पॉलीलाइन या बड़े वाहनों के लिए रास्ते की जानकारी (सीमित उपलब्धता) चाहिए.
- आपको किसी सर्वर ऐप्लिकेशन को लेगसी Directions API या Distance Matrix API से माइग्रेट करना है.
Routes API का इस्तेमाल तब न करें, जब:
- आपको वाहनों के पूरे बेड़े के लिए, लोड असाइनमेंट और स्टॉप ऑर्डर को ऑप्टिमाइज़ करना होगा. इसके बजाय, Route Optimization API का इस्तेमाल करें.
- आपको Android पर, ऐप्लिकेशन में रास्ते के दिशा-निर्देशों की सुविधा चाहिए, जो तय किए गए रास्ते के हिसाब से काम करे. इसके बजाय, Android के लिए Navigation SDK का इस्तेमाल करें.
- आपको iOS पर, ऐप्लिकेशन में रास्ते के दिशा-निर्देशों की सुविधा चाहिए, जो तय किए गए रास्ते के हिसाब से काम करे. इसके बजाय, iOS के लिए Navigation SDK का इस्तेमाल करें.
Routes API: सेटअप
- चालू की जाने वाली सेवा:
routes.googleapis.com - पुष्टि करना: एपीआई पासकोड, OAuth 2.0, सेवा खाता
- शुरू करें: Routes API सेट अप करना
- रेफ़रंस: Routes API का रेफ़रंस
- कीमत: Routes API के इस्तेमाल और बिलिंग की जानकारी
- नीतियां: Routes API की नीतियां
- रिलीज़ नोट: Routes API के रिलीज़ नोट
Routes API के आधिकारिक पैकेज:
- npm:
@googlemaps/routing - pypi:
google-maps-routing - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routing
Routes API: रिलेटेड प्रॉडक्ट
- इनकी जगह इस्तेमाल किया जा सकता है: Directions API, Distance Matrix API
- आम तौर पर, इनका इस्तेमाल इनके साथ किया जाता है: Navigation SDK for Android, Navigation SDK for iOS, Route Optimization API, Geocoding API, Places API (नया वर्शन)
Routes API: आम तौर पर होने वाली गलतियां
- समस्या: दिखाए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं है. फ़ील्ड मास्क (
X-Goog-FieldMaskहेडर या$fieldsपैरामीटर) के बिना किए गए अनुरोधों में गड़बड़ी का मैसेज दिखता है. ठीक करने का तरीका: हमेशा एक फ़ील्ड मास्क भेजें, जिसमें उन रिस्पॉन्स फ़ील्ड की सूची हो जिनकी आपको ज़रूरत है. /maps/documentation/routes/choose_fields देखें. - समस्या: प्रोडक्शन में वाइल्डकार्ड फ़ील्ड मास्क (
*) का इस्तेमाल करने से, लागत और इंतज़ार का समय बढ़ जाता है. साथ ही, रिस्पॉन्स में नई ऐडवांस सुविधाएं जोड़ने पर, लागत अचानक बढ़ सकती है. ठीक करने का तरीका:*का इस्तेमाल सिर्फ़ डेवलपमेंट के दौरान करें. प्रोडक्शन के दौरान, सिर्फ़ उन फ़ील्ड का अनुरोध करें जिनकी आपको ज़रूरत है. /maps/documentation/routes/choose_fields देखें. - समस्या: टोल की जानकारी और ईंधन की खपत का डेटा, सिर्फ़ फ़ील्ड मास्क में जोड़ने से नहीं मिलता. ऐसा इसलिए, क्योंकि GA में इन्हें साफ़ तौर पर चालू करना ज़रूरी है. ठीक करने का तरीका: फ़ील्ड मास्क के अलावा, अनुरोध में
extraComputationsकलेक्शन (उदाहरण के लिए,TOLLS,FUEL_CONSUMPTION) जोड़ें. /maps/documentation/routes/migrate-routes-preview देखें. - समस्या: Compute Route Matrix में 625 एलिमेंट इस्तेमाल किए जा सकते हैं. हालांकि,
routingPreferenceकेTRAFFIC_AWARE_OPTIMALहोने पर सिर्फ़ 100 एलिमेंट इस्तेमाल किए जा सकते हैं. ठीक करने का तरीका:TRAFFIC_AWARE_OPTIMALका इस्तेमाल करते समय, ऑरिजिन x डेस्टिनेशन की संख्या 100 या उससे कम रखें या अनुरोध को बांटें. /maps/documentation/routes/compute_route_matrix देखें.
Routes API की मदद से क्या-क्या किया जा सकता है
हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.
- दो या इससे ज़्यादा अक्षांश/देशांतर निर्देशांकों के बीच के रास्ते की जानकारी, निर्देशांकों की सीरीज़ के तौर पर दिखाता है. इसमें रास्ते के हर चरण के लिए निर्देशांक होते हैं.
- अक्षांश/देशांतर निर्देशांकों के दो या उससे ज़्यादा सेट के बीच के रास्ते की जानकारी, किसी रास्ते के चरणों के लिए दिशा-निर्देशों की सीरीज़ के तौर पर दिखाता है.
- अक्षांश/देशांतर निर्देशांकों के दो या उससे ज़्यादा सेट के बीच के रास्ते पर, हर चरण के बीच की दूरी दिखाता है.
- अक्षांश/देशांतर निर्देशांकों के दो या उससे ज़्यादा सेट के बीच के रास्ते पर, हर चरण के बीच यात्रा में लगने वाला समय दिखाता है.
- अक्षांश/देशांतर निर्देशांकों के दो या उससे ज़्यादा सेट के बीच के रास्ते पर, हर चरण के बीच एन्कोड की गई पॉलीलाइन दिखाता है.
- अक्षांश/देशांतर निर्देशांकों के दो या उससे ज़्यादा सेट के बीच के रास्ते की दूरी दिखाता है.
- अक्षांश/देशांतर निर्देशांकों के दो या इससे ज़्यादा सेट के बीच के रास्ते के लिए, यात्रा में लगने वाला समय दिखाता है.
- अक्षांश/देशांतर निर्देशांकों के दो या उससे ज़्यादा सेट के बीच के रास्ते के लिए, एन्कोड की गई पॉलीलाइन दिखाता है.
- अक्षांश/देशांतर निर्देशांकों के दो या उससे ज़्यादा सेट के बीच के रास्ते के लिए, टोल की जानकारी दिखाएं.
- रास्ते के अनुरोध के लिए, यात्रा का मोड (ड्राइव, बस, मेट्रो वगैरह, पैदल, दोपहिया वाहन) तय करें. ध्यान दें: Routes API वेब सेवा (computeRoutes) में, RouteTravelMode (DRIVE, BICYCLE, TWO_WHEELER, WALK, TRANSIT या routeModifiers.vehicleInfo के साथ TRUCK) का इस्तेमाल करके, एचटीटीपी POST JSON बॉडी में travelMode पास करें. साथ ही, लेगसी GET मोड क्वेरी पैरामीटर के बजाय, ज़रूरी X-Goog-FieldMask हेडर शामिल करें. Maps JavaScript API की Routes लाइब्रेरी में, ComputeRoutesRequest पर travelMode और फ़ील्ड पास करें.
- रास्ते के अनुरोध के लिए, स्टॉप या पास-थ्रू पॉइंट तय करें.
- यह बताना कि रूट के अनुरोध में, ट्रैफ़िक डेटा का इस्तेमाल कैसे किया जाता है.
- रूट के अनुरोध के लिए, हाइवे या टोल जैसी सुविधाओं से बचने के लिए निर्देश दें.
- किसी रास्ते पर वेपॉइंट सेट करें.
- किसी रास्ते पर इंटरमीडिएट वेपॉइंट सेट करें.
- रास्ते में पड़ने वाली किसी जगह को सेट करें.
- किसी रास्ते के लिए, वाहन की दिशा और सड़क के किनारे की जानकारी दें.
- अपने रास्ते में पड़ने वाले स्टॉप के क्रम को ऑप्टिमाइज़ करें.
- रास्तों के अनुरोध के लिए, ईको-फ़्रेंडली रास्ते का विकल्प तय करना. झलक
- रास्तों के अनुरोध के लिए, कम दूरी या वैकल्पिक रास्ता तय करना. ध्यान दें: Routes API में, कम दूरी वाले रेफ़रंस रूट (SHORTER_DISTANCE) का अनुरोध करना, एक्सपेरिमेंट के तौर पर उपलब्ध है. वहीं, अन्य रूट (computeAlternativeRoutes) का अनुरोध करना, GA है.
- शुरुआत की कई जगहों और मंज़िलों के बीच के रास्तों के मैट्रिक्स के लिए, दूरी की जानकारी पाएं.
- शुरुआत की कई जगहों से अलग-अलग मंज़िलों तक के रास्तों के मैट्रिक्स के लिए, यात्रा में लगने वाले समय की जानकारी पाएं.
- शुरुआत की कई जगहों से अलग-अलग मंज़िलों तक के रास्तों के मैट्रिक्स के लिए, टोल की जानकारी पाएं.
- रूट मैट्रिक्स के अनुरोध के लिए, यात्रा का मोड (ड्राइव, बस, मेट्रो वगैरह, पैदल, दोपहिया वाहन) तय करें. ध्यान दें: Routes API की वेब सेवा (computeRouteMatrix) में, RouteTravelMode (DRIVE, TWO_WHEELER, WALK, TRANSIT या TRUCK के साथ origins[].routeModifiers.vehicleInfo; रूट मैट्रिक्स के लिए BICYCLE का इस्तेमाल नहीं किया जा सकता) का इस्तेमाल करके, एचटीटीपी POST JSON बॉडी में travelMode पास करें. साथ ही, ज़रूरी X-Goog-FieldMask हेडर शामिल करें. Maps JavaScript API की Routes लाइब्रेरी में, ComputeRouteMatrixRequest पर travelMode और फ़ील्ड पास करें.