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 फ़ॉर्मैट में बदलने वाले टूल मिल सकते हैं. इनमें से किसी टूल का इस्तेमाल करके, अपने हिसाब से फ़ॉर्मैट बदला जा सकता है.