निर्देश एपीआई या दूरी का मैट्रिक्स एपीआई से माइग्रेट करना

इस गाइड में बताया गया है कि रूट एपीआई का इस्तेमाल करने के लिए, उन ऐप्लिकेशन को कैसे माइग्रेट करना चाहिए जो 'दिशा-निर्देश एपीआई' या 'दूरी मैट्रिक्स एपीआई' का इस्तेमाल करते हैं. Routes API के बारे में जानने के लिए, प्रॉडक्ट की खास जानकारी देखें.

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

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

निर्देश एपीआई से

दिशा-निर्देश एपीआई https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes एपीआई https://routes.googleapis.com/directions/v2:computeRoutes

डिस्टेंस मैट्रिक्स एपीआई से

दूरी का मैट्रिक्स एपीआई https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Routes एपीआई https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

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

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

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

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

पॉलीलाइन-एन्कोडेड वेपॉइंट को स्थान वेपॉइंट में बदलें

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

पैरामीटर बदलें

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

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

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

TWO_WHEELER और TRANSIT के लिए मदद जोड़ी गई.

region regionCode
traffic_model trafficModel ज़्यादा जानें
transit_mode "travelMode": "TRANSIT" Maps में, बस, मेट्रो वगैरह के रूट में, एक ही यात्रा के मोड (जैसे, पैदल या बस, मेट्रो वगैरह) वाली यात्रा के हर हिस्से को एक चरण माना जाता है. साथ ही, उस यात्रा के मोड के लिए, अलग-अलग निर्देशों को सबस्टेप में रखा जाता है. वहीं दूसरी ओर, Routes API में, हर तरह की यात्रा के लिए सिलसिलेवार तरीके से नेविगेशन के निर्देश दिए जाते हैं. इसलिए, नेविगेशन के लिए हर निर्देश एक चरण होता है. एक यात्रा वाले मोड में कई चरणों के लिए, Routes API मेटाडेटा उपलब्ध कराता है, जिसमें उस यात्रा मोड के लिए कदमों की खास जानकारी होती है. यह `stepsOverview` में है. इस मेटाडेटा के लिए अनुरोध करने के लिए, `routes.legs.stepsOverview` फ़ील्ड मास्क का इस्तेमाल करें. ज़्यादा जानें.
transit_routing_preference transitRoutingPreference ज़्यादा जानें
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 यह सिर्फ़ कंप्यूट रूट के साथ काम करता है. इसमें सिर्फ़ पतों के तौर पर दिए गए वेपॉइंट के लिए जियोकोडिंग रिस्पॉन्स की जानकारी है.
bounds viewport
legs.end_address यह सुविधा उपलब्ध नहीं है.
legs.start_address यह सुविधा उपलब्ध नहीं है.
overview_polyline पॉलीलाइन
summary description
waypoint_order optimizedIntermediateWaypointIndex