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

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

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

मुख्य सुधार

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

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

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

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

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

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

रूटिंग को बेहतर किया गया

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

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

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

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

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

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

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

ज़्यादा जानकारी के लिए, वीडियो स्ट्रीम होने और उसके दिखने के समय का अंतर बनाम क्वालिटी कॉन्फ़िगर करना देखें.

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

रूट कंप्यूटेशन की तुलना

नीचे दी गई टेबल में, Routes API और दिशा-निर्देश एपीआई और डिस्टेंस मैट्रिक्स एपीआई सेवाओं के बीच रूटिंग के विकल्पों की तुलना की गई है.

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

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

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

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

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

मुख्य अंतर

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

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

रूट एपीआई अपने ऐप्लिकेशन के लिए, एपीआई कंसोल में सिर्फ़ एक सेवा चालू करें, ताकि कंप्यूट रूट और कंप्यूट रूट मैट्रिक्स इस्तेमाल किया जा सके.
ज़्यादा जानकारी के लिए, Google API कंसोल में सेट अप करें देखें.
दिशा-निर्देशों का एपीआई
दूरी का मैट्रिक्स एपीआई 		दो सेवाएं चालू करें: API Console में, दिशा-निर्देशों के लिए एपीआई और डिस्टेंस मैट्रिक्स एपीआई को अलग-अलग सेवाओं के तौर पर.

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

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

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

रूट एपीआई, ETA दिखाता है. साथ ही, duration रिस्पॉन्स प्रॉपर्टी का इस्तेमाल, दिशा-निर्देश एपीआई और डिस्टेंस मैट्रिक्स एपीआई सेवाओं से अलग तरीके से करता है. इस जानकारी का इस्तेमाल नीचे दी गई टेबल में किया गया है.

ETA का टाइप Routes API दिशा-निर्देशों का एपीआई
दूरी का मैट्रिक्स एपीआई
ट्रैफ़िक की जानकारी नहीं, समय पर निर्भर ईटीए.

TRAFFIC_UNAWARE का इस्तेमाल करके सेट करें.

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

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

  • duration रिस्पॉन्स प्रॉपर्टी में मौजूद ETA.
  • duration_in_traffic रिस्पॉन्स प्रॉपर्टी नहीं दिखाई जाती.
रीयल-टाइम ट्रैफ़िक को ध्यान में रखकर बनाया गया ETA.

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

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

अनुरोध में departure_time का इस्तेमाल करके सेट करें.

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

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

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

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

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

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

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

रिस्पॉन्स फ़ॉर्मैट के तौर पर एक्सएमएल

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