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

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

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

मुख्य सुधार

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

अनुरोध की सीमाओं में बढ़ोतरी

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

अनुरोधों के जवाब जल्दी मिलना

कंप्यूट रूट मैट्रिक्स की सुविधा से, इंतज़ार का समय कम करने में ये सुधार मिलते हैं:

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

रूटिंग से जुड़े सुधार

कंप्यूट रूट की सुविधा, रूटिंग से जुड़े इन सुधारों को उपलब्ध कराती है:

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

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

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

Routes API आपके अनुरोधों में फ़ील्ड मास्क का इस्तेमाल करना ज़रूरी है, ताकि यह बताया जा सके कि आपको रिस्पॉन्स में कौनसे फ़ील्ड चाहिए. फ़ील्ड मास्किंग की मदद से, यह पक्का किया जाता है कि आपने ज़रूरत से ज़्यादा डेटा का अनुरोध न किया हो. इससे, डेटा प्रोसेस करने में लगने वाले समय और बिलिंग शुल्कों से बचा जा सकता है.
इस बारे में ज़्यादा जानने के लिए, रिपोर्ट में दिखाने के लिए फ़ील्ड चुनना लेख पढ़ें.
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 के मोबाइल ऐप्लिकेशन में किया जाता है.

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

मुख्य अंतर

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

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

Routes API अपने ऐप्लिकेशन के लिए, एपीआई कंसोल में सिर्फ़ एक सेवा चालू करें, ताकि आपके पास Compute Routes और Compute Route Matrix का इस्तेमाल करने का विकल्प हो.
इस बारे में ज़्यादा जानने के लिए, Google API कंसोल में सेट अप करना लेख पढ़ें.
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
ट्रैफ़िक की जानकारी के बिना, समय के हिसाब से ETA.

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 रिस्पॉन्स प्रॉपर्टी का इस्तेमाल किया जाता है.

पॉलीलाइन के बीच में रुकने की जगहें

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

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

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

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

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

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

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