Routes API पर माइग्रेट क्यों करें?

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

Routes API, दिशा-निर्देशों, दूरी, और यात्रा के समय का हिसाब लगाने के लिए बेहतर परफ़ॉर्मेंस देता है. इसलिए, यह Directions API और Distance Matrix API का इस्तेमाल करने वाले ऐप्लिकेशन को बदलने के लिए एक अच्छा विकल्प है. Routes API की ज़्यादातर सुविधाएं, Directions API और Distance Matrix API, दोनों के साथ काम करती हैं.

इस गाइड का इस्तेमाल करके, Routes API और उसकी जगह इस्तेमाल किए जाने वाले प्रॉडक्ट के बीच मुख्य अंतरों को समझें. साथ ही, ज़रूरी बदलावों को मैनेज करने का तरीका जानें. Routes API की अन्य सुविधाओं के बारे में ज़्यादा जानने के लिए, प्रॉडक्ट की खास जानकारी देखें.

मुख्य सुधार

इस सेक्शन में, उन बेहतर सुविधाओं के बारे में बताया गया है जो आपको अपने ऐप्लिकेशन में Routes API का इस्तेमाल करते समय मिल सकती हैं.

अनुरोधों की बढ़ी हुई सीमाएं

Routes API Compute Route Matrix
  • ज़्यादा से ज़्यादा 625 एलिमेंट हो सकते हैं. हालांकि, TRAFFIC_AWARE_OPTIMAL तय करके इस सीमा को बदला जा सकता है.
  • TRAFFIC_AWARE_OPTIMAL के साथ ज़्यादा से ज़्यादा 100 एलिमेंट इस्तेमाल किए जा सकते हैं. बेहतर राउटिंग की प्राथमिकताएं देखें.
  • जगह के आईडी का इस्तेमाल करके, ज़्यादा से ज़्यादा 50 वेपॉइंट (शुरुआत की जगह + मंज़िल) जोड़े जा सकते हैं.
Distance Matrix API
  • हर अनुरोध में, ज़्यादा से ज़्यादा 25 ओरिजिन या 25 डेस्टिनेशन हो सकते हैं.
  • सर्वर-साइड से किए गए हर अनुरोध में ज़्यादा से ज़्यादा 100 एलिमेंट (ओरिजन की संख्या × डेस्टिनेशन की संख्या) होने चाहिए.

अनुरोधों के जवाब तेज़ी से पाना

Compute Route Matrix सुविधा में, इंतज़ार के समय को कम करने के लिए ये सुधार किए गए हैं:

  • पूरी मैट्रिक्स की गिनती होने से पहले ही, जवाब के स्ट्रीमिंग एलिमेंट पाएं.
  • जवाब की जानकारी को पसंद के मुताबिक़ बनाने के लिए, फ़ील्ड मास्क का इस्तेमाल करें. इससे सिर्फ़ वह डेटा मिलेगा जिसकी आपको ज़रूरत है. यह सबसे सही तरीका है. इससे लागत भी कम होती है.
  • ट्रैफ़िक के लिए बेहतर तरीके से रास्ते का हिसाब लगाया जाता है, ताकि डेटा क्वालिटी और जवाब देने में लगने वाले समय के बीच समझौता किया जा सके.

रूटिंग से जुड़ी बेहतर सुविधाएं

रास्ता तय करने की सुविधा को बेहतर बनाने के लिए, कंप्यूट रूट की सुविधा में ये बदलाव किए गए हैं:

  • दूरी और पहुंचने के अनुमानित समय के साथ-साथ, टोल की जानकारी.
  • दोपहिया वाहन के रास्ते.
  • सुरक्षा के लिए, अपने स्टॉपओवर वेपॉइंट की पुष्टि करें.
  • ईटीए की सटीक जानकारी पाने के लिए, वेपॉइंट के लिए यात्रा की दिशा और सड़क का किनारा सेट करें.

सिर्फ़ उस डेटा का अनुरोध करें जिसकी आपको ज़रूरत है

अब यह तय किया जा सकता है कि किन फ़ील्ड को वापस लाना है. इससे प्रोसेसिंग में लगने वाला समय और बिलिंग शुल्क कम हो जाता है.

Routes API
Compute Routes
Compute Route Matrix 		आपके अनुरोधों में फ़ील्ड मास्क का इस्तेमाल किया जाना चाहिए, ताकि यह बताया जा सके कि आपको जवाब में कौनसे फ़ील्ड चाहिए. फ़ील्ड मास्किंग से यह पक्का होता है कि आपने गैर-ज़रूरी डेटा का अनुरोध न किया हो. इससे, गैर-ज़रूरी प्रोसेसिंग में लगने वाला समय और बिलिंग के शुल्क से बचा जा सकता है.
ज़्यादा जानकारी के लिए, जवाब में दिखाने के लिए फ़ील्ड चुनना लेख पढ़ें.
Directions API
Distance Matrix API 		यह फ़ंक्शन, फ़ील्ड की डिफ़ॉल्ट सूची दिखाता है. भले ही, आपके ऐप्लिकेशन को इनकी ज़रूरत न हो. इस वजह से, प्रोसेस होने में ज़्यादा समय लग सकता है और बिलिंग शुल्क भी ज़्यादा लग सकता है.

ट्रैफ़िक के लिए बेहतर तरीके से रास्ते का हिसाब लगाना

Routes API, रूटिंग की तीन प्राथमिकताओं के साथ काम करता है. इनका इस्तेमाल करके, ट्रैफ़िक की जानकारी का अनुरोध करते समय, जवाब मिलने में लगने वाले समय और डेटा की क्वालिटी के बीच संतुलन बनाया जा सकता है.

ज़्यादा जानकारी के लिए, क्वालिटी बनाम लेटेन्सी को कॉन्फ़िगर करना लेख पढ़ें.

TRAFFIC_UNAWARE
(डिफ़ॉल्ट)		 रास्ते का हिसाब लगाने के लिए, समय के हिसाब से न बदलने वाले ट्रैफ़िक के औसत डेटा का इस्तेमाल करता है. इसमें लाइव ट्रैफ़िक डेटा का इस्तेमाल नहीं किया जाता. इसलिए, जवाब मिलने में सबसे कम समय लगता है. यह सेटिंग तब इस्तेमाल की जाती है, जब Directions API और Distance Matrix API में ट्रैफ़िक की जानकारी का इस्तेमाल नहीं किया जाता.
TRAFFIC_AWARE
(नया)		 कम स्पीड के लिए, परफ़ॉर्मेंस के हिसाब से ऑप्टिमाइज़ की गई लाइव ट्रैफ़िक क्वालिटी. TRAFFIC_AWARE_OPTIMAL के उलट, यह सेटिंग इंतज़ार के समय को काफ़ी कम करने के लिए ऑप्टिमाइज़ेशन लागू करती है. यह सेटिंग, Routes API के लिए भी नई है. Directions API या Distance Matrix API में इसके जैसा कोई विकल्प नहीं है.
TRAFFIC_AWARE_OPTIMAL अच्छी क्वालिटी वाला और पूरी जानकारी देने वाला ट्रैफ़िक डेटा. इस सेटिंग से सबसे ज़्यादा लेटेन्सी होती है. यह Directions API और Distance Matrix API में departure_time सेटिंग के बराबर होती है.
यह सेटिंग, maps.google.com और Google Maps मोबाइल ऐप्लिकेशन में इस्तेमाल किए जाने वाले मोड के बराबर है.

रास्ते की जानकारी की तुलना

यहां दी गई टेबल में, Routes API, Directions API, और Distance Matrix API सेवाओं के बीच रूटिंग के विकल्पों की तुलना की गई है.

ट्रैफ़िक का विकल्प रूट एपीआई Directions API
Distance Matrix API		 इंतज़ार का समय
रीयल-टाइम ट्रैफ़िक की जानकारी नहीं है TRAFFIC_UNAWARE departure_time प्रॉपर्टी सेट नहीं है तीनों मोड में सबसे कम लेटेन्सी.
लाइव ट्रैफ़िक की जानकारी लागू की गई TRAFFIC_AWARE कोई मिलती-जुलती रिपोर्ट नहीं

Routes API ने नया मोड जोड़ा है. इसमें TRAFFIC_UNAWARE के मुकाबले थोड़ी ज़्यादा लेटेन्सी होती है. साथ ही, ईटीए की क्वालिटी पर थोड़ा असर पड़ता है.

इसमें TRAFFIC_AWARE_OPTIMAL के मुकाबले काफ़ी कम समय लगता है.
लाइव ट्रैफ़िक की पूरी जानकारी देने वाला, अच्छी क्वालिटी का डेटा लागू किया गया TRAFFIC_AWARE_OPTIMAL departure_time प्रॉपर्टी सेट

यह मोड, maps.google.com और Google Maps के मोबाइल ऐप्लिकेशन में इस्तेमाल किए जाने वाले मोड के बराबर है.

Compute Route Matrix के लिए, किसी अनुरोध में एलिमेंट की संख्या (ओरिजन की संख्या × डेस्टिनेशन की संख्या) 100 से ज़्यादा नहीं हो सकती.

मुख्य अंतर

इस सेक्शन में, Routes API और इसकी जगह इस्तेमाल की जाने वाली सेवाओं के बीच के मुख्य अंतरों के बारे में बताया गया है. साथ ही, यह भी बताया गया है कि मौजूदा ऐप्लिकेशन में इन सेवाओं से माइग्रेट करते समय, इन अंतरों को कैसे ठीक किया जा सकता है.

दो के बजाय एक सेवा को कॉल करना

Routes API Compute Routes और Compute Route Matrix का इस्तेमाल करने के लिए, API Console में अपने ऐप्लिकेशन के लिए सिर्फ़ एक सेवा चालू करें.
ज़्यादा जानकारी के लिए, Google API Console में सेट अप करना लेख पढ़ें.
Directions API
Distance Matrix API 		API Console में, Directions API और Distance Matrix API को अलग-अलग सेवाओं के तौर पर चालू करें.

HTTPS POST अनुरोधों का इस्तेमाल करता है

Routes API अनुरोध के मुख्य हिस्से या हेडर में पैरामीटर पास करें. ऐसा HTTP POST अनुरोध के हिस्से के तौर पर करें.
उदाहरण के लिए, इन्हें देखें:
- रास्ता तय करना
- रास्ते की मैट्रिक्स तय करना
Directions API
Distance Matrix API 		HTTP GET अनुरोध का इस्तेमाल करके, यूआरएल पैरामीटर पास करें.

ईटीए के जवाब में अंतर

Routes API, ETA दिखाता है. साथ ही, duration रिस्पॉन्स प्रॉपर्टी का इस्तेमाल, Directions API और Distance Matrix API सेवाओं से अलग तरीके से करता है. इसके बारे में यहां दी गई टेबल में बताया गया है.

ईटीए का टाइप रूट एपीआई Directions API
Distance Matrix API
ट्रैफ़िक की जानकारी के बिना, समय के हिसाब से ईटीए.

TRAFFIC_UNAWARE का इस्तेमाल करके सेट किया गया.

  • ईटीए, duration रिस्पॉन्स प्रॉपर्टी में शामिल होता है.
  • duration और staticDuration रिस्पॉन्स प्रॉपर्टी में एक जैसी वैल्यू मौजूद है.

इसका मतलब है कि अनुरोध में departure_time सेट नहीं किया गया है.

  • ईटीए, duration रिस्पॉन्स प्रॉपर्टी में शामिल होता है.
  • duration_in_traffic रिस्पॉन्स प्रॉपर्टी नहीं दिखाई जाती.
ईटीए, जिसमें रीयल-टाइम ट्रैफ़िक की जानकारी शामिल होती है.

TRAFFIC_AWARE या TRAFFIC_AWARE_OPTIMAL का इस्तेमाल करके सेट करें.

  • रीयल-टाइम ट्रैफ़िक को ध्यान में रखकर ईटीए की जानकारी, duration रिस्पॉन्स प्रॉपर्टी में शामिल होती है.
  • staticDuration रिस्पॉन्स प्रॉपर्टी में, ट्रैफ़िक की स्थिति को ध्यान में रखे बिना, रास्ते से यात्रा करने की अवधि शामिल होती है.
  • duration_in_traffic प्रॉपर्टी अब नहीं दिखाई जाती.

अनुरोध में departure_time का इस्तेमाल करके सेट किया जाता है.

  • रीयल-टाइम ट्रैफ़िक को ध्यान में रखकर ईटीए की जानकारी, duration_in_traffic रिस्पॉन्स प्रॉपर्टी में शामिल होती है.

पॉलीलाइन वेपॉइंट

अब आपको इस सेवा के साथ, अक्षांश/देशांतर के कोऑर्डिनेट को पॉलीलाइन वेपॉइंट में बदलने की ज़रूरत नहीं है. यह सेवा, POST अनुरोध के मुख्य हिस्से के साथ काम करती है. इसलिए, अब इस पर यूआरएल स्ट्रिंग की सीमाओं का असर नहीं पड़ता. Distance Matrix API के कुछ उपयोगकर्ताओं ने, अक्षांश/देशांतर बिंदुओं को पॉलीलाइन वेपॉइंट में बदलकर, अनुरोधों की सीमा से जुड़ी समस्या को हल किया.

फ़ॉर्मैट किए गए पते (रिवर्स जियोकोड)

Routes API, जवाब में फ़ॉर्मैट किए गए पते नहीं देता है. फ़ॉर्मैट किए गए पते पाने के लिए, Geocoding API का इस्तेमाल करें. इसे इस इस्तेमाल के उदाहरण के लिए बनाया गया है. साथ ही, इससे बेहतर क्वालिटी के नतीजे मिलते हैं.

यात्रा के लिए उपलब्ध मोड

Directions API की तरह ही, Routes API भी डिफ़ॉल्ट तौर पर DRIVE मोड का इस्तेमाल करता है. ऐसा तब होता है, जब रूट के लिए किए गए अनुरोध में यात्रा का मोड नहीं बताया जाता. हालांकि, जब किसी अनुरोध में रूट के लिए यात्रा का तरीका बताया जाता है, तो Routes API, यात्रा के उपलब्ध तरीकों का ऐरे नहीं दिखाता. ऐसा इसलिए, क्योंकि ये तरीके अनुरोध के लिए वैकल्पिक विकल्प के तौर पर उपलब्ध नहीं होते. अगर इस्तेमाल का आपका मामला इस सुविधा पर निर्भर करता है,तो समस्या की शिकायत करें. इसमें बताएं कि आपने इस सुविधा का इस्तेमाल कैसे किया, ताकि हम इस पर फ़ॉलो अप कर सकें.

जवाब के फ़ॉर्मैट के तौर पर एक्सएमएल

Routes API, जवाब के तौर पर एक्सएमएल फ़ॉर्मैट उपलब्ध नहीं कराता. आपको ऑनलाइन कई JSON से XML कन्वर्टर मिल सकते हैं. इनमें से किसी का भी इस्तेमाल किया जा सकता है.