Directions API (लेगसी) या Distance Matrix API (लेगसी) से माइग्रेट करना

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

इस गाइड में, Directions API या Distance Matrix API का इस्तेमाल करने वाले ऐप्लिकेशन को Routes API पर माइग्रेट करने का तरीका बताया गया है. Routes API के बारे में ज़्यादा जानने के लिए, प्रॉडक्ट की खास जानकारी देखें.

माइग्रेशन के लिए बिलिंग के सबसे सही तरीके

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

REST API एंडपॉइंट अपडेट करना

नए Routes API एंडपॉइंट इस्तेमाल करने के लिए, अपना कोड अपडेट करें

Directions API से

Directions API https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API https://routes.googleapis.com/directions/v2:computeRoutes

Distance Matrix API से

Distance Matrix API https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Routes API https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

यूआरएल पैरामीटर को एचटीटीपीएस अनुरोध के मुख्य हिस्से में इस्तेमाल करने के लिए बदलना

Directions API और Distance Matrix API की मदद से, कॉन्फ़िगरेशन प्रॉपर्टी को यूआरएल पैरामीटर के तौर पर HTTP GET अनुरोध में पास किया जाता है. उदाहरण के लिए, Directions API के लिए:

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

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

पॉलीलाइन-कोड वाले वेपॉइंट को जगह की जानकारी वाले वेपॉइंट में बदलना

वेपॉइंट को कोड में बदली गई पॉलीलाइन के तौर पर तय करने की सुविधा, Directions API (लेगसी) में उपलब्ध है. इससे यूआरएल में 16,384 वर्णों की सीमा में ज़्यादा से ज़्यादा वेपॉइंट शामिल किए जा सकते हैं. Routes API में इस सुविधा की ज़रूरत नहीं है, क्योंकि वेपॉइंट को REST या gRPC अनुरोध के मुख्य हिस्से में, अक्षांश/देशांतर निर्देशांक के तौर पर भेजा जा सकता है. उदाहरण के लिए, रूट मैट्रिक्स की गणना करें दस्तावेज़ में एचटीटीपी का उदाहरण देखें या इंटरमीडिएट वेपॉइंट तय करें दस्तावेज़ में इंटरमीडिएट वेपॉइंट तय करें देखें.

पैरामीटर बदलना

यहां दी गई टेबल में, Directions API और Distance Matrix API के उन पैरामीटर की सूची दी गई है जिनके नाम बदले गए हैं या जिनमें बदलाव किए गए हैं. इसके अलावा, उन पैरामीटर की सूची भी दी गई है जो GA रिलीज़ में काम नहीं करते. अगर इनमें से किसी भी पैरामीटर का इस्तेमाल किया जा रहा है, तो अपना कोड अपडेट करें.

अनुरोध के पैरामीटर से जुड़े कन्वर्ज़न

Directions या दूरी का मैट्रिक्स पैरामीटर Routes API पैरामीटर नोट
alternatives computeAlternativeRoutes
arrival_time arrivalTime यह सुविधा सिर्फ़ TRANSIT मोड में उपलब्ध है. साथ ही, इसे departureTime के साथ इस्तेमाल नहीं किया जा सकता.
avoid routeModifiers
departure_time departureTime arrivalTime के साथ इस्तेमाल नहीं किया जा सकता.
language languageCode यह सुविधा सिर्फ़ Compute Routes के लिए उपलब्ध है.
mode travelMode

GET यूआरएल क्वेरी पैरामीटर के बजाय, RouteTravelMode वैल्यू (computeRoutes के लिए DRIVE, TWO_WHEELER, WALK, TRANSIT, TRUCK या BICYCLE) का इस्तेमाल करके, computeRoutes या computeRouteMatrix एचटीटीपी POST JSON अनुरोध के मुख्य हिस्से में पास किया गया. TWO_WHEELER, TRANSIT, और TRUCK के लिए सहायता जोड़ी गई.
region regionCode
traffic_model trafficModel ज़्यादा जानें
transit_mode "travelMode": "TRANSIT" Directions API (लेगसी) में, बस, मेट्रो वगैरह के रूट में, यात्रा के एक ही मोड (उदाहरण के लिए, पैदल या बस, मेट्रो वगैरह) वाले ट्रिप के हर सेगमेंट को एक चरण माना जाता है. साथ ही, यात्रा के उस मोड के लिए अलग-अलग निर्देश, सबस्टेप में होते हैं. वहीं, Routes API में, यात्रा के सभी तरीकों के लिए, हर चरण में नेविगेशन का एक निर्देश होता है. इसलिए, नेविगेशन का हर निर्देश एक चरण होता है. यात्रा के एक ही मोड में कई चरणों के लिए, Routes API मेटाडेटा उपलब्ध कराता है. इसमें `stepsOverview` में, यात्रा के उस मोड के चरणों की खास जानकारी होती है. इस मेटाडेटा का अनुरोध करने के लिए, `routes.legs.stepsOverview` फ़ील्ड मास्क का इस्तेमाल करें. ज़्यादा जानें.
transit_routing_preference transitRoutingPreference ज़्यादा जानें
units units ज़्यादा जानें
waypoints intermediates एन्कोड की गई पॉलीलाइन के लिए सहायता हटा दी गई है.
optimize=true, वेपॉइंट के लिए "optimizeWaypointOrder": "true" ज़्यादा जानें

रिस्पॉन्स पैरामीटर कन्वर्ज़न

Directions या दूरी का मैट्रिक्स पैरामीटर Routes API पैरामीटर नोट
copyrights

जवाब में शामिल नहीं है. अपने उपयोगकर्ताओं को नतीजे दिखाते समय, आपको यह स्टेटमेंट शामिल करना होगा:

Powered by Google, ©YEAR Google

उदाहरण के लिए:

Powered by Google, ©2022 Google
distance distanceMeters दूरी सिर्फ़ मीटर में उपलब्ध है.
duration_in_traffic duration Routes API से हटा दिया गया है. इसके बजाय, duration का इस्तेमाल करें.
status यह सुविधा उपलब्ध नहीं है. एपीआई से रिपोर्ट की गई गड़बड़ियों के लिए, एचटीटीपी रिस्पॉन्स कोड का इस्तेमाल करें. ज़्यादा जानकारी के लिए, अनुरोध से जुड़ी गड़बड़ियों को मैनेज करना देखें.
geocoded_waypoints geocoding_results यह सुविधा सिर्फ़ Compute Routes के लिए उपलब्ध है. इसमें सिर्फ़ उन वेपॉइंट के लिए जियोकोडिंग के रिस्पॉन्स की जानकारी होती है जिन्हें पते के तौर पर बताया गया है.
bounds viewport
legs.end_address यह सुविधा उपलब्ध नहीं है.

ज़्यादा सटीक रूटिंग के लिए, निर्देशांकों के बजाय जगह के आईडी का इस्तेमाल करें. जगह के आईडी में ऐसा डेटा होता है जो रास्ते को सही ऐक्सेस पॉइंट पर स्नैप करता है.
legs.start_address यह सुविधा उपलब्ध नहीं है.
overview_polyline पॉलीलाइन
summary description
waypoint_order optimizedIntermediateWaypointIndex