Routes API को सितंबर 2022 में, सार्वजनिक तौर पर प्रीव्यू (प्री-जीए) के तौर पर रिलीज़ किया गया था. प्री-जीए ऑफ़र पर, Google Maps Platform की सेवा से जुड़ी खास शर्तें लागू होती हैं. ज़्यादा जानकारी के लिए, लॉन्च स्टेज के ब्यौरे देखें.
इस सेक्शन में, किसी ऐप्लिकेशन को प्रीव्यू रिलीज़ से जीए रिलीज़ में माइग्रेट करने का तरीका बताया गया है.
GA रिलीज़ में जोड़ी गई नई सुविधाएं
GA रिलीज़ में, ये नई सुविधाएं जोड़ी गई हैं. ये सुविधाएं, Preview में शामिल नहीं थीं:
जगह के आईडी और अक्षांश/देशांतर के निर्देशांक के साथ-साथ, अब GA रिलीज़ में किसी जगह की जानकारी दी जा सकती है. इसके लिए, इनका इस्तेमाल करें:
पते की स्ट्रिंग ("Chicago, IL" या "Darwin, NT, Australia")
उपयोगकर्ता अक्सर पते की स्ट्रिंग के ज़रिए पता डालता है. हालांकि, {product_name} को किसी रास्ते का हिसाब लगाने से पहले, पते की स्ट्रिंग को अक्षांश/देशांतर निर्देशांकों में बदलने के लिए, उसे अंदरूनी तौर पर जियोकोड करना होगा.
इसके अलावा,
regionCodeअनुरोध पैरामीटर के लिए सहायता जोड़ी गई है. इससे, किसी खास भौगोलिक क्षेत्र के लिए जियोकोड किए गए नतीजे दिखाने के लिए कहा जा सकता है.-
प्लस कोड, उन लोगों या जगहों के लिए मोहल्ले के पते की तरह होते हैं जिनका कोई पता नहीं होता. मोहल्ले के नाम और नंबर वाले पतों के बजाय, Plus Code अक्षांश और देशांतर पर आधारित होते हैं. इन्हें नंबर और अक्षरों के तौर पर दिखाया जाता है.
रास्तों की जानकारी देने वाले जवाब में अब
geocodingResultsकलेक्शन शामिल है. अनुरोध में मौजूद हर जगह (शुरुआत की जगह, मंज़िल या बीच का वेपॉइंट) के लिए, एपीआई जगह के आईडी की जानकारी खोजता है. यह जगह पते के स्ट्रिंग या Plus Code के तौर पर तय की गई थी. इस कलेक्शन के हर एलिमेंट में, किसी जगह से जुड़ा जगह का आईडी होता है. साथ ही, जगह के बारे में अतिरिक्त मेटाडेटा भी होता है. अनुरोध में मौजूद उन जगहों को अनदेखा किया जाता है जिन्हें जगह के आईडी या अक्षांश/देशांतर के निर्देशांक के तौर पर तय किया गया है.
झलक के तौर पर उपलब्ध मौजूदा सुविधाओं में बदलाव
अब आपको GA में इन सुविधाओं को साफ़ तौर पर चालू करना होगा. इसके लिए, अनुरोध में नया ऐरे extraComputations फ़ील्ड जोड़ें:
प्रीव्यू रिलीज़ में, आपने फ़ील्ड मास्क का इस्तेमाल करके, जवाब में इन सुविधाओं से जुड़ी जानकारी देने के लिए कहा था. अब आपको ये दोनों काम करने होंगे:
- इन सुविधाओं को चालू करने के लिए, नया
extraComputationsऐरे अनुरोध पैरामीटर सेट करें. - जवाब में जानकारी दिखाने के लिए, फ़ील्ड मास्क सेट करें.
मेरे लिए क्या जानना ज़रूरी है?
computeRouteMatrix के रिस्पॉन्स में अब ये फ़ील्ड शामिल नहीं किए जाएंगे. हालांकि, extraComputations को सेट करके इन्हें चालू किया जा सकता है:
travelAdvisory.tollInfo(टोल की जानकारी)
computeRoutes के जवाबों में अब ये फ़ील्ड शामिल नहीं किए जाएंगे. हालांकि, extraComputations को सेट करके इन्हें चालू किया जा सकता है:
routes.legs.travelAdvisory.tollInfo(टोल की जानकारी)routes.travelAdvisory.tollInfo(टोल की जानकारी)routes.travelAdvisory.fuelConsumptionMicroliters(ईंधन की खपत)routes.travelAdvisory.speedReadingIntervals(पॉलीलाइन पर ट्रैफ़िक)routes.legs.travelAdvisory.speedReadingIntervals(पॉलीलाइन पर ट्रैफ़िक)
मुझे क्या करना होगा?
टोल की जानकारी, ईंधन की खपत या पॉलीलाइन पर ट्रैफ़िक की जानकारी के लिए, जवाब वाले फ़ील्ड पाने के लिए, आपको नए अनुरोध वाले कलेक्शन फ़ील्ड, extraComputations को सेट करना होगा. इसमें इनमें से एक या उससे ज़्यादा वैल्यू शामिल होनी चाहिए:
टोल की जानकारी पाने के लिए, नए
extraComputationsऐरे फ़ील्ड को"TOLLS"पर सेट करें.ईंधन की खपत की जानकारी पाने के लिए, नए
extraComputationsऐरे फ़ील्ड को"FUEL_CONSUMPTION"पर सेट करें.पॉलीलाइन पर ट्रैफ़िक की जानकारी पाने के लिए, नए
extraComputationsऐरे फ़ील्ड को"TRAFFIC_ON_POLYLINE"पर सेट करें.