Routes API के लिए क्विक रेफ़रंस

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 API के आधिकारिक पैकेज:

  • npm: @googlemaps/routing
  • pypi: google-maps-routing
  • go: cloud.google.com/go/maps
  • maven: com.google.maps:google-maps-routing

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 में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.