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 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

arrivalTime

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

computeAlternativeRoutes

boolean

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

routeModifiers

object (RouteModifiers)

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

languageCode

string

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

regionCode

string

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

units

enum (Units)

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

optimizeWaypointOrder

boolean

ज़रूरी नहीं. अगर इसकी वैल्यू 'सही है' पर सेट है, तो सेवा, तय किए गए इंटरमीडिएट वेपॉइंट का क्रम बदलकर, रास्ते की कुल लागत को कम करने की कोशिश करती है. अगर किसी भी बीच के रास्ते पर via वॉयपॉइंट है, तो अनुरोध पूरा नहीं होता. नई क्रम सेटिंग देखने के लिए, ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index का इस्तेमाल करें. अगर X-Goog-FieldMask हेडर में ComputeRoutesResponseroutes.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 रूट के लिए दिखाए गए रास्ते पर पड़ता है. ध्यान दें: RouteTravelMode को TRANSIT पर सेट करने पर ही transitPreferences की जानकारी दी जा सकती है.

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

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 NavigationInstructions को फ़ॉर्मैट की गई एचटीएमएल टेक्स्ट स्ट्रिंग के तौर पर दिखाया जाता है. इस कॉन्टेंट को बिना किसी बदलाव के पढ़ा जाना चाहिए. यह कॉन्टेंट सिर्फ़ दिखाने के लिए है. इसे प्रोग्राम के हिसाब से, अपने-आप होने वाली प्रोसेस के ज़रिए पार्स न करें.
FLYOVER_INFO_ON_POLYLINE रास्ते के लिए फ़्लायओवर की जानकारी. यह जानकारी दिखाने के लिए, routes.polyline_details.flyover_info फ़ील्डमास्क की जानकारी देना ज़रूरी है. फ़िलहाल, यह डेटा सिर्फ़ भारत के कुछ मेट्रो शहरों के लिए पॉप्युलेट किया जाएगा. यह सुविधा, एक्सपेरिमेंट के तौर पर उपलब्ध है. इसलिए, SKU/शुल्क में बदलाव हो सकता है.
NARROW_ROAD_INFO_ON_POLYLINE रास्ते के लिए सड़क की जानकारी. यह जानकारी दिखाने के लिए, routes.polyline_details.narrow_road_info फ़ील्डमास्क की जानकारी देना ज़रूरी है. फ़िलहाल, यह डेटा सिर्फ़ भारत के कुछ मेट्रो शहरों के लिए पॉप्युलेट किया जाएगा. यह सुविधा, एक्सपेरिमेंट के तौर पर उपलब्ध है. इसलिए, SKU/शुल्क में बदलाव हो सकता है.

रास्ता

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

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 पर सेट किया जाता है, तो इस वैल्यू का हिसाब लगाने के लिए, ट्रैफ़िक की स्थिति को ध्यान में रखा जाता है.

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

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

सेकंड में कुल अवधि, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह अवधि '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 के काेड में दिखाना
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}
फ़ील्ड
यूनियन फ़ील्ड polyline_type. पॉलीलाइन का टाइप बताता है. डिफ़ॉल्ट रूप से, encoded_polyline पर सेट होता है. polyline_type इनमें से कोई एक हो सकता है:
encodedPolyline

string

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

geoJsonLinestring

object (Struct format)

GeoJSON लाइनस्ट्रिंग फ़ॉर्मैट का इस्तेमाल करके, पॉलीलाइन की जानकारी देता है.

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 इसका इस्तेमाल, सड़क के नाम में हुए बदलाव की जानकारी देने के लिए किया जाता है.

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 सेकंड है, तो बस छूटने पर आपको 10 मिनट इंतज़ार करना पड़ सकता है.

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

transitLine

object (TransitLine)

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

stopCount

integer

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

stopCount

3 दिखाता है.

tripShortText

string

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

TransitStopDetails

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

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

object (TransitStop)

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

arrivalTime

string (Timestamp format)

उस चरण के पूरा होने में लगने वाला अनुमानित समय.

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

departureStop

object (TransitStop)

उस चरण के लिए, बस या मेट्रो के स्टॉप की जानकारी.

departureTime

string (Timestamp format)

चरण के लिए, रवाना होने का अनुमानित समय.

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

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 पर टोल है. अगर यह फ़ील्ड सेट है, लेकिन estimatedPrice सब-फ़ील्ड में कोई वैल्यू नहीं है, तो हमें लगता है कि सड़क पर टोल है, लेकिन हमें अनुमानित कीमत की जानकारी नहीं है. अगर यह फ़ील्ड मौजूद नहीं है, तो इसका मतलब है कि RouteLeg पर कोई टोल नहीं है.

speedReadingIntervals[]

object (SpeedReadingInterval)

ट्रैफ़िक की घनत्व की जानकारी देने वाले, स्पीड रीडिंग इंटरवल. यह TRAFFIC_AWARE और TRAFFIC_AWARE_OPTIMAL के लिए, रूटिंग की प्राथमिकताओं पर लागू होता है. इंटरवल, ओवरलैप किए बिना 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 के काेड में दिखाना
{
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ]
}
फ़ील्ड
flyoverInfo[]

object (FlyoverInfo)

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

narrowRoadInfo[]

object (NarrowRoadInfo)

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

FlyoverInfo

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

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

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

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

NarrowRoadInfo

पॉलीलाइन के साथ-साथ, सड़क की चौड़ाई के बारे में जानकारी देता है.

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

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

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