Method: computeRoutes

टर्मिनल और इंटरमीडिएट वेपॉइंट का सेट दिए जाने पर, यह मुख्य रास्ते के साथ-साथ वैकल्पिक रास्ते भी दिखाता है.

ध्यान दें: इस तरीके के लिए, आपको इनपुट में रिस्पॉन्स फ़ील्ड मास्क की जानकारी देनी होगी. रिस्पॉन्स फ़ील्ड मास्क देने के लिए, यूआरएल पैरामीटर $fields या fields का इस्तेमाल करें. इसके अलावा, एचटीटीपी/gRPC हेडर X-Goog-FieldMask का इस्तेमाल भी किया जा सकता है. उपलब्ध यूआरएल पैरामीटर और हेडर देखें. यह वैल्यू, फ़ील्ड पाथ की कॉमा लगाकर अलग की गई लिस्ट होती है. फ़ील्ड पाथ बनाने के तरीके के बारे में ज़्यादा जानकारी वाला दस्तावेज़ देखें.

उदाहरण के लिए, इस तरीके में:

  • उपलब्ध सभी फ़ील्ड का फ़ील्ड मास्क (मैन्युअल तरीके से जांच करने के लिए): X-Goog-FieldMask: *
  • रूट-लेवल की अवधि, दूरी, और पॉलीलाइन का फ़ील्ड मास्क (प्रोडक्शन सेटअप का एक उदाहरण): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google, वाइल्डकार्ड (*) रिस्पॉन्स फ़ील्ड मास्क का इस्तेमाल करने या टॉप लेवल (routes) पर फ़ील्ड मास्क तय करने का सुझाव नहीं देता है. इसकी वजहें यहां बताई गई हैं:

  • सिर्फ़ ज़रूरी फ़ील्ड चुनने से, हमारे सर्वर को कंप्यूटेशन साइकल सेव करने में मदद मिलती है. इससे हम आपको कम इंतज़ार के समय में नतीजा दिखा पाते हैं.
  • प्रोडक्शन जॉब में सिर्फ़ ज़रूरी फ़ील्ड चुनने से, इंतज़ार का समय कम रहता है. हम आने वाले समय में, जवाब के लिए ज़्यादा फ़ील्ड जोड़ सकते हैं. इन नए फ़ील्ड को प्रोसेस करने में ज़्यादा समय लग सकता है. अगर आपने सभी फ़ील्ड या टॉप लेवल पर सभी फ़ील्ड चुने हैं, तो हो सकता है कि आपको परफ़ॉर्मेंस में गिरावट देखने को मिले. ऐसा इसलिए, क्योंकि हम जो भी नया फ़ील्ड जोड़ेंगे वह जवाब में अपने-आप शामिल हो जाएगा.
  • सिर्फ़ ज़रूरी फ़ील्ड चुनने से, रिस्पॉन्स का साइज़ छोटा हो जाता है. इससे नेटवर्क थ्रूपुट बढ़ जाता है.

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

POST https://routes.googleapis.com/directions/v2:computeRoutes

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

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

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

JSON के काेड में दिखाना
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
फ़ील्ड
origin

object (Waypoint)

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

destination

object (Waypoint)

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

intermediates[]

object (Waypoint)

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

travelMode

enum (RouteTravelMode)

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

routingPreference

enum (RoutingPreference)

ज़रूरी नहीं. इससे पता चलता है कि रास्ते का हिसाब कैसे लगाया जाए. सर्वर, रूट का हिसाब लगाने के लिए, रूटिंग की चुनी गई प्राथमिकता का इस्तेमाल करने की कोशिश करता है. अगर रूटिंग की प्राथमिकता की वजह से कोई गड़बड़ी होती है या इंतज़ार का समय बहुत ज़्यादा होता है, तो गड़बड़ी का मैसेज दिखता है. इस विकल्प को सिर्फ़ तब चुना जा सकता है, जब travelMode की वैल्यू DRIVE या TWO_WHEELER हो. ऐसा न होने पर, अनुरोध पूरा नहीं हो पाएगा.

polylineQuality

enum (PolylineQuality)

ज़रूरी नहीं. इससे पॉलीलाइन की क्वालिटी के लिए आपकी प्राथमिकता का पता चलता है.

polylineEncoding

enum (PolylineEncoding)

ज़रूरी नहीं. इससे पॉलीलाइन के लिए पसंदीदा एन्कोडिंग के बारे में पता चलता है.

departureTime

string (Timestamp format)

ज़रूरी नहीं. रवानगी का समय. अगर आपने यह वैल्यू सेट नहीं की है, तो यह वैल्यू डिफ़ॉल्ट रूप से उस समय पर सेट हो जाती है जब आपने अनुरोध किया था. ध्यान दें: RouteTravelMode को TRANSIT पर सेट करने पर ही, बीते समय की departureTime तय की जा सकती है. बस, मेट्रो वगैरह से की जाने वाली यात्राओं की जानकारी, पिछले सात दिनों या आने वाले 100 दिनों के लिए उपलब्ध होती है.

यह आरएफ़सी 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)

ज़रूरी नहीं. पहुंचने का समय. ध्यान दें: जब अनुरोधों में TRANSIT के अलावा कोई और RouteTravelMode तय किया जाता है, तो इस फ़ील्ड को अनदेखा कर दिया जाता है. departureTime या arrivalTime में से किसी एक को ही तय किया जा सकता है, दोनों को नहीं. बस, मेट्रो वगैरह से की जाने वाली यात्राओं की जानकारी, पिछले सात दिनों या आने वाले 100 दिनों के लिए उपलब्ध होती है.

यह आरएफ़सी 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".

computeAlternativeRoutes

boolean

ज़रूरी नहीं. इससे यह तय होता है कि रास्ते के अलावा, अन्य रास्तों का हिसाब लगाना है या नहीं. जिन अनुरोधों में इंटरमीडिएट वेपॉइंट होते हैं उनके लिए कोई वैकल्पिक रास्ता नहीं दिखाया जाता.

routeModifiers

object (RouteModifiers)

ज़रूरी नहीं. शर्तों का एक सेट, जो रास्ते का हिसाब लगाने के तरीके पर असर डालता है.

languageCode

string

ज़रूरी नहीं. BCP-47 भाषा कोड, जैसे कि "en-US" या "sr-Latn". ज़्यादा जानकारी के लिए, यूनिकोड लोकेल आइडेंटिफ़ायर देखें. यह सुविधा किन भाषाओं में उपलब्ध है, इसकी सूची देखने के लिए Language Support पर जाएं. यह वैल्यू न देने पर, रूट के अनुरोध की जगह के आधार पर डिसप्ले की भाषा का अनुमान लगाया जाता है.

regionCode

string

ज़रूरी नहीं. क्षेत्र का कोड, ccTLD ("टॉप-लेवल डोमेन") के तौर पर दो वर्णों वाली वैल्यू के तौर पर दिया जाता है. ज़्यादा जानकारी के लिए, देश के कोड के हिसाब से टॉप लेवल डोमेन देखें.

units

enum (Units)

ज़रूरी नहीं. इससे, डिसप्ले फ़ील्ड के लिए माप की इकाइयां तय होती हैं. इन फ़ील्ड में, NavigationInstruction में मौजूद instruction फ़ील्ड शामिल है. इस वैल्यू से, रूट, लेग, स्टेप की दूरी, और अवधि के लिए इस्तेमाल की जाने वाली माप की इकाइयों पर कोई असर नहीं पड़ता. अगर आपने यह वैल्यू नहीं दी है, तो डिसप्ले यूनिट का अनुमान, पहले ऑरिजिन की जगह से लगाया जाता है.

