Method: computeRoutes

यह यात्रा के लिए अनुरोध किए गए मोड के हिसाब से, यात्रा शुरू करने की जगह और मंज़िल के बीच का मुख्य रास्ता दिखाता है.

एचटीटीपी अनुरोध

POST https://mapstools.googleapis.com/v1alpha:computeRoutes

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode),
  "intermediateWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "routingPreference": enum (RoutingPreference),
  "locationBias": {
    object (LatLng)
  },
  "includePolyline": boolean,
  "computeAlternativeRoutes": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "departureTime": string,
  "arrivalTime": string
  // End of mutually exclusive fields.
}
फ़ील्ड
origin

object (Waypoint)

ज़रूरी है. यात्रा शुरू होने की जगह का वेपॉइंट.
destination

object (Waypoint)

ज़रूरी है. मंज़िल का वेपॉइंट.
travelMode

enum (RouteTravelMode)

ज़रूरी नहीं. इससे परिवहन के साधन का पता चलता है.
intermediateWaypoints[]

object (Waypoint)

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

रास्ते में 10 से ज़्यादा वेपॉइंट तय करने पर, ज़्यादा शुल्क और ज़्यादा इंतज़ार का समय लगेगा. travelMode के TRANSIT होने पर, इंटरमीडिएट वेपॉइंट का इस्तेमाल नहीं किया जा सकता.
routingPreference

enum (RoutingPreference)

ज़रूरी नहीं. इससे यह तय होता है कि रास्ते का हिसाब लगाने के लिए, ट्रैफ़िक डेटा का इस्तेमाल कैसे किया जाए. travelMode के WALK या BICYCLE होने पर, ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL का इस्तेमाल नहीं किया जा सकता. TRANSIT के लिए, यह रीयल-टाइम में बस, मेट्रो वगैरह का डेटा दिखाता है. जैसे, देरी और रद्द होने की जानकारी.
locationBias

object (LatLng)

ज़रूरी नहीं. वह जगह जिसके हिसाब से खोज के नतीजे दिखाए जाएंगे. उदाहरण के लिए, वेपॉइंट टेक्स्ट क्वेरी को साफ़ तौर पर समझने के लिए.
includePolyline

boolean

ज़रूरी नहीं. जवाब में दिए गए रास्तों में, एन्कोड की गई पॉलीलाइन को शामिल करना है या नहीं. डिफ़ॉल्ट रूप से, यह false पर सेट होता है. true पर सेट होने पर, Route.encoded_polyline दिखता है.
computeAlternativeRoutes

boolean

ज़रूरी नहीं. सुझाए गए रास्ते के अलावा, अन्य रास्तों का हिसाब लगाना है या नहीं. यह डिफ़ॉल्ट रूप से, 'गलत' पर सेट होता है. इस मामले में, सिर्फ़ सुझाया गया रास्ता दिखता है. इस पैरामीटर को true पर सेट करने पर, उपलब्ध सभी रास्ते दिखाए जाते हैं. हालांकि, ऐसा हो सकता है कि हर अनुरोध के लिए वैकल्पिक रास्ते उपलब्ध न हों.
इससे पता चलता है कि शुरुआती जगह से कब निकलना है या आखिरी वेपॉइंट पर कब पहुंचना है. अगर कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से इसकी वैल्यू मौजूदा समय पर सेट होती है. TRANSIT के लिए, समय ज़्यादा से ज़्यादा सात दिन पहले और ज़्यादा से ज़्यादा 100 दिन बाद का होना चाहिए. यात्रा के अन्य तरीकों के लिए, समय बीत चुका नहीं होना चाहिए. साथ ही, यह आने वाले समय में ज़्यादा से ज़्यादा 365 दिनों का होना चाहिए. यहां उन फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
departureTime

string (Timestamp format)

ज़रूरी नहीं. इससे पता चलता है कि रास्ते का हिसाब, निकलने के समय के आधार पर लगाया जाना चाहिए.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
arrivalTime

string (Timestamp format)

ज़रूरी नहीं. इससे पता चलता है कि रास्ते का हिसाब, पहुंचने के समय के आधार पर लगाया जाना चाहिए.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
एक-दूसरे से अलग फ़ील्ड का आखिरी हिस्सा.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में ComputeRoutesResponse का एक इंस्टेंस शामिल किया जाता है.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/maps-platform.mapstools