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

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

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

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

दिशा-निर्देश API से

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

दूरी के मैट्रिक्स एपीआई से

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

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

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

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

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

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

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

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

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

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

निर्देश या दूरी का मैट्रिक्स पैरामीटर रूट एपीआई पैरामीटर ज़रूरी जानकारी
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" दिशा-निर्देश API में, ट्रांज़िट रास्ते में, एक ही यात्रा मोड (उदाहरण के लिए, पैदल या सार्वजनिक परिवहन) वाली यात्रा के हर सेगमेंट को एक चरण माना जाता है. उस यात्रा मोड के लिए अलग-अलग दिशा-निर्देश, सबस्टेप में होते हैं. वहीं दूसरी ओर, रूट एपीआई में, हर तरह की यात्रा के लिए सिलसिलेवार निर्देश एक ही होते हैं. इसलिए, नेविगेशन के लिए दिया गया हर निर्देश एक चरण है. एक यात्रा के मोड में कई चरणों को पूरा करने के लिए, Routes API ऐसा मेटाडेटा उपलब्ध कराता है जिसमें उस यात्रा के मोड से जुड़े चरणों की खास जानकारी `stepOverview` में होती है. इस मेटाडेटा का अनुरोध करने के लिए, `routes.legs.stepOverview` फ़ील्ड मास्क का इस्तेमाल करें. ज़्यादा जानें.
transit_routing_preference transitRoutingPreference ज़्यादा जानें
units रूट मैट्रिक्स के लिए उपलब्ध नहीं है.
waypoints intermediates कोड में बदली गई पॉलीलाइन के लिए सहायता हटाई गई.
वेपॉइंट के लिए optimize=true "optimizeWaypointOrder": "true" ज़्यादा जानें

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

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

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

Powered by Google, ©YEAR Google

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

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