रास्तों का हिसाब लगाना

compute_routes टूल, यात्रा के किसी मोड के लिए, यात्रा शुरू करने की जगह और मंज़िल के बीच का रास्ता दिखाता है. जवाब में रास्ते की दूरी और लगने वाले समय की जानकारी शामिल है. डिफ़ॉल्ट रूप से, रास्तों का हिसाब लाइव ट्रैफ़िक के बिना लगाया जाता है. Pro में, लाइव ट्रैफ़िक और ज़्यादा स्टॉप वाले रास्तों को ध्यान में रखकर रूटिंग की सुविधा मिलती है.

compute_routes को एमसीपी सर्वर या computeRoutes REST तरीके से कॉल किया जा सकता है. इस पेज पर, अनुरोध करने के विकल्पों के बारे में बताया गया है. इनमें Pro वर्शन के विकल्प भी शामिल हैं. साथ ही, यह भी बताया गया है कि जवाब में क्या शामिल होता है और अनुरोधों के लिए बिल कैसे भेजा जाता है. पूरे स्कीमा के लिए, compute_routes एमसीपी रेफ़रंस और computeRoutes REST रेफ़रंस देखें.

अनुरोध करने के विकल्प

यहां दी गई टेबल में, 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 वर्शन के विकल्प

इन दोनों विकल्पों में से, Maps Grounding Pro SKU को चुनें. इनमें से किसी एक या दोनों का इस्तेमाल करने वाले अनुरोध के लिए, 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 के तहत बिलिंग की जाती है. इस विकल्प से, विज्ञापन लोड होने में लगने वाला समय भी बढ़ जाता है.

उदाहरण

एमसीपी के इस अनुरोध में, ट्रैफ़िक की जानकारी देने वाले ड्राइविंग रूट के बारे में पूछा गया है. इसमें एक इंटरमीडिएट स्टॉप और एन्कोड की गई पॉलीलाइन शामिल है. इसका बिल, 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
}

नीचे दिया गया उदाहरण, computeRoutes REST तरीके को वही अनुरोध भेजता है:

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-d '{
  "origin": {"address": "Ferry Building, San Francisco, CA"},
  "destination": {"address": "Golden Gate Park, San Francisco, CA"},
  "intermediateWaypoints": [
    {"address": "Palace of Fine Arts, San Francisco, CA"}
  ],
  "travelMode": "DRIVE",
  "routingPreference": "ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL",
  "includePolyline": true
}' \
"https://mapstools.googleapis.com/v1:computeRoutes"

API_KEY को अपने एपीआई पासकोड से बदलें.

जवाब

जवाब में routes[] शामिल हैं. इन्हें सबसे ज़्यादा से लेकर सबसे कम सुझाव वाले क्रम में लगाया गया है. सिर्फ़ एक रास्ता दिखाया जाता है. हालांकि, अगर compute_alternative_routes की वैल्यू true है, तो एक से ज़्यादा रास्ते दिखाए जा सकते हैं. हर रूट में ये शामिल हैं:

  • distanceMeters: रास्ते की दूरी, मीटर में.
  • duration: रास्ते को तय करने में लगने वाला समय. ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL के साथ, अवधि ट्रैफ़िक का हाल के हिसाब से तय की जाती है.
  • encodedPolyline: रास्ते का पाथ, एन्कोड की गई पॉलीलाइन के तौर पर दिखता है. ऐसा तब होता है, जब include_polyline की वैल्यू true हो. Google Maps Platform के अन्य एपीआई के साथ, इसका इस्तेमाल मैप पर रास्ता दिखाने के लिए किया जा सकता है.
  • retrievalToken: DRIVE रास्तों के लिए दिखाया गया एक ओपेक टोकन (10 मिनट के लिए मान्य). इसे search_along_route को पास किया जा सकता है, ताकि वेपॉइंट को फिर से भेजे बिना उस रास्ते पर मौजूद जगहों को ढूंढा जा सके.
  • attribution: वह एट्रिब्यूशन जो आपको रास्ते के साथ दिखाना होगा. जानकारी के स्रोत से जुड़ी ज़रूरी शर्तें देखें.

बिलिंग और कोटा

compute_routes के हर अनुरोध के लिए शुल्क लिया जाता है:

  • जिस अनुरोध में Pro के किसी भी विकल्प का इस्तेमाल नहीं किया जाता है उसका बिल, Maps Grounding Essentials SKU के तहत जनरेट किया जाता है.
  • Pro विकल्प का इस्तेमाल करने वाले अनुरोध के लिए, Maps Grounding Pro SKU के तहत बिल भेजा जाता है. एक ही अनुरोध में Pro के दोनों विकल्पों का इस्तेमाल करने पर, शुल्क में कोई बदलाव नहीं होता. Pro प्लान की क़ीमत जानने के लिए, Essentials, Pro, और Google Maps से जानकारी लेने की सुविधा की तुलना करना लेख पढ़ें.

वैकल्पिक रास्तों, पॉलीलाइन, यात्रा शुरू करने या पहुंचने के समय या यात्रा के किसी अन्य मोड का अनुरोध करने पर, एसकेयू नहीं बदलता.

compute_routes के लिए, हर प्रोजेक्ट के लिए हर मिनट 300 क्वेरी का कोटा होता है. इसे दोनों SKU शेयर करते हैं. कीमत जानने के लिए, कीमत की मुख्य टेबल और भारत के लिए कीमत की टेबल देखें.

सीमाएं

  • किसी अनुरोध में ज़्यादा से ज़्यादा 25 इंटरमीडिएट वेपॉइंट शामिल किए जा सकते हैं. 11 से 25 वेपॉइंट शामिल करने का विकल्प, Pro वर्शन में उपलब्ध है. इससे ज़्यादा आइटम होने पर, INVALID_ARGUMENT गड़बड़ी का मैसेज दिखता है.
  • बस, मेट्रो वगैरह के रास्तों में इंटरमीडिएट वेपॉइंट शामिल नहीं किए जा सकते. इंटरमीडिएट वेपॉइंट के साथ ट्रांज़िट का अनुरोध करने पर, INVALID_ARGUMENT गड़बड़ी का मैसेज दिखता है.
  • पैदल या साइकल से जाने के रास्तों के लिए, ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL का इस्तेमाल नहीं किया जा सकता.
  • बस, मेट्रो वगैरह के रास्तों के लिए, जाने और पहुंचने का समय पिछले सात दिनों या आने वाले 100 दिनों तक का हो सकता है. यात्रा के अन्य साधनों के लिए, तारीखें बीते समय की नहीं होनी चाहिए. साथ ही, ये तारीखें 365 दिन बाद तक की हो सकती हैं.
  • वेपॉइंट के निर्देशांक, मान्य भौगोलिक सीमाओं के अंदर होने चाहिए. जैसे, अक्षांश -90 से 90 और देशांतर -180 से 180 के बीच होना चाहिए.
  • यह टूल, मोड़-दर-मोड़ निर्देश, लेग या बस, मेट्रो वगैरह की लाइन की जानकारी नहीं दिखाता.