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