इस गाइड में बताया गया है कि रूट एपीआई का इस्तेमाल करने के लिए, उन ऐप्लिकेशन को कैसे माइग्रेट करना चाहिए जो 'दिशा-निर्देश एपीआई' या 'दूरी मैट्रिक्स एपीआई' का इस्तेमाल करते हैं. 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 |
|
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 |
जवाब में शामिल नहीं है. अपने उपयोगकर्ताओं को नतीजे दिखाते समय, आपको यह स्टेटमेंट शामिल करना होगा:
उदाहरण के लिए:
|
|
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 |