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

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

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

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

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

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 रिलीज़ में काम नहीं करते. अगर इनमें से किसी पैरामीटर का इस्तेमाल किया जा रहा है, तो अपने कोड को अपडेट करें.

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

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

TWO_WHEELER और TRANSIT के लिए सहायता जोड़ी गई.
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" ज़्यादा जानें

जवाब के पैरामीटर के आधार पर कन्वर्ज़न

रास्ते या दूरी के मैट्रिक्स का पैरामीटर 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 polyline
summary description
waypoint_order optimizedIntermediateWaypointIndex