optimizeWaypointOrder

boolean

ज़रूरी नहीं. अगर इसे true पर सेट किया जाता है, तो सेवा, रास्ते में पड़ने वाले वेपॉइंट के क्रम को फिर से तय करके, रास्ते की कुल लागत को कम करने की कोशिश करती है. अगर कोई इंटरमीडिएट वेपॉइंट via वेपॉइंट है, तो अनुरोध पूरा नहीं होगा. नया क्रम ढूंढने के लिए, ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index का इस्तेमाल करें. अगर X-Goog-FieldMask हेडर में ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index का अनुरोध नहीं किया जाता है, तो अनुरोध पूरा नहीं होता. अगर optimizeWaypointOrder को 'गलत है' पर सेट किया जाता है, तो ComputeRoutesResponse.optimized_intermediate_waypoint_index खाली रहेगा.

requestedReferenceRoutes[]

enum (ReferenceRoute)

ज़रूरी नहीं. इससे यह तय होता है कि अनुरोध के हिस्से के तौर पर, डिफ़ॉल्ट रूट के अलावा किन रेफ़रंस रूट को कैलकुलेट करना है. रेफ़रंस रूट, डिफ़ॉल्ट रूट से अलग होता है. इसे कैलकुलेट करने का मकसद भी अलग होता है. उदाहरण के लिए, FUEL_EFFICIENT रेफ़रंस रूट का हिसाब लगाने के लिए, कई पैरामीटर को ध्यान में रखा जाता है. इससे ईंधन की कम खपत वाला सबसे सही रास्ता जनरेट होता है. इस सुविधा का इस्तेमाल करते समय, नतीजों में दिखाए गए रास्तों पर routeLabels देखें.

extraComputations[]

enum (ExtraComputation)

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

trafficModel

enum (TrafficModel)

ज़रूरी नहीं. इससे उन अनुमानों के बारे में पता चलता है जिनका इस्तेमाल, ट्रैफ़िक में लगने वाले समय का हिसाब लगाने के लिए किया जाता है. इस सेटिंग का असर, Route और RouteLeg में मौजूद अवधि फ़ील्ड में दिखने वाली वैल्यू पर पड़ता है. इस फ़ील्ड में, ट्रैफ़िक के पुराने औसत के आधार पर, ट्रैफ़िक में लगने वाले अनुमानित समय की जानकारी होती है. TrafficModel सिर्फ़ उन अनुरोधों के लिए उपलब्ध है जिनमें RoutingPreference को TRAFFIC_AWARE_OPTIMAL और RouteTravelMode को DRIVE पर सेट किया गया है. अगर ट्रैफ़िक का अनुरोध किया जाता है और TrafficModel की वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से इसकी वैल्यू BEST_GUESS होती है.

transitPreferences

object (TransitPreferences)

ज़रूरी नहीं. इससे उन प्राथमिकताओं के बारे में पता चलता है जिनके आधार पर TRANSIT रास्तों के लिए रास्ता तय किया जाता है. ध्यान दें: transitPreferences की वैल्यू सिर्फ़ तब दी जा सकती है, जब RouteTravelMode को TRANSIT पर सेट किया गया हो.

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

v2.computeRoutes, जवाब वाला मैसेज.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
फ़ील्ड
routes[]

object (Route)

compute_alternatives_routes की वैल्यू देने पर, इसमें कैलकुलेट किए गए रास्तों (ज़्यादा से ज़्यादा तीन) की कैटगरी शामिल होती है. वैल्यू न देने पर, इसमें सिर्फ़ एक रास्ता शामिल होता है. जब इस कलेक्शन में कई एंट्री होती हैं, तो पहली एंट्री सबसे ज़्यादा सुझाया गया रास्ता होती है. अगर कलेक्शन खाली है, तो इसका मतलब है कि कोई रास्ता नहीं मिला.

fallbackInfo

object (FallbackInfo)

कुछ मामलों में, जब सर्वर इनपुट की गई सभी प्राथमिकताओं के साथ रास्ते के नतीजों का हिसाब नहीं लगा पाता है, तो वह हिसाब लगाने के लिए किसी दूसरे तरीके का इस्तेमाल कर सकता है. फ़ॉलबैक मोड का इस्तेमाल करने पर, इस फ़ील्ड में फ़ॉलबैक रिस्पॉन्स के बारे में पूरी जानकारी होती है. अगर ऐसा नहीं है, तो यह फ़ील्ड सेट नहीं किया जाता.

geocodingResults

object (GeocodingResults)

इसमें पते के तौर पर बताए गए वेपॉइंट के लिए, जियोकोडिंग के जवाब की जानकारी होती है.

PolylineQuality

वैल्यू का एक सेट, जो पॉलीलाइन की क्वालिटी के बारे में बताता है.

Enums
POLYLINE_QUALITY_UNSPECIFIED पॉलीलाइन की क्वालिटी के लिए कोई प्राथमिकता नहीं दी गई है. डिफ़ॉल्ट रूप से, यह OVERVIEW पर सेट होता है.
HIGH_QUALITY इससे अच्छी क्वालिटी वाली पॉलीलाइन के बारे में पता चलता है. इसे OVERVIEW से ज़्यादा पॉइंट का इस्तेमाल करके बनाया जाता है. हालांकि, इससे रिस्पॉन्स का साइज़ बढ़ जाता है. अगर आपको ज़्यादा सटीक जानकारी चाहिए, तो इस वैल्यू का इस्तेमाल करें.
OVERVIEW यह खास जानकारी वाली पॉलीलाइन के बारे में बताता है. इसे कुछ पॉइंट का इस्तेमाल करके बनाया जाता है. रास्ते की खास जानकारी दिखाते समय, इस वैल्यू का इस्तेमाल करें. इस विकल्प का इस्तेमाल करने पर, HIGH_QUALITY विकल्प का इस्तेमाल करने की तुलना में, अनुरोध के इंतज़ार का समय कम होता है.

PolylineEncoding

इससे पता चलता है कि किस तरह की पॉलीलाइन को दिखाया जाना चाहिए.

Enums
POLYLINE_ENCODING_UNSPECIFIED पॉलीलाइन टाइप की कोई प्राथमिकता नहीं दी गई है. डिफ़ॉल्ट रूप से, यह ENCODED_POLYLINE पर सेट होता है.
ENCODED_POLYLINE पॉलीलाइन एन्कोडिंग एल्गोरिदम का इस्तेमाल करके एन्कोड की गई पॉलीलाइन के बारे में बताता है.
GEO_JSON_LINESTRING GeoJSON LineString फ़ॉर्मैट का इस्तेमाल करके, पॉलीलाइन की जानकारी देता है

ReferenceRoute

ComputeRoutesRequest पर, रेफ़रंस के तौर पर इस्तेमाल किया जा सकने वाला रास्ता.

Enums
REFERENCE_ROUTE_UNSPECIFIED इस्तेमाल नहीं किया गया. इस वैल्यू वाले अनुरोध पूरे नहीं होते.
FUEL_EFFICIENT ईंधन की कम खपत वाला रास्ता.
SHORTER_DISTANCE

कम दूरी वाला रास्ता. यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है.

DRIVE अनुरोधों के लिए, यह सुविधा ड्राइविंग के दौरान मिलने वाली सुविधा के बजाय कम दूरी को प्राथमिकता देती है. उदाहरण के लिए, यह हाइवे के बजाय स्थानीय सड़कों को प्राथमिकता दे सकता है, कच्ची सड़कों पर चल सकता है, पार्किंग लॉट से होकर जा सकता है वगैरह. यह सुविधा ऐसे किसी भी मोड़ या गतिविधि के बारे में जानकारी नहीं देती जिसे Google Maps गैर-कानूनी मानता है.

BICYCLE और TWO_WHEELER अनुरोधों के लिए, यह सुविधा ऐसे रास्ते दिखाती है जो requestedReferenceRoutes की जानकारी न देने पर दिखाए जाते हैं.

यह सुविधा, यात्रा के किसी अन्य मोड, रास्ते में पड़ने वाली जगहों या optimizeWaypointOrder के साथ काम नहीं करती. इस तरह के अनुरोध पूरे नहीं किए जा सकेंगे. हालांकि, इसका इस्तेमाल किसी भी routingPreference के साथ किया जा सकता है.

ExtraComputation

अनुरोध को पूरा करते समय की जाने वाली अतिरिक्त कंप्यूटेशन. आने वाले समय में, इसमें अन्य वैल्यू जोड़ी जा सकती हैं.

Enums
EXTRA_COMPUTATION_UNSPECIFIED इस्तेमाल नहीं किया गया. इस वैल्यू वाले अनुरोध पूरे नहीं होंगे.
TOLLS रास्ते के लिए टोल की जानकारी.
FUEL_CONSUMPTION रास्तों के लिए ईंधन की खपत का अनुमान.
TRAFFIC_ON_POLYLINE रास्तों के लिए, ट्रैफ़िक की जानकारी देने वाली पॉलीलाइन.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstruction को फ़ॉर्मैट की गई एचटीएमएल टेक्स्ट स्ट्रिंग के तौर पर दिखाया जाता है. इस कॉन्टेंट को इसी तरह पढ़ा जाना चाहिए. यह कॉन्टेंट सिर्फ़ दिखाने के लिए है. इसे प्रोग्राम के हिसाब से पार्स न करें.
FLYOVER_INFO_ON_POLYLINE रास्ते (रास्तों) के लिए फ़्लाईओवर की जानकारी. यह जानकारी दिखाने के लिए, routes.polyline_details.flyover_info फ़ील्डमास्क की वैल्यू डालना ज़रूरी है. फ़िलहाल, यह डेटा भारत के कुछ ही महानगरों के लिए उपलब्ध होगा. यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है. इसलिए, एसकेयू/शुल्क में बदलाव हो सकता है.
NARROW_ROAD_INFO_ON_POLYLINE रास्तों पर मौजूद पतली सड़कों की जानकारी. यह जानकारी दिखाने के लिए, routes.polyline_details.narrow_road_info फ़ील्डमास्क की वैल्यू डालना ज़रूरी है. फ़िलहाल, यह डेटा भारत के कुछ ही महानगरों के लिए उपलब्ध होगा. यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है. इसलिए, एसकेयू/शुल्क में बदलाव हो सकता है.
TUNNEL_INFO_ON_POLYLINE रास्ते में मौजूद सुरंगों की जानकारी. यह जानकारी दिखाने के लिए, routes.polyline_details.tunnel_info फ़ील्डमास्क की वैल्यू डालना ज़रूरी है.
BRIDGE_INFO_ON_POLYLINE रास्तों पर मौजूद पुल की जानकारी. यह जानकारी दिखाने के लिए, routes.polyline_details.bridge_info फ़ील्डमास्क की वैल्यू डालना ज़रूरी है.
SKYWAY_INFO_ON_POLYLINE रास्तों के लिए स्काईवे की जानकारी. यह जानकारी दिखाने के लिए, routes.polyline_details.skyway_info फ़ील्डमास्क की वैल्यू डालना ज़रूरी है.

रास्ता

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

JSON के काेड में दिखाना
{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string,
  "polylineDetails": {
    object (PolylineDetails)
  }
}
फ़ील्ड
routeLabels[]

enum (RouteLabel)

Route के लिए लेबल, जो रास्ते की खास प्रॉपर्टी की पहचान करने के लिए काम के हैं, ताकि दूसरों से तुलना की जा सके.

legs[]

object (RouteLeg)

लेग (वेपॉइंट के बीच के पाथ सेगमेंट) का कलेक्शन, जिससे रास्ता बनता है. हर चरण, दो नॉन-via Waypoints के बीच की यात्रा से जुड़ा होता है. उदाहरण के लिए, जिस रास्ते में कोई इंटरमीडिएट वेपॉइंट नहीं होता उसमें सिर्फ़ एक लेग होता है. जिस रास्ते में एक नॉन-via इंटरमीडिएट वेपॉइंट शामिल होता है उसमें दो लेग होते हैं. जिस रास्ते में एक via इंटरमीडिएट वेपॉइंट शामिल होता है उसमें एक लेग होता है. लेग का क्रम, origin से intermediates और फिर destination तक के वेपॉइंट के क्रम से मैच होता है.

distanceMeters

integer

मीटर में, रास्ते की दूरी.

duration

string (Duration format)

रास्ते पर नेविगेट करने में लगने वाला समय. अगर routingPreference को TRAFFIC_UNAWARE पर सेट किया जाता है, तो यह वैल्यू staticDuration के बराबर होगी. अगर routingPreference को TRAFFIC_AWARE या TRAFFIC_AWARE_OPTIMAL पर सेट किया जाता है, तो इस वैल्यू का हिसाब ट्रैफ़िक की स्थिति को ध्यान में रखकर लगाया जाता है.

routingPreference को TRAFFIC_AWARE_OPTIMAL पर सेट करने पर, अवधि का हिसाब लगाने के लिए, यात्री वाहन की स्पीड या ट्रक की स्पीड (ज़्यादा अवधि) का इस्तेमाल किया जाता है. ट्रक की स्पीड का इस्तेमाल तब किया जाता है, जब इनमें से कोई एक शर्त पूरी होती है:

अन्य सभी मामलों में, यात्री वाहन की स्पीड का इस्तेमाल किया जाता है. भले ही, vehicleInfo में अन्य वाहन के डाइमेंशन या वज़न की जानकारी दी गई हो.

सेकंड में अवधि, जिसमें नौ फ़्रैक्शनल अंक हो सकते हैं. यह 's' पर खत्म होती है. उदाहरण: "3.5s".

staticDuration

string (Duration format)

ट्रैफ़िक का हाल ध्यान में रखे बिना, रास्ते से यात्रा करने में लगने वाला समय.

सेकंड में अवधि, जिसमें नौ फ़्रैक्शनल अंक हो सकते हैं. यह 's' पर खत्म होती है. उदाहरण: "3.5s".

polyline

object (Polyline)

पूरे रास्ते की पॉलीलाइन. यह पॉलीलाइन, सभी legs की कंबाइंड पॉलीलाइन है.

description

string

रास्ते की जानकारी.

warnings[]

string

रास्ता दिखाते समय दिखने वाली चेतावनियों का कलेक्शन.

viewport

object (Viewport)

पॉलीलाइन का व्यूपोर्ट बाउंडिंग बॉक्स.

travelAdvisory

object (RouteTravelAdvisory)

रास्ते के बारे में ज़्यादा जानकारी.

optimizedIntermediateWaypointIndex[]

integer

अगर optimizeWaypointOrder को true पर सेट किया जाता है, तो इस फ़ील्ड में इंटरमीडिएट वेपॉइंट का ऑप्टिमाइज़ किया गया क्रम शामिल होता है. ऐसा न होने पर, यह फ़ील्ड खाली रहता है. उदाहरण के लिए, अगर आपने शुरुआती जगह: LA; रास्ते में पड़ने वाले वेपॉइंट: डलास, बैंगर, फ़ीनिक्स; मंज़िल: न्यूयॉर्क; और रास्ते में पड़ने वाले वेपॉइंट का ऑप्टिमाइज़ किया गया क्रम फ़ीनिक्स, डलास, बैंगर है, तो इस फ़ील्ड में [2, 0, 1] वैल्यू होंगी. इनपुट में दिए गए पहले इंटरमीडिएट वेपॉइंट के लिए, इंडेक्स 0 से शुरू होता है.

localizedValues

object (RouteLocalizedValues)

Route की प्रॉपर्टी को टेक्स्ट के तौर पर दिखाया गया है.

routeToken

string

यह एक ओपेक टोकन है, जिसे Navigation SDK को पास किया जा सकता है. इससे नेविगेशन के दौरान रास्ते को फिर से बनाया जा सकता है. साथ ही, रास्ता बदलने पर, रास्ता बनाते समय तय किए गए मूल मकसद को पूरा किया जा सकता है. इस टोकन को ओपेक ब्लॉब के तौर पर इस्तेमाल करें. अलग-अलग अनुरोधों के लिए, इसकी वैल्यू की तुलना न करें. ऐसा इसलिए, क्योंकि सेवा से बिलकुल एक जैसा रूट मिलने पर भी इसकी वैल्यू बदल सकती है.

ध्यान दें: Route.route_token सिर्फ़ उन अनुरोधों के लिए उपलब्ध है जिनमें ComputeRoutesRequest.routing_preference को TRAFFIC_AWARE या TRAFFIC_AWARE_OPTIMAL पर सेट किया गया है. Route.route_token का इस्तेमाल, उन अनुरोधों के लिए नहीं किया जा सकता जिनमें रास्ते में पड़ने वाली जगहों की जानकारी शामिल होती है.

polylineDetails

object (PolylineDetails)

इसमें पॉलीलाइन के बारे में जानकारी होती है.

RouteLabel

Route के लिए लेबल, जो रास्ते की खास प्रॉपर्टी की पहचान करने के लिए काम के हैं, ताकि दूसरों से तुलना की जा सके.

Enums
ROUTE_LABEL_UNSPECIFIED डिफ़ॉल्ट - इस्तेमाल नहीं किया गया.
DEFAULT_ROUTE रास्ते की गणना के लिए, डिफ़ॉल्ट तौर पर "सबसे अच्छा" रास्ता दिखाया जाता है.
DEFAULT_ROUTE_ALTERNATE डिफ़ॉल्ट "सबसे अच्छे" रास्ते का विकल्प. computeAlternativeRoutes की वैल्यू देने पर, इस तरह के रास्ते दिखाए जाएंगे.
FUEL_EFFICIENT ईंधन की कम खपत वाला रास्ता. इस वैल्यू के साथ लेबल किए गए रास्तों को, ईंधन की खपत जैसे ईको पैरामीटर के लिए ऑप्टिमाइज़ किया जाता है.
SHORTER_DISTANCE कम दूरी वाला रास्ता. यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है.

RouteLeg

इसमें नॉन-via वेपॉइंट के बीच का सेगमेंट शामिल है.

JSON के काेड में दिखाना
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
फ़ील्ड
distanceMeters

integer

रूट लेग की यात्रा की दूरी, मीटर में.

duration

string (Duration format)

यात्रा के इस चरण को पूरा करने में लगने वाला समय. अगर routingPreference को TRAFFIC_UNAWARE पर सेट किया गया है, तो यह वैल्यू staticDuration के बराबर होगी. अगर routingPreference की वैल्यू TRAFFIC_AWARE या TRAFFIC_AWARE_OPTIMAL है, तो इस वैल्यू का हिसाब ट्रैफ़िक का हाल ध्यान में रखकर लगाया जाता है.

routingPreference को TRAFFIC_AWARE_OPTIMAL पर सेट करने पर, अवधि का हिसाब लगाने के लिए, यात्री वाहन की स्पीड या ट्रक की स्पीड (ज़्यादा अवधि) का इस्तेमाल किया जाता है. ट्रक की स्पीड का इस्तेमाल तब किया जाता है, जब इनमें से कोई एक शर्त पूरी होती है:

अन्य सभी मामलों में, यात्री वाहन की स्पीड का इस्तेमाल किया जाता है. भले ही, vehicleInfo में अन्य वाहन के डाइमेंशन या वज़न की जानकारी दी गई हो.

सेकंड में अवधि, जिसमें नौ फ़्रैक्शनल अंक हो सकते हैं. यह 's' पर खत्म होती है. उदाहरण: "3.5s".

staticDuration

string (Duration format)

यात्रा के इस चरण को पूरा करने में लगने वाला समय. इस समय का हिसाब लगाते समय, ट्रैफ़िक की स्थिति को ध्यान में नहीं रखा जाता.

सेकंड में अवधि, जिसमें नौ फ़्रैक्शनल अंक हो सकते हैं. यह 's' पर खत्म होती है. उदाहरण: "3.5s".

polyline

object (Polyline)

इस लेग की पूरी पॉलीलाइन, जिसमें हर step की पॉलीलाइन शामिल है.

startLocation

object (Location)

इस लेग की शुरुआती जगह. यह जगह, दी गई origin से अलग हो सकती है. उदाहरण के लिए, जब दिया गया origin किसी सड़क के पास न हो, तो यह सड़क पर मौजूद एक पॉइंट होता है.

endLocation

object (Location)

इस लेग की आखिरी जगह. यह जगह, दी गई destination से अलग हो सकती है. उदाहरण के लिए, जब दिया गया destination किसी सड़क के पास न हो, तो यह सड़क पर मौजूद एक पॉइंट होता है.

steps[]

object (RouteLegStep)

इस लेग के अंदर सेगमेंट दिखाने वाले चरणों की कैटगरी. हर चरण, नेविगेशन के एक निर्देश को दिखाता है.

travelAdvisory

object (RouteLegTravelAdvisory)

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

localizedValues

object (RouteLegLocalizedValues)

RouteLeg की प्रॉपर्टी को टेक्स्ट के तौर पर दिखाया गया है.

stepsOverview

object (StepsOverview)

इस RouteLeg में, चरणों के बारे में खास जानकारी दी गई है. यह फ़ील्ड सिर्फ़ बस, मेट्रो वगैरह के रास्तों के लिए भरा जाता है.

पॉलीलाइन

कोड में बदली गई पॉलीलाइन को एनकैप्सुलेट करता है.

JSON के काेड में दिखाना
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
इससे पॉलीलाइन के टाइप के बारे में पता चलता है. डिफ़ॉल्ट रूप से, encoded_polyline पर सेट होता है. यहां उन फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
encodedPolyline

string

पॉलीलाइन एन्कोडिंग एल्गोरिदम का इस्तेमाल करके, पॉलीलाइन की स्ट्रिंग एन्कोडिंग

geoJsonLinestring

object (Struct format)

GeoJSON LineString फ़ॉर्मैट का इस्तेमाल करके, पॉलीलाइन के बारे में बताता है.

एक-दूसरे से अलग फ़ील्ड का आखिरी हिस्सा.

RouteLegStep

इसमें RouteLeg का एक सेगमेंट शामिल है. एक चरण का मतलब, नेविगेशन के लिए दिए गए एक निर्देश से है. रास्ते के लेग, चरणों से बने होते हैं.

JSON के काेड में दिखाना
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
फ़ील्ड
distanceMeters

integer

इस चरण में तय की गई दूरी, मीटर में. कुछ मामलों में, हो सकता है कि इस फ़ील्ड में कोई वैल्यू न हो.

staticDuration

string (Duration format)

ट्रैफ़िक का हाल ध्यान में रखे बिना, इस चरण से यात्रा करने में लगने वाला समय. कुछ मामलों में, हो सकता है कि इस फ़ील्ड में कोई वैल्यू न हो.

सेकंड में अवधि, जिसमें नौ फ़्रैक्शनल अंक हो सकते हैं. यह 's' पर खत्म होती है. उदाहरण: "3.5s".

polyline

object (Polyline)

इस चरण से जुड़ी पॉलीलाइन.

startLocation

object (Location)

इस चरण की शुरुआत की जगह.

endLocation

object (Location)

इस चरण की आखिरी जगह.

navigationInstruction

object (NavigationInstruction)

नेविगेशन के लिए निर्देश.

travelAdvisory

object (RouteLegStepTravelAdvisory)

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

localizedValues

object (RouteLegStepLocalizedValues)

RouteLegStep की प्रॉपर्टी को टेक्स्ट के तौर पर दिखाया गया है.

transitDetails

object (RouteLegStepTransitDetails)

अगर यात्रा का मोड TRANSIT है, तो इस चरण से जुड़ी जानकारी.

travelMode

enum (RouteTravelMode)

इस चरण के लिए इस्तेमाल किया गया यात्रा मोड.

मैन्यूवर

वैल्यू का एक सेट, जो मौजूदा चरण के लिए नेविगेशन ऐक्शन तय करता है. उदाहरण के लिए, बाएं मुड़ें, मर्ज करें या सीधे जाएं.

Enums
MANEUVER_UNSPECIFIED इस्तेमाल नहीं किया गया.
TURN_SLIGHT_LEFT थोड़ा बाईं ओर मुड़ें.
TURN_SHARP_LEFT तेज़ी से बाईं ओर मुड़ें.
UTURN_LEFT बाईं ओर यू-टर्न लें.
TURN_LEFT बाईं ओर मुड़ें.
TURN_SLIGHT_RIGHT थोड़ा दाईं ओर मुड़ें.
TURN_SHARP_RIGHT तेज़ी से दाईं ओर मुड़ें.
UTURN_RIGHT दाईं ओर यू-टर्न लें.
TURN_RIGHT दाईं ओर मुड़ें.
STRAIGHT सीधे जाएं.
RAMP_LEFT बाईं ओर मौजूद रैंप लें.
RAMP_RIGHT दाईं ओर मौजूद रैंप पर जाएं.
MERGE ट्रैफ़िक में शामिल हों.
FORK_LEFT बाईं ओर मुड़ें.
FORK_RIGHT दाईं ओर मुड़ें.
FERRY फ़ेरी लें.
FERRY_TRAIN फ़ेरी तक जाने वाली ट्रेन लें.
ROUNDABOUT_LEFT गोल चक्कर से बाईं ओर मुड़ें.
ROUNDABOUT_RIGHT गोल चक्कर से दाएं मुड़ें.
DEPART शुरुआती पैंतरेबाज़ी.
NAME_CHANGE इसका इस्तेमाल, सड़क का नाम बदलने के लिए किया जाता है.
DESTINATION इसका इस्तेमाल, मंज़िल पर पहुंचने की जानकारी देने के लिए किया जाता है.

RouteLegStepTravelAdvisory

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

JSON के काेड में दिखाना
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
फ़ील्ड
speedReadingIntervals[]

object (SpeedReadingInterval)

ध्यान दें: फ़िलहाल, इस फ़ील्ड में डेटा अपने-आप नहीं भरता.

RouteLegStepLocalizedValues

कुछ प्रॉपर्टी को टेक्स्ट के तौर पर दिखाने के लिए.

JSON के काेड में दिखाना
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
फ़ील्ड
distance

object (LocalizedText)

तय की गई दूरी को टेक्स्ट के तौर पर दिखाया जाता है.

staticDuration

object (LocalizedText)

ट्रैफ़िक के हाल को ध्यान में रखे बिना, टेक्स्ट के तौर पर दिखाई गई अवधि.

RouteLegStepTransitDetails

TRANSIT रूट के लिए, RouteLegStep के बारे में ज़्यादा जानकारी.

JSON के काेड में दिखाना
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
फ़ील्ड
stopDetails

object (TransitStopDetails)

इस चरण के लिए, बस या ट्रेन के आने और जाने के स्टॉप की जानकारी.

localizedValues

object (TransitDetailsLocalizedValues)

RouteLegStepTransitDetails की प्रॉपर्टी को टेक्स्ट के तौर पर दिखाया गया है.

headsign

string

इससे पता चलता है कि इस लाइन पर किस दिशा में यात्रा करनी है. यह जानकारी, वाहन पर या बस स्टॉप पर दी गई होती है. दिशा अक्सर टर्मिनल स्टेशन होती है.

headway

string (Duration format)

इससे पता चलता है कि इस समय, एक ही स्टॉप से जाने वाली बसों के बीच कितना समय लगेगा. उदाहरण के लिए, अगर हेडवे सेकंड की वैल्यू 600 है, तो बस छूटने पर आपको दस मिनट इंतज़ार करना होगा.

सेकंड में अवधि, जिसमें नौ फ़्रैक्शनल अंक हो सकते हैं. यह 's' पर खत्म होती है. उदाहरण: "3.5s".

transitLine

object (TransitLine)

इस चरण में इस्तेमाल की गई बस, मेट्रो वगैरह की लाइन के बारे में जानकारी.

stopCount

integer

बस के छूटने से लेकर पहुंचने तक के स्टॉप की संख्या. इस संख्या में, बस के पहुंचने का स्टॉप शामिल होता है, लेकिन बस के रवाना होने का स्टॉप शामिल नहीं होता. उदाहरण के लिए, अगर आपका रास्ता स्टॉप A से शुरू होता है, स्टॉप B और C से गुज़रता है, और स्टॉप D पर पहुंचता है, तो stopCount 3 दिखाता है.

tripShortText

string

यह टेक्स्ट, शेड्यूल और साइन बोर्ड पर दिखता है, ताकि यात्रियों को बस, मेट्रो वगैरह की यात्रा की जानकारी मिल सके. टेक्स्ट से, सेवा के दिन के दौरान किसी यात्रा की खास तौर पर पहचान होनी चाहिए. उदाहरण के लिए, "538" उस Amtrak ट्रेन का tripShortText है जो सोमवार से शुक्रवार तक, सैन होज़े, कैलिफ़ोर्निया से दोपहर 3:10 बजे सैक्रामेंटो, कैलिफ़ोर्निया के लिए रवाना होती है.

TransitStopDetails

RouteLegStep के लिए, बस, मेट्रो वगैरह के स्टॉप की जानकारी.

JSON के काेड में दिखाना
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
फ़ील्ड
arrivalStop

object (TransitStop)

इस चरण के लिए, पहुंचने वाले स्टॉप की जानकारी.

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".

departureStop

object (TransitStop)

इस चरण के लिए, बस या ट्रेन के छूटने के स्टॉप की जानकारी.

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".

TransitStop

बस, मेट्रो वगैरह के स्टॉप के बारे में जानकारी.

JSON के काेड में दिखाना
{
  "name": string,
  "location": {
    object (Location)
  }
}
फ़ील्ड
name

string

बस, मेट्रो वगैरह के स्टॉप का नाम.

location

object (Location)

स्टॉप की जगह की जानकारी, अक्षांश/देशांतर निर्देशांक में दी जाती है.

TransitDetailsLocalizedValues

RouteTransitDetails के लिए, वैल्यू की स्थानीय भाषा में जानकारी.

JSON के काेड में दिखाना
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
फ़ील्ड
arrivalTime

object (LocalizedTime)

समय को उसके फ़ॉर्मैट किए गए टेक्स्ट के तौर पर दिखाया जाता है. साथ ही, उससे जुड़ा टाइम ज़ोन भी दिखाया जाता है.

departureTime

object (LocalizedTime)

समय को उसके फ़ॉर्मैट किए गए टेक्स्ट के तौर पर दिखाया जाता है. साथ ही, उससे जुड़ा टाइम ज़ोन भी दिखाया जाता है.

LocalizedTime

स्थानीय भाषा में समय की जानकारी.

JSON के काेड में दिखाना
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
फ़ील्ड
time

object (LocalizedText)

किसी टाइम ज़ोन में, स्ट्रिंग के तौर पर बताया गया समय.

timeZone

string

इसमें टाइम ज़ोन की जानकारी होती है. यह वैल्यू, आईएएनए टाइम ज़ोन डेटाबेस में तय किए गए टाइम ज़ोन का नाम होती है. उदाहरण के लिए, "America/New_York".

TransitLine

इसमें इस चरण में इस्तेमाल की गई ट्रांज़िट लाइन की जानकारी होती है.

JSON के काेड में दिखाना
{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
फ़ील्ड
agencies[]

object (TransitAgency)

इस ट्रांज़िट लाइन को चलाने वाली ट्रांसपोर्ट एजेंसी (या एजेंसियां).

name

string

इस बस, मेट्रो वगैरह की लाइन का पूरा नाम. उदाहरण के लिए, "8 Avenue Local".

uri

string

इस बस, मेट्रो वगैरह की लाइन का यूआरआई, जैसा कि ट्रांसपोर्ट एजेंसी ने उपलब्ध कराया है.

color

string

इस लाइन के साइनेज में आम तौर पर इस्तेमाल किया जाने वाला रंग. इसे हेक्साडेसिमल में दिखाया जाता है.

iconUri

string

इस लाइन से जुड़े आइकॉन का यूआरआई.

nameShort

string

इस बस, मेट्रो वगैरह की लाइन का छोटा नाम. आम तौर पर, यह नाम कोई लाइन नंबर होगा, जैसे कि "M7" या "355".

textColor

string

इस लाइन के साइनबोर्ड पर टेक्स्ट के लिए आम तौर पर इस्तेमाल किया जाने वाला रंग. इसे हेक्साडेसिमल में दिखाया जाता है.

vehicle

object (TransitVehicle)

इस ट्रांज़िट लाइन पर चलने वाले वाहन का टाइप.

TransitAgency

बस, मेट्रो वगैरह की लाइन को ऑपरेट करने वाली ट्रांसपोर्ट एजेंसी.

JSON के काेड में दिखाना
{
  "name": string,
  "phoneNumber": string,
  "uri": string
}
फ़ील्ड
name

string

इस ट्रांसपोर्ट एजेंसी का नाम.

phoneNumber

string

अंतरराष्ट्रीय फ़ॉर्मैट में ट्रांसपोर्ट एजेंसी का फ़ोन नंबर.

uri

string

ट्रांसपोर्ट एजेंसी का यूआरआई.

TransitVehicle

बस, मेट्रो वगैरह के रूट में इस्तेमाल होने वाले वाहन की जानकारी.

JSON के काेड में दिखाना
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
फ़ील्ड
name

object (LocalizedText)

इस वाहन का नाम, कैपिटल लेटर में.

type

enum (TransitVehicleType)

इस्तेमाल किए गए वाहन का टाइप.

iconUri

string

इस वाहन के टाइप से जुड़े आइकॉन का यूआरआई.

localIconUri

string

स्थानीय परिवहन के साइनबोर्ड के आधार पर, इस वाहन के टाइप से जुड़े आइकॉन का यूआरआई.

TransitVehicleType

बस, मेट्रो वगैरह के रास्तों के लिए वाहनों का टाइप.

Enums
TRANSIT_VEHICLE_TYPE_UNSPECIFIED इस्तेमाल नहीं किया गया.
BUS बस.
CABLE_CAR केबल से चलने वाला वाहन, जो आम तौर पर ज़मीन पर चलता है. एरियल केबल कार, GONDOLA_LIFT टाइप की हो सकती हैं.
COMMUTER_TRAIN कम्यूटर रेल.
FERRY फ़ेरी.
FUNICULAR एक ऐसा वाहन जिसे केबल की मदद से खड़ी चढ़ाई पर खींचा जाता है. फ़्यूनिक्युलर में आम तौर पर दो कारें होती हैं. इनमें से हर कार, दूसरी कार के लिए काउंटरवेट के तौर पर काम करती है.
GONDOLA_LIFT एक एरियल केबल कार.
HEAVY_RAIL हैवी रेल.
HIGH_SPEED_TRAIN हाई स्पीड ट्रेन.
INTERCITY_BUS एक से दूसरे शहर जाने वाली बस.
LONG_DISTANCE_TRAIN लंबी दूरी की ट्रेन.
METRO_RAIL लाइट रेल ट्रांज़िट.
MONORAIL मोनोरेल.
OTHER अन्य सभी वाहन.
RAIL रेल.
SHARE_TAXI शेयर टैक्सी एक तरह की बस होती है. यह अपने रूट पर कहीं भी यात्रियों को पिक और ड्रॉप कर सकती है.
SUBWAY अंडरग्राउंड लाइट रेल.
TRAM ज़मीन के ऊपर चलने वाली लाइट रेल.
TROLLEYBUS ट्रॉलीबस.

RouteLegTravelAdvisory

इसमें वह अतिरिक्त जानकारी शामिल होती है जो उपयोगकर्ता को यात्रा के किसी चरण के बारे में दी जानी चाहिए. जैसे, ट्रैफ़िक ज़ोन से जुड़ी संभावित पाबंदियां.

JSON के काेड में दिखाना
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
फ़ील्ड
tollInfo

object (TollInfo)

इसमें RouteLeg पर लगने वाले टोल की जानकारी होती है. यह फ़ील्ड सिर्फ़ तब भरा जाता है, जब हमें लगता है कि RouteLeg पर टोल हैं और अनुरोध के ComputeRoutesRequest.extra_computations में TOLLS शामिल है. अगर यह फ़ील्ड सेट है, लेकिन estimatedPrice सबफ़ील्ड में जानकारी नहीं भरी गई है, तो हमें लगता है कि सड़क पर टोल हैं. हालांकि, हमें अनुमानित कीमत की जानकारी नहीं है. अगर tollInfo मौजूद नहीं है, तो RouteLeg पर कोई टोल नहीं है.

speedReadingIntervals[]

object (SpeedReadingInterval)

ट्रैफ़िक की डेंसिटी के हिसाब से, स्पीड रीडिंग के इंटरवल. यह फ़ील्ड सिर्फ़ उन अनुरोधों के लिए भरा जाता है जिनमें TRAFFIC_AWARE या TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference वैल्यू होती है. साथ ही, TRAFFIC_ON_POLYLINE को ComputeRoutesRequest.extra_computations में शामिल किया जाता है. इंटरवल, RouteLeg की पूरी पॉलीलाइन को कवर करते हैं. साथ ही, ये ओवरलैप नहीं होते. किसी इंटरवल का शुरुआती समय, उससे पहले वाले इंटरवल के खत्म होने के समय के बराबर होता है.

उदाहरण:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).

RouteLegLocalizedValues

कुछ प्रॉपर्टी को टेक्स्ट के तौर पर दिखाने के लिए.

JSON के काेड में दिखाना
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
फ़ील्ड
distance

object (LocalizedText)

तय की गई दूरी को टेक्स्ट के तौर पर दिखाया जाता है.

duration

object (LocalizedText)

अवधि, टेक्स्ट के तौर पर दिखाई जाती है और क्वेरी के क्षेत्र के हिसाब से स्थानीय भाषा में होती है. ट्रैफ़िक की स्थिति को ध्यान में रखता है. ध्यान दें: अगर आपने ट्रैफ़िक की जानकारी का अनुरोध नहीं किया है, तो यह वैल्यू staticDuration के बराबर होगी.

staticDuration

object (LocalizedText)

ट्रैफ़िक के हाल को ध्यान में रखे बिना, टेक्स्ट के तौर पर दिखाई गई अवधि.

StepsOverview

इससे RouteLegStep की सूची के बारे में खास जानकारी मिलती है.

JSON के काेड में दिखाना
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
फ़ील्ड
multiModalSegments[]

object (MultiModalSegment)

RouteLeg.steps के अलग-अलग मल्टी-मोडल सेगमेंट के बारे में खास जानकारी. अगर RouteLeg में मौजूद चरणों में कोई मल्टी-मोडल सेगमेंट नहीं है, तो यह फ़ील्ड नहीं भरा जाता.

MultiModalSegment

RouteLeg.steps के अलग-अलग मल्टी-मोडल सेगमेंट के बारे में खास जानकारी देता है. मल्टी-मोडल सेगमेंट को एक या उससे ज़्यादा ऐसे RouteLegStep के तौर पर तय किया जाता है जिनका RouteTravelMode एक जैसा हो. अगर RouteLeg में मौजूद चरणों में कोई मल्टी-मोडल सेगमेंट नहीं है, तो यह फ़ील्ड नहीं भरा जाता.

JSON के काेड में दिखाना
{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
फ़ील्ड
navigationInstruction

object (NavigationInstruction)

मल्टी-मोडल सेगमेंट के लिए NavigationInstruction.

travelMode

enum (RouteTravelMode)

मल्टी-मोडल सेगमेंट के लिए यात्रा का मोड.

stepStartIndex

integer

इससे जुड़ा RouteLegStep इंडेक्स, जो मल्टी-मोडल सेगमेंट की शुरुआत है.

stepEndIndex

integer

इससे जुड़ा RouteLegStep इंडेक्स, जो मल्टी-मोडल सेगमेंट का आखिरी हिस्सा है.

व्यूपोर्ट

अक्षांश-देशांतर व्यूपोर्ट, जिसे दो तिरछे विपरीत low और high पॉइंट के तौर पर दिखाया गया है. व्यूपोर्ट को एक बंद क्षेत्र माना जाता है. इसका मतलब है कि इसमें इसकी सीमा शामिल होती है. अक्षांश की सीमाएं -90 से 90 डिग्री के बीच होनी चाहिए. साथ ही, देशांतर की सीमाएं -180 से 180 डिग्री के बीच होनी चाहिए. इनमें ये मामले शामिल हैं:

  • अगर low = high है, तो व्यूपोर्ट में सिर्फ़ वह पॉइंट शामिल होता है.

  • अगर low.longitude > high.longitude है, तो देशांतर की रेंज उल्टी हो जाती है. इसका मतलब है कि व्यूपोर्ट, 180 डिग्री देशांतर लाइन को पार कर जाता है.

  • अगर low.longitude = -180 डिग्री और high.longitude = 180 डिग्री है, तो व्यूपोर्ट में सभी देशांतर शामिल होते हैं.

  • अगर low.longitude = 180 डिग्री और high.longitude = -180 डिग्री है, तो देशांतर की रेंज खाली होती है.

  • अगर low.latitude > high.latitude है, तो अक्षांश की रेंज खाली है.

low और high, दोनों फ़ील्ड में वैल्यू डालना ज़रूरी है. साथ ही, बॉक्स खाली नहीं होना चाहिए, जैसा कि ऊपर दी गई परिभाषाओं में बताया गया है. खाली व्यूपोर्ट की वजह से गड़बड़ी होगी.

उदाहरण के लिए, यह व्यूपोर्ट न्यूयॉर्क शहर को पूरी तरह से कवर करता है:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON के काेड में दिखाना
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
फ़ील्ड
low

object (LatLng)

ज़रूरी है. व्यूपोर्ट का सबसे निचला पॉइंट.

high

object (LatLng)

ज़रूरी है. व्यूपोर्ट का सबसे ऊंचा पॉइंट.

RouteLocalizedValues

कुछ प्रॉपर्टी को टेक्स्ट के तौर पर दिखाने के लिए.

JSON के काेड में दिखाना
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
फ़ील्ड
distance

object (LocalizedText)

तय की गई दूरी को टेक्स्ट के तौर पर दिखाया जाता है.

duration

object (LocalizedText)

अवधि, टेक्स्ट के तौर पर दिखाई जाती है और क्वेरी के क्षेत्र के हिसाब से स्थानीय भाषा में होती है. ट्रैफ़िक की स्थिति को ध्यान में रखता है. ध्यान दें: अगर आपने ट्रैफ़िक की जानकारी का अनुरोध नहीं किया है, तो यह वैल्यू staticDuration के बराबर होगी.

staticDuration

object (LocalizedText)

ट्रैफ़िक के हाल को ध्यान में रखे बिना, टेक्स्ट के तौर पर दिखाई गई अवधि.

transitFare

object (LocalizedText)

बस, मेट्रो वगैरह का किराया, टेक्स्ट के तौर पर दिखाया जाता है.

PolylineDetails

किसी पॉलीलाइन के दिए गए इंडेक्स या आस-पास के सेगमेंट से जुड़ी जानकारी. P_0, P_1, ... , P_N (शून्य पर आधारित इंडेक्स) पॉइंट वाली पॉलीलाइन के लिए, PolylineDetails एक इंटरवल और उससे जुड़ा मेटाडेटा तय करता है.

JSON के काेड में दिखाना
{
  "tunnelInfo": [
    {
      object (TunnelInfo)
    }
  ],
  "restrictionInfo": [
    {
      object (RestrictionInfo)
    }
  ],
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ],
  "bridgeInfo": [
    {
      object (BridgeInfo)
    }
  ],
  "skywayInfo": [
    {
      object (SkywayInfo)
    }
  ]
}
फ़ील्ड
tunnelInfo[]

object (TunnelInfo)

पॉलीलाइन के साथ मौजूद टनल की जानकारी. यह फ़ील्ड तब भरा जाता है, जब अनुरोध में avoidTunnels रूट मॉडिफ़ायर की जानकारी दी गई हो और नतीजे के तौर पर मिलने वाला रास्ता उन्हें न बचा पाए या अगर extraComputations में TUNNEL_INFO_ON_POLYLINE की जानकारी दी गई हो और रास्ते में सुरंगें हों.

restrictionInfo[]

object (RestrictionInfo)

पॉलीलाइन के साथ पाबंदी की जानकारी. यह फ़ील्ड सिर्फ़ तब भरा जाता है, जब किसी अनुरोध में vehicleInfo रूट मॉडिफ़ायर की जानकारी दी गई हो और नतीजे के तौर पर मिलने वाले रास्ते पर कोई पाबंदी लागू हो. ऐसा न होने पर, इस फ़ील्ड का इस्तेमाल नहीं किया जाता.

flyoverInfo[]

object (FlyoverInfo)

पॉलीलाइन के साथ-साथ फ़्लाईओवर की जानकारी.

narrowRoadInfo[]

object (NarrowRoadInfo)

पॉलीलाइन के साथ-साथ संकरी सड़क की जानकारी.

bridgeInfo[]

object (BridgeInfo)

पॉलीलाइन के साथ पुल की जानकारी.

skywayInfo[]

object (SkywayInfo)

पॉलीलाइन के साथ-साथ स्काईवे की जानकारी.

TunnelInfo

पॉलीलाइन के साथ मौजूद टनल के बारे में जानकारी देता है.

JSON के काेड में दिखाना
{
  "tunnelPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
फ़ील्ड
tunnelPresence

enum (RoadFeatureState)

इससे पता चलता है कि पॉलीलाइन के किसी हिस्से के लिए टनल मौजूद है या नहीं.

polylinePointIndex

object (PolylinePointIndex)

पॉलीलाइन के साथ-साथ, टनल से जुड़ी जानकारी की जगह.

RoadFeatureState

यह पॉलीलाइन के एक हिस्से के साथ-साथ, सड़क की सुविधाओं की स्थितियों को दिखाता है.

Enums
ROAD_FEATURE_STATE_UNSPECIFIED सड़क की सुविधा की स्थिति का हिसाब नहीं लगाया गया (डिफ़ॉल्ट वैल्यू).
EXISTS सड़क की सुविधा मौजूद है.
DOES_NOT_EXIST सड़क की सुविधा मौजूद नहीं है.

PolylinePointIndex

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

JSON के काेड में दिखाना
{
  "startIndex": integer,
  "endIndex": integer
}
फ़ील्ड
startIndex

integer

पॉलीलाइन में इस जानकारी का शुरुआती इंडेक्स.

endIndex

integer

पॉलीलाइन में इस जानकारी का आखिरी इंडेक्स.

RestrictionInfo

पॉलीलाइन के साथ-साथ, अलग-अलग पाबंदियों के बारे में जानकारी देता है.

JSON के काेड में दिखाना
{
  "restrictionPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "restrictedHeightMm": string,
  "restrictedWeightKg": string,
  "hazardousGoods": boolean,
  "trucksProhibited": boolean
  // End of mutually exclusive fields.
}
फ़ील्ड
restrictionPresence

enum (RoadFeatureState)

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि पॉलीलाइन के किसी हिस्से के लिए कोई पाबंदी है या नहीं.

polylinePointIndex

object (PolylinePointIndex)

पॉलीलाइन के साथ-साथ, पाबंदी से जुड़ी जानकारी की जगह.

यह पॉलीलाइन के किसी हिस्से पर लागू होने वाली पाबंदियों के टाइप को दिखाता है. यहां उन फ़ील्ड की सूची दी गई है जो एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
restrictedHeightMm

string (int64 format)

ऊंचाई की सीमा, मिलीमीटर में. यह फ़ील्ड तब भरा जाता है, जब ऊंचाई की पाबंदी की वजह से किसी वाहन को गुज़रने में परेशानी होती है या उसे कम जगह मिलती है.

restrictedWeightKg

string (int64 format)

वज़न की सीमा, किलोग्राम में. यह फ़ील्ड तब भरा जाता है, जब वज़न की पाबंदी की वजह से वाहन को जाने की अनुमति नहीं मिलती या वाहन का वज़न, तय किए गए वज़न के आस-पास होता है.

hazardousGoods

boolean

खतरनाक सामान ले जाने पर पाबंदी होने पर, इस फ़ील्ड को 'सही है' पर सेट किया जाता है.

trucksProhibited

boolean

ट्रक पर पाबंदी होने पर, इस फ़ील्ड को 'सही है' पर सेट किया जाता है.

एक-दूसरे से अलग फ़ील्ड का आखिरी हिस्सा.

FlyoverInfo

पॉलीलाइन के साथ-साथ फ़्लाईओवर के बारे में जानकारी शामिल करता है.

JSON के काेड में दिखाना
{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
फ़ील्ड
flyoverPresence

enum (RoadFeatureState)

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि पॉलीलाइन के किसी हिस्से के लिए फ़्लाईओवर मौजूद है या नहीं.

polylinePointIndex

object (PolylinePointIndex)

पॉलीलाइन के साथ-साथ, फ़्लाईओवर से जुड़ी जानकारी की जगह.

NarrowRoadInfo

इसमें पॉलीलाइन के साथ-साथ संकरी सड़कों की जानकारी शामिल होती है.

JSON के काेड में दिखाना
{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
फ़ील्ड
narrowRoadPresence

enum (RoadFeatureState)

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि पॉलीलाइन के किसी हिस्से के लिए, संकरी सड़क मौजूद है या नहीं.

polylinePointIndex

object (PolylinePointIndex)

पॉलीलाइन के साथ-साथ, संकरी सड़क से जुड़ी जानकारी की जगह.

BridgeInfo

पॉलीलाइन के साथ मौजूद पुलों के बारे में जानकारी शामिल करता है.

JSON के काेड में दिखाना
{
  "bridgePresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
फ़ील्ड
bridgePresence

enum (RoadFeatureState)

इससे पता चलता है कि पॉलीलाइन के किसी हिस्से के लिए कोई पुल मौजूद है या नहीं.

polylinePointIndex

object (PolylinePointIndex)

पॉलीलाइन के साथ-साथ, पुल से जुड़ी जानकारी की जगह.

SkywayInfo

पॉलीलाइन के साथ-साथ स्काईवे के बारे में जानकारी शामिल करता है.

JSON के काेड में दिखाना
{
  "skywayPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
फ़ील्ड
skywayPresence

enum (RoadFeatureState)

इससे पता चलता है कि पॉलीलाइन के किसी हिस्से के लिए, स्काईवे मौजूद है या नहीं.

polylinePointIndex

object (PolylinePointIndex)

पॉलीलाइन के साथ-साथ, स्काईवे से जुड़ी जानकारी की जगह.

GeocodingResults

इसमें यात्रा शुरू करने की जगह, मंज़िल, और इंटरमीडिएट वेपॉइंट के लिए GeocodedWaypoints शामिल है. यह सिर्फ़ पते के वेपॉइंट के लिए अपने-आप भरता है.

JSON के काेड में दिखाना
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
फ़ील्ड
origin

object (GeocodedWaypoint)

जियोकोड किया गया शुरुआती वेपॉइंट.

destination

object (GeocodedWaypoint)

मंज़िल का जियोकोड किया गया वेपॉइंट.

intermediates[]

object (GeocodedWaypoint)

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

GeocodedWaypoint

वेपॉइंट के तौर पर इस्तेमाल की गई जगहों की जानकारी. यह सिर्फ़ पते के वेपॉइंट के लिए अपने-आप भरता है. इसमें जियोकोडिंग के नतीजों के बारे में जानकारी शामिल होती है. इससे यह पता चलता है कि पते को किस तरह जियोकोड किया गया था.

JSON के काेड में दिखाना
{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
फ़ील्ड
geocoderStatus

object (Status)

यह जियोकोडिंग ऑपरेशन से मिलने वाले स्टेटस कोड को दिखाता है.

type[]

string

नतीजे के टाइप, शून्य या उससे ज़्यादा टाइप टैग के तौर पर. इस्तेमाल किए जा सकने वाले टाइप: पते के टाइप और पते के कॉम्पोनेंट के टाइप.

partialMatch

boolean

इससे पता चलता है कि जियोकोडर को मूल अनुरोध के लिए एग्ज़ैक्ट मैच नहीं मिला. हालांकि, वह अनुरोध किए गए पते के कुछ हिस्से से मैच कर पाया. आपको मूल अनुरोध की जांच करनी चाहिए, ताकि यह पता चल सके कि उसमें गलत स्पेलिंग और/या अधूरा पता तो नहीं है.

placeId

string

इस नतीजे के लिए जगह का आईडी.

intermediateWaypointRequestIndex

integer

अनुरोध में दिए गए इंटरमीडिएट वेपॉइंट का इंडेक्स. यह जानकारी सिर्फ़ तब भरी जाती है, जब संबंधित वेपॉइंट एक इंटरमीडिएट वेपॉइंट हो.