'झलक देखें' रिलीज़ से माइग्रेट करें

Routes API को सितंबर 2022 में, सार्वजनिक तौर पर झलक (प्री-जीए) के तौर पर रिलीज़ किया गया था. Pre-GA के तहत आने वाले प्रॉडक्ट और सुविधाओं पर, Google Maps Platform की सेवा की खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च के चरणों की जानकारी देखें.

इस सेक्शन में, किसी ऐप्लिकेशन को झलक वाली रिलीज़ से GA रिलीज़ पर माइग्रेट करने का तरीका बताया गया है.

GA रिलीज़ में जोड़ी गई नई सुविधाएं

GA रिलीज़ में ये नई सुविधाएं जोड़ी गई हैं, जो झलक में शामिल नहीं थीं:

  • प्लेस आईडी और अक्षांश/देशांतर के निर्देशांक के साथ-साथ, GA रिलीज़ में अब इनका इस्तेमाल करके जगह की जानकारी दी जा सकती है:

    • पते की स्ट्रिंग ("मुंबई, भारत" या "मुंबई, महाराष्ट्र, भारत")

      आम तौर पर, उपयोगकर्ता पते की जानकारी डालने के लिए, पता स्ट्रिंग का इस्तेमाल करता है. हालांकि, {product_name} को सबसे पहले पते की स्ट्रिंग को अंदरूनी तौर पर जियोकोड करना होगा, ताकि उसे अक्षांश/देशांतर निर्देशांक में बदला जा सके. इसके बाद ही, रास्ते का हिसाब लगाया जा सकता है.

      इसके अलावा, regionCode अनुरोध पैरामीटर के लिए सहायता जोड़ी गई है. इससे, किसी खास भौगोलिक इलाके के लिए, जियोकोड किए गए नतीजे दिखाने के लिए कहा जा सकता है.

    • प्लस कोड

      Plus Code, उन लोगों या जगहों के लिए मोहल्ले के पते की तरह होते हैं जिनका कोई असल पता नहीं होता. Plus Code, अक्षांश और देशांतर पर आधारित होते हैं. इन्हें सड़क के नाम और संख्याओं वाले पतों के बजाय, संख्याओं और अक्षरों के तौर पर दिखाया जाता है.

  • compute routes response में अब geocodingResults कलेक्शन शामिल है. अनुरोध में बताई गई हर जगह (ऑरिजिन, डेस्टिनेशन या इंटरमीडिएट वेपॉइंट) के लिए, एपीआई जगह का आईडी लुकअप करता है. जगह की जानकारी को पते की स्ट्रिंग या Plus कोड के तौर पर दिया गया हो. इस कलेक्शन के हर एलिमेंट में, जगह के बारे में अतिरिक्त मेटाडेटा के साथ-साथ, जगह का प्लेस आईडी भी होता है. अनुरोध में, जगह के आईडी या अक्षांश/देशांतर के निर्देशांक के तौर पर बताई गई जगहों को अनदेखा कर दिया जाता है.

झलक देखने की मौजूदा सुविधाओं में बदलाव

अब आपको अनुरोध में नया कलेक्शन extraComputations फ़ील्ड जोड़कर, GA में इन सुविधाओं को साफ़ तौर पर चालू करना होगा:

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

  • इन सुविधाओं को चालू करने के लिए, नया extraComputations कलेक्शन अनुरोध पैरामीटर सेट करें.
  • रिस्पॉन्स में जानकारी दिखाने के लिए, फ़ील्ड मास्क सेट करें.

मेरे लिए क्या जानना ज़रूरी है?

extraComputations सेटिंग की मदद से साफ़ तौर पर चालू किए जाने तक, ये फ़ील्ड computeRouteMatrix के रिस्पॉन्स में शामिल नहीं किए जाएंगे:

  • travelAdvisory.tollInfo (टोल की जानकारी)

extraComputations सेटिंग की मदद से साफ़ तौर पर चालू किए जाने तक, ये फ़ील्ड computeRoutes रिस्पॉन्स में शामिल नहीं किए जाएंगे:

  • routes.legs.travelAdvisory.tollInfo(टोल की जानकारी)
  • routes.travelAdvisory.tollInfo(टोल की जानकारी)
  • routes.travelAdvisory.fuelConsumptionMicroliters(ईंधन की खपत)
  • routes.travelAdvisory.speedReadingIntervals(पॉलीलाइन पर ट्रैफ़िक)
  • routes.legs.travelAdvisory.speedReadingIntervals(पॉलीलाइन पर ट्रैफ़िक)

मुझे क्या करना होगा?

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