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

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

Routes API, दिशा-निर्देश, दूरी, और यात्रा में लगने वाले समय का हिसाब लगाने के लिए बेहतर परफ़ॉर्मेंस देता है. इसलिए, Directions API और Distance Matrix API का इस्तेमाल करने वाले ऐप्लिकेशन को Routes 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, ईटीए दिखाता है. साथ ही, यह 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 कन्वर्टर मिल सकते हैं. इनमें से किसी का भी इस्तेमाल किया जा सकता है.