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`	यह सुविधा उपलब्ध नहीं है.	ज़्यादा सटीक राउटिंग के लिए, निर्देशांकों के बजाय जगह के आईडी का इस्तेमाल करें. जगह के आईडी में ऐसा डेटा होता है जो रास्ते को सही ऐक्सेस पॉइंट पर ले जाता है. अगर आपने पते से शुरुआत की है: किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा या Geocoding API का इस्तेमाल करके, उसे जगह के आईडी में बदलें. अगर आपने निर्देशांकों से शुरुआत की है: जगह की ज़्यादा सटीक जानकारी देने के लिए, मंज़िलें खोजें सुविधा का इस्तेमाल करें. सिर्फ़ निर्देशांकों से पता पाना मुश्किल हो सकता है. इससे गलत स्नैपिंग हो सकती है. Routes API, निर्देशांकों को पतों में नहीं बदलता.
`legs.start_address`	यह सुविधा उपलब्ध नहीं है.
`overview_polyline`	पॉलीलाइन
`summary`	`description`
`waypoint_order`	`optimizedIntermediateWaypointIndex`