Directions API (लेगसी), एक वेब सेवा है. यह ड्राइविंग, पैदल चलने, साइकल चलाने, और बस, मेट्रो वगैरह से यात्रा करने के लिए, जगहों के बीच के रास्तों का हिसाब लगाती है. इसमें वेपॉइंट वाले कई हिस्सों वाले रास्ते भी शामिल हैं. साथ ही, यह JSON या एक्सएमएल में रास्ते, लेग, और चरण दिखाती है. यह लेगसी स्टेटस में है: अक्टूबर 2026 से, इसे नए Google Cloud प्रोजेक्ट के लिए चालू नहीं किया जा सकता. इसलिए, Routes API पर माइग्रेट करें.
Directions API: अहम जानकारी
- प्रॉडक्ट: Directions API
- इसे इस नाम से भी जाना जाता है: Directions API (लेगसी)
- कैटगरी: रास्ते
- प्लैटफ़ॉर्म: वेब सेवा (REST)
- इस पर चलता है: सर्वर (बैकएंड कोड)
- लॉन्च स्टेज: GA
- लाइफ़साइकल: लेगसी
- इसकी जगह इस्तेमाल किया जा रहा है: Routes API
- खास जानकारी: Directions API की खास जानकारी
- क्षेत्र के हिसाब से उपलब्धता: दुनिया भर में. कवरेज, देश/इलाके और यात्रा के मोड के हिसाब से अलग-अलग होता है. बस, मेट्रो वगैरह की जानकारी, बस, मेट्रो वगैरह की सेवा देने वाली कंपनियों से मिले डेटा पर निर्भर करती है. (कवरेज की जानकारी)
Directions API: इसका इस्तेमाल कब करना चाहिए
Directions API का इस्तेमाल तब करें, जब:
- आपके पास Google Cloud का कोई ऐसा मौजूदा प्रोजेक्ट हो जिसमें Directions API (लेगसी) पहले से चालू हो और
maps/api/directionsको कॉल करता हो. - आपको किसी मौजूदा प्रोजेक्ट में, JSON या एक्सएमएल फ़ॉर्मैट में, सर्वर-साइड से ड्राइविंग, पैदल चलने, साइकल चलाने या ट्रांज़िट मोड से यात्रा करने के लिए रास्ते की जानकारी चाहिए. हालांकि, ट्रांज़िट मोड से यात्रा करने के लिए वेपॉइंट की जानकारी नहीं चाहिए.
Directions API का इस्तेमाल तब न करें, जब:
- आपने एक नया Google Cloud प्रोजेक्ट शुरू किया है. अक्टूबर 2026 से, नए प्रोजेक्ट के लिए Directions API (लेगसी) को चालू नहीं किया जा सकता. इसके बजाय, Routes API का इस्तेमाल करें.
- आपको रूटिंग की नई सुविधाएं और बेहतर परफ़ॉर्मेंस चाहिए. इसके बजाय, Routes API का इस्तेमाल करें.
- आपको एक ही अनुरोध में, शुरुआत की कई जगहों से अलग-अलग मंज़िलों तक की यात्रा में लगने वाले समय और दूरी की जानकारी चाहिए. इसके बजाय, Routes API का इस्तेमाल करें.
Directions API: सेटअप
- चालू की जाने वाली सेवा:
directions-backend.googleapis.com - पुष्टि करने का तरीका: एपीआई पासकोड
- शुरू करें: Directions API सेट अप करें
- रेफ़रंस: Directions API का रेफ़रंस
- कीमत: Directions API का इस्तेमाल और बिलिंग
- नीतियां: Directions API की नीतियां
- रिलीज़ नोट: Directions API के रिलीज़ नोट
Directions API: आम तौर पर होने वाली गलतियां
- समस्या: किसी ऐसे प्रोजेक्ट से Directions API (लेगसी) को किए गए अनुरोध पूरे नहीं हो पाते हैं जिसमें लेगसी एपीआई चालू नहीं है. साथ ही,
LegacyApiNotActivatedMapErrorगड़बड़ी का कोड दिखता है. समस्या हल करने का तरीका: अगर आपके पास ऐप्लिकेशन का मालिकाना हक है, तो Routes API पर माइग्रेट करें. माइग्रेट करने या ऐप्लिकेशन के अपडेट का इंतज़ार करने के दौरान, कुछ समय के लिए लेगसी एपीआई को चालू किया जा सकता है. इसके लिए, आपको लेगसी एपीआई को चालू करने वाला फ़ॉर्म भरना होगा. /maps/legacy देखें. - समस्या: वेपॉइंट पर
via:प्रीफ़िक्स का इस्तेमाल करने से, वे सख्त पास-थ्रू बन जाते हैं. इससे, रास्ते में काफ़ी बदलाव हो सकते हैं याZERO_RESULTSस्टेटस दिख सकता है. समाधान: स्टॉपओवर वेपॉइंट (via:प्रीफ़िक्स के बिना) का इस्तेमाल करें. हालांकि, अगर आपको किसी खास पास-थ्रू पॉइंट की ज़रूरत है, तो उसका इस्तेमाल करें. /maps/documentation/directions/get-directions देखें. - समस्या: 11 से 25 वेपॉइंट,
optimize:true, ट्रैफ़िक के हिसाब से यात्रा में लगने वाले समय (duration_in_traffic) याside_of_roadयाheadingलोकेशन मॉडिफ़ायर वाले अनुरोधों के लिए, ज़्यादा कीमत वाले Directions Advanced (Pro) एसकेयू के हिसाब से बिल भेजा जाता है. समाधान: इन सुविधाओं का इस्तेमाल सिर्फ़ ज़रूरत पड़ने पर करें. साथ ही, वेपॉइंट की संख्या 10 या इससे कम रखें. Essentials एसकेयू का इस्तेमाल जारी रखने के लिए,optimize:true,departure_time(ड्राइविंग के लिए),side_of_road, औरheadingका इस्तेमाल न करें. /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku देखें. - समस्या: ड्राइविंग के लिए,
departure_timeकी वैल्यू, बीते समय की नहीं हो सकती. ऐसा होने पर, अनुरोध पूरा नहीं होता औरINVALID_REQUESTगड़बड़ी का मैसेज दिखता है.departure_timeकी वैल्यू न होने पर, रूट और यात्रा में लगने वाले समय का हिसाब लगाने के लिए, ट्रैफ़िक के औसत डेटा का इस्तेमाल किया जाता है. यह डेटा, समय के हिसाब से नहीं बदलता. साथ ही,duration_in_trafficकी वैल्यू नहीं मिलती. ठीक करने का तरीका:duration_in_trafficपाने के लिए,departure_timeकोnowपर सेट करें याmode=drivingके साथ आने वाले समय पर सेट करें.duration_in_trafficदिखाने वाले अनुरोधों के लिए, Directions Advanced (Pro) SKU के हिसाब से बिलिंग की जाती है. /maps/documentation/directions/get-directions देखें.