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

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

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

अहम सुधार

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

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

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

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

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

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

रूटिंग बेहतर बनाने की सुविधा

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

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

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

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

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

ट्रैफ़िक के लिए रूट का बेहतर कंप्यूटेशन

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

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

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

रूट की गणना की तुलना

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

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

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

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

ईटीए रिस्पॉन्स में अंतर

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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