इस गाइड में, दोनों में से किसी एक का इस्तेमाल करने वाले ऐप्लिकेशन को माइग्रेट करने का तरीका बताया गया है दिशा-निर्देश 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 |
रूट एपीआई | https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix |
एचटीटीपीएस अनुरोध के मुख्य हिस्से का इस्तेमाल करने के लिए, यूआरएल पैरामीटर को बदलना
डायरेक्शन एपीआई और डिस्टेंस मैट्रिक्स एपीआई की मदद से,
किसी HTTP GET
अनुरोध के लिए, कॉन्फ़िगरेशन प्रॉपर्टी को यूआरएल पैरामीटर के तौर पर पास करें. इसके लिए
उदाहरण के लिए, निर्देश API के लिए:
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API का इस्तेमाल करके, अनुरोध के मुख्य हिस्से या हेडर में पैरामीटर पास किए जाते हैं
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 |
|
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" |
ज़्यादा जानें |
रिस्पॉन्स पैरामीटर के कन्वर्ज़न
निर्देश या दूरी का मैट्रिक्स पैरामीटर | रूट एपीआई पैरामीटर | नोट |
---|---|---|
copyrights |
यह फ़ाइल जवाब में शामिल नहीं है. आपको नीचे दी गई जानकारी शामिल करनी होगी अपने उपयोगकर्ताओं को नतीजे दिखाते समय स्टेटमेंट:
उदाहरण के लिए:
|
|
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 |