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

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

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
Routes API https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

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

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

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

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

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

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

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

नीचे दी गई टेबल में पैरामीटर दिशा-निर्देश एपीआई और दूरी मैट्रिक्स 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" दिशा-निर्देश 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 रूट एपीआई से हटाया गया, duration का इस्तेमाल करें.
status यह सुविधा उपलब्ध नहीं है. एपीआई से मिली गड़बड़ियों के लिए, एचटीटीपी रिस्पॉन्स कोड का इस्तेमाल करें. अनुरोध से जुड़ी गड़बड़ियां मैनेज करना देखें हमारा वीडियो देखें.
geocoded_waypoints geocoding_results यह सिर्फ़ Compute Routes के लिए काम करता है. इसमें सिर्फ़ पते के तौर पर बताए गए वेपॉइंट के लिए जियोकोडिंग जवाब शामिल होता है.
bounds viewport
legs.end_address यह सुविधा उपलब्ध नहीं है.
legs.start_address यह सुविधा उपलब्ध नहीं है.
overview_polyline polyline
summary description
waypoint_order optimizedIntermediateWaypointIndex