compute_routes टूल, यात्रा के किसी मोड के लिए, यात्रा शुरू करने की जगह और मंज़िल के बीच का रास्ता दिखाता है. जवाब में रास्ते की दूरी और लगने वाले समय की जानकारी शामिल होती है. डिफ़ॉल्ट रूप से, रास्तों का हिसाब लाइव ट्रैफ़िक के बिना लगाया जाता है.
Pro प्लान में, लाइव ट्रैफ़िक और ज़्यादा स्टॉप वाले रास्तों को ध्यान में रखकर रूटिंग की सुविधा मिलती है.
इस पेज पर, अनुरोध करने के विकल्पों के बारे में बताया गया है. इनमें Pro वर्शन के विकल्प भी शामिल हैं. साथ ही, यह भी बताया गया है कि जवाब में क्या शामिल होता है और अनुरोधों के लिए बिल कैसे भेजा जाता है. टूल के पूरे स्कीमा के लिए, compute_routes रेफ़रंस देखें.
अनुरोध करने के विकल्प
| विकल्प | ब्यौरा |
|---|---|
origin, destination |
ज़रूरी है. हर एक वेपॉइंट है: address (किसी व्यक्ति के लिए आसानी से पढ़ा जा सकने वाला पता या प्लस कोड), place_id या lat_lng. फ़ॉर्मैट को मिक्स किया जा सकता है. उदाहरण के लिए, शुरुआत की जगह के लिए पता और डेस्टिनेशन के लिए जगह का आईडी. |
travel_mode |
यात्रा का मोड: DRIVE (डिफ़ॉल्ट), WALK, BICYCLE या TRANSIT. WALK के रास्ते बीटा वर्शन में हैं. इसलिए, हो सकता है कि कभी-कभी आपको साफ़ तौर पर फ़ुटपाथ या पैदल चलने के रास्ते न दिखें. आपको अपने ऐप्लिकेशन में दिखाए जाने वाले पैदल चलने के सभी रास्तों के लिए, उपयोगकर्ता को यह चेतावनी दिखानी होगी. |
routing_preference |
रास्ते का हिसाब लगाने के लिए, ट्रैफ़िक डेटा का इस्तेमाल कैसे किया जाता है: ROUTING_PREFERENCE_TRAFFIC_UNAWARE (डिफ़ॉल्ट) या ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL, जो कि एक Pro विकल्प है. ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL का इस्तेमाल, WALK या BICYCLE के लिए नहीं किया जा सकता. ट्रैफ़िक के हिसाब से रूट तय करने की सुविधा देखें. |
intermediate_waypoints |
यात्रा शुरू करने की जगह और मंज़िल के बीच के स्टॉप. रास्ता, दिए गए क्रम में इन जगहों से होकर गुज़रता है. किसी अनुरोध में ज़्यादा से ज़्यादा 10 इंटरमीडिएट वेपॉइंट शामिल किए जा सकते हैं. इसके अलावा, Pro विकल्प के तौर पर 11 से 25 इंटरमीडिएट वेपॉइंट शामिल किए जा सकते हैं. अगर अनुरोध में 25 से ज़्यादा पते शामिल किए जाते हैं, तो INVALID_ARGUMENT गड़बड़ी का मैसेज दिखता है. बस, मेट्रो वगैरह के रास्तों में इंटरमीडिएट वेपॉइंट इस्तेमाल नहीं किए जा सकते. |
departure_time या arrival_time |
आरएफ़सी 3339 टाइमस्टैंप के तौर पर, यात्रा शुरू करने या मंज़िल पर पहुंचने का समय. ज़्यादा से ज़्यादा एक वैल्यू सेट करें. डिफ़ॉल्ट रूप से, यह मौजूदा समय पर सेट होता है. TRANSIT के लिए, समय को पिछले सात दिनों या आने वाले 100 दिनों तक सेट किया जा सकता है. यात्रा के अन्य तरीकों के लिए, समय को बीते हुए समय पर सेट नहीं किया जा सकता. साथ ही, इसे ज़्यादा से ज़्यादा 365 दिन आगे के लिए सेट किया जा सकता है. |
compute_alternative_routes |
true होने पर, जवाब में सुझाए गए रास्ते के साथ-साथ अन्य रास्ते भी शामिल होते हैं. हालांकि, ऐसा तब होता है, जब अन्य रास्ते उपलब्ध हों. डिफ़ॉल्ट रूप से, यह false पर सेट होता है. |
include_polyline |
true होने पर, जवाब में मौजूद हर रास्ते में encodedPolyline शामिल होता है. डिफ़ॉल्ट रूप से, यह false पर सेट होता है. |
location_bias |
अक्षांश और देशांतर, जो टेक्स्ट वेपॉइंट को हल करने के तरीके को प्रभावित करते हैं. उदाहरण के लिए, किसी पते को साफ़ तौर पर समझने के लिए. |
Pro वर्शन के विकल्प
दो विकल्पों में से Pro एसकेयू को चुनें. इनमें से किसी एक या दोनों का इस्तेमाल करने वाले अनुरोध के लिए, Pro SKU के तहत बिल भेजा जाता है:
| Pro वर्शन | इसका इस्तेमाल कब करें |
|---|---|
routing_preference को ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL पर सेट करें |
उपयोगकर्ता ने ट्रैफ़िक, भीड़भाड़ या मौजूदा ट्रैफ़िक के हिसाब से यात्रा में लगने वाले समय के बारे में पूछा हो. ट्रैफ़िक के हिसाब से रूटिंग देखें. |
11 से 25 intermediate_waypoints |
यात्रा शुरू करने की जगह और मंज़िल के बीच, 10 से ज़्यादा स्टॉप हों. |
अन्य सभी विकल्पों के लिए, Essentials एसकेयू के तहत बिलिंग की जाती है. इनमें यात्रा मोड, समय, वैकल्पिक रास्ते, पॉलीलाइन, और जगह के हिसाब से नतीजे दिखाने की सुविधा शामिल है.
ट्रैफ़िक के हिसाब से रूटिंग
डिफ़ॉल्ट रूप से, रास्तों का हिसाब ट्रैफ़िक की लाइव स्थिति (ROUTING_PREFERENCE_TRAFFIC_UNAWARE) के बिना लगाया जाता है. इस सेटिंग में इंतज़ार का समय सबसे कम होता है. यह उन अनुरोधों के लिए सही है जहां ट्रैफ़िक मायने नहीं रखता या लागू नहीं होता. जैसे, पैदल चलने के रास्ते या रफ़ प्लानिंग.
ट्रैफ़िक डेटा उपलब्ध होने पर, ट्रैफ़िक की मौजूदा स्थिति के हिसाब से रूट और उसमें लगने वाले समय का हिसाब लगाने के लिए, routing_preference को ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL पर सेट करें. इसका इस्तेमाल तब करें, जब उपयोगकर्ता पूछे कि अभी ड्राइव करने में कितना समय लगेगा. TRANSIT रास्तों के लिए, यह सेटिंग रीयल-टाइम ट्रांज़िट डेटा का इस्तेमाल करती है. जैसे, देरी और रद्द होने की जानकारी, अगर उपलब्ध हो. यह WALK या BICYCLE रूट के साथ काम नहीं करता. इन रूट के लिए किए गए अनुरोधों पर, INVALID_ARGUMENT गड़बड़ी का मैसेज दिखता है. यह Pro वर्शन की सुविधा है. इसलिए, इस अनुरोध के लिए Pro SKU के तहत बिलिंग की जाती है. इस विकल्प से, वीडियो लोड होने में लगने वाला समय भी बढ़ जाता है.
Restricted GA के दौरान, अगर आपका प्रोजेक्ट Pro की अनुमति वाली सूची में नहीं है, तो इस विकल्प को ROUTING_PREFERENCE_TRAFFIC_UNAWARE के तौर पर माना जाता है. ज़्यादा जानकारी के लिए,
सीमित तौर पर उपलब्ध होने के दौरान Gemini Advanced की सुविधाएं देखें.
उदाहरण
यहां दिए गए अनुरोध में, ट्रैफ़िक की जानकारी देने वाले ड्राइविंग रूट के लिए अनुरोध किया गया है. इसमें एक इंटरमीडिएट स्टॉप और एक एन्कोड की गई पॉलीलाइन शामिल है. इसका बिल, Pro एसकेयू के तहत जनरेट किया जाता है:
{
"method": "tools/call",
"params": {
"name": "compute_routes",
"arguments": {
"origin": {"address": "Ferry Building, San Francisco, CA"},
"destination": {"address": "Golden Gate Park, San Francisco, CA"},
"intermediate_waypoints": [
{"address": "Palace of Fine Arts, San Francisco, CA"}
],
"travel_mode": "DRIVE",
"routing_preference": "ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL",
"include_polyline": true
}
},
"jsonrpc": "2.0",
"id": 1
}
जवाब
जवाब में routes[] शामिल हैं. इन्हें सबसे ज़्यादा से लेकर सबसे कम सुझाव वाले क्रम में लगाया गया है. जब तक compute_alternative_routes की वैल्यू true नहीं होती, तब तक सिर्फ़ एक रास्ता दिखाया जाता है. हर रूट में ये शामिल हैं:
distanceMeters: रास्ते की दूरी, मीटर में.duration: रास्ते को तय करने में लगने वाला समय.ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMALकी मदद से, ट्रैफ़िक के हाल के हिसाब से यात्रा में लगने वाले समय का हिसाब लगाया जाता है.encodedPolyline: रास्ते का पाथ, एन्कोड की गई पॉलीलाइन के तौर पर दिखता है. ऐसा तब होता है, जबinclude_polylineकी वैल्यूtrueहो. Google Maps Platform के अन्य एपीआई के साथ, इसका इस्तेमाल मैप पर रास्ता दिखाने के लिए किया जा सकता है.attribution: वह एट्रिब्यूशन जो आपको रास्ते के साथ दिखाना होगा. एट्रिब्यूशन से जुड़ी ज़रूरी शर्तें देखें.
सीमित उपलब्धता के दौरान Pro के विकल्प
सीमित GA के दौरान, Pro के विकल्प सिर्फ़ उन प्रोजेक्ट के लिए उपलब्ध होते हैं जो Pro की अनुमति वाली सूची में शामिल होते हैं. अगर आपका प्रोजेक्ट अब तक अनुमति वाली सूची में शामिल नहीं है, तो:
ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMALकोROUTING_PREFERENCE_TRAFFIC_UNAWAREमाना जाता है. साथ ही, अनुरोध के लिए Essentials SKU के तहत बिल भेजा जाता है.- अगर किसी अनुरोध में 10 से ज़्यादा इंटरमीडिएट वेपॉइंट शामिल हैं, तो
INVALID_ARGUMENTगड़बड़ी का मैसेज दिखता है. इसमें बताया जाता है कि "ज़्यादा से ज़्यादा 10 इंटरमीडिएट वेपॉइंट इस्तेमाल किए जा सकते हैं."
ऐक्सेस का अनुरोध करने के लिए, सीमित GA के दौरान Pro के विकल्प देखें.
बिलिंग और कोटा
हर compute_routes अनुरोध, बिल करने लायक एक इवेंट होता है:
- अगर किसी अनुरोध में Pro वर्शन के किसी भी विकल्प का इस्तेमाल नहीं किया जाता है, तो उसका बिल Essentials SKU के तहत जनरेट किया जाता है.
- Pro विकल्प का इस्तेमाल करने वाले अनुरोध के लिए, Pro SKU के तहत बिल किया जाता है. एक ही अनुरोध में दोनों Pro मॉडल इस्तेमाल करने पर, शुल्क में कोई बदलाव नहीं होता. Pro प्लान की कीमत जानने के लिए, Essentials, Pro, और Google Maps से जानकारी लेने की सुविधा की तुलना करें.
वैकल्पिक रास्तों, पॉलीलाइन, यात्रा शुरू करने या पहुंचने के समय या यात्रा के किसी अन्य मोड का अनुरोध करने से, एसकेयू में कोई बदलाव नहीं होता.
compute_routes के लिए, हर प्रोजेक्ट के हिसाब से हर मिनट में 300 क्वेरी की जा सकती हैं. यह कोटा, दोनों एसकेयू के लिए शेयर किया जाता है. कीमत जानने के लिए,
कीमत की मुख्य टेबल और
भारत के लिए कीमत की टेबल देखें.
सीमाएं
- किसी अनुरोध में ज़्यादा से ज़्यादा 25 इंटरमीडिएट वेपॉइंट शामिल किए जा सकते हैं. 11 से 25 वेपॉइंट शामिल करने की सुविधा, Pro वर्शन में उपलब्ध है. इससे ज़्यादा आइटम होने पर,
INVALID_ARGUMENTगड़बड़ी का मैसेज दिखता है. - बस, मेट्रो वगैरह के रास्तों में इंटरमीडिएट वेपॉइंट इस्तेमाल नहीं किए जा सकते. अगर ट्रांज़िट के अनुरोध में इंटरमीडिएट वेपॉइंट शामिल हैं, तो
INVALID_ARGUMENTगड़बड़ी का मैसेज दिखता है. - पैदल या साइकल से जाने के रास्तों के लिए,
ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMALका इस्तेमाल नहीं किया जा सकता. - बस, मेट्रो वगैरह के रास्तों के लिए, जाने और पहुंचने का समय, पिछले सात दिनों या आने वाले 100 दिनों तक का हो सकता है. यात्रा के अन्य साधनों के लिए, बीते समय की तारीख नहीं चुनी जा सकती. साथ ही, आने वाले समय की तारीख 365 दिनों से ज़्यादा की नहीं हो सकती.
- वेपॉइंट के निर्देशांक, मान्य भौगोलिक सीमाओं के अंदर होने चाहिए. जैसे, अक्षांश -90 से 90 और देशांतर -180 से 180 के बीच होना चाहिए.
- यह टूल, मोड़-दर-मोड़ निर्देश, लेग या ट्रांज़िट लाइन की जानकारी नहीं दिखाता.