Package google.maps.routes.v1

इंडेक्स

RoutesPreferred

रूट को प्राथमिकता देने वाला एपीआई.

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

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

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

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

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

Google, वाइल्डकार्ड (*) रिस्पॉन्स फ़ील्ड मास्क इस्तेमाल करने या टॉप लेवल (routes) पर फ़ील्ड मास्क इस्तेमाल करने की सलाह नहीं देता, क्योंकि:

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

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

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

ऑरिजिन और डेस्टिनेशन की सूची लेता है. साथ ही, ऐसी स्ट्रीम दिखाता है जिसमें ऑरिजिन और डेस्टिनेशन के हर कॉम्बिनेशन के लिए रास्ते की जानकारी होती है.

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

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

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

यह ज़रूरी है कि आप अपने फ़ील्ड मास्क में status शामिल करें, क्योंकि ऐसा न करने पर सभी मैसेज ठीक दिखेंगे. Google, वाइल्डकार्ड (*) रिस्पॉन्स फ़ील्ड मास्क इस्तेमाल करने की सलाह नहीं देता, क्योंकि:

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

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

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

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

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

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

Google, वाइल्डकार्ड (*) रिस्पॉन्स फ़ील्ड मास्क इस्तेमाल करने या टॉप लेवल (routes) पर फ़ील्ड मास्क इस्तेमाल करने की सलाह नहीं देता, क्योंकि:

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

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

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

ComputeCustomRoutesRequest

ComputeCustomRoutes के अनुरोध का मैसेज.

फ़ील्ड
origin

Waypoint

ज़रूरी है. ऑरिजिन वेपॉइंट.
destination

Waypoint

ज़रूरी है. डेस्टिनेशन वेपॉइंट.
intermediates[]

Waypoint

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

RouteTravelMode

ज़रूरी नहीं. परिवहन का साधन बताता है. अब सिर्फ़ Drive इस्तेमाल किया जा सकता है.
routing_preference

RoutingPreference

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

PolylineQuality

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

PolylineEncoding

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

Timestamp

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

RouteModifiers

ज़रूरी नहीं. शर्तों का एक सेट, जो रास्ते की गणना के तरीके को प्रभावित करती है.
route_objective

RouteObjective

ज़रूरी है. ऑप्टिमाइज़ करने के लिए रूट का मकसद.
language_code

string

ज़रूरी नहीं. BCP-47 भाषा कोड, जैसे कि "en-US" या "sr-Latn" के रूप में जाना जाता है. ज़्यादा जानकारी के लिए, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier देखें. इस्तेमाल की जा सकने वाली भाषाओं की सूची के लिए, भाषा की सुविधा पर जाएं. यह वैल्यू न देने पर, डिसप्ले की भाषा का अनुमान, रास्ते के अनुरोध की जगह के आधार पर लगाया जाता है.
units

Units

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

ComputeCustomRoutesResponse

ComputeCustomRoutes का जवाब देने वाला मैसेज.

फ़ील्ड
routes[]

CustomRoute

इनपुट रूट से जुड़े मकसद के लिए, 'सबसे अच्छा' रूट.
fastest_route

CustomRoute

सबसे तेज़ रास्ता.
shortest_route

CustomRoute

सबसे छोटा रेफ़रंस रूट.
fallback_info

FallbackInfo

कस्टम रूट के लिए फ़ॉलबैक जानकारी.

FallbackInfo

ComputeCustomRoutes के लिए फ़ॉलबैक की जानकारी इकट्ठा करता है. ComputeCustomRoutes, दो तरह के फ़ॉलबैक काम करता है:

  1. अगर यह ग्राहक के अनुरोध किए गए रूटिंग_preference का इस्तेमाल करके रूट को कंप्यूट नहीं कर सकता, तो यह दूसरे रूटिंग मोड पर फ़ॉलबैक हो जाएगा. इस मामले में, फ़ॉलबैक के रूटिंग मोड और फ़ॉलबैक की वजह के बारे में बताने के लिए, Fallback_rooting_mode और रूटिंग_mode_फ़ॉलबैक_ऑर्डर का इस्तेमाल किया जाता है.

  2. यदि यह 'बेहतरीन' की गणना नहीं कर सकती है का इस्तेमाल करते हैं, तो हो सकता है कि यह किसी दूसरे मकसद पर वापस आ जाए. फ़ॉलबैक_रूट_ऑब्जेक्ट का इस्तेमाल, फ़ॉलबैक रूट तय करने के लिए किया जाता है.

फ़ील्ड
routing_mode

FallbackRoutingMode

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

FallbackReason

इसकी वजह यह है कि ओरिजनल जवाब के बजाय फ़ॉलबैक रिस्पॉन्स का इस्तेमाल किया गया है. इस फ़ील्ड में जानकारी सिर्फ़ तब अपने-आप भर जाती है, जब फ़ॉलबैक मोड ट्रिगर होता है और फ़ॉलबैक रिस्पॉन्स मिलता है.
route_objective

FallbackRouteObjective

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

FallbackRouteObjective

जवाब देने के लिए, RouteObjective का इस्तेमाल किया गया.

Enums
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED फ़ॉलबैक रूट का मकसद तय नहीं किया गया है.
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA अगर ग्राहक, RateCard का अनुरोध करता है औरinclude_tolls को 'सही' पर सेट करता है और Google के पास रास्ते के लिए टोल की कीमत का डेटा नहीं होता, तो एपीआई, टोल की कीमत को ध्यान में रखे बिना, RateCard को वापस चला जाता है.

ComputeRouteMatrixRequest

ComputeRouteMatrix के अनुरोध का मैसेज

फ़ील्ड
origins[]

RouteMatrixOrigin

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

  • एलिमेंट की संख्या (ऑरिजिन × डेस्टिनेशन) किसी भी मामले में 625 से ज़्यादा नहीं होनी चाहिए.
  • अगर रूटिंग_preference को TRAFFIC_AWARE_OPTIMAL पर सेट किया गया है, तो एलिमेंट की संख्या (ऑरिजिन × डेस्टिनेशन) 100 से ज़्यादा नहीं होनी चाहिए.
  • place_id के तौर पर वेपॉइंट (ऑरिजिन + डेस्टिनेशन) की संख्या 50 से ज़्यादा नहीं होनी चाहिए.
destinations[]

RouteMatrixDestination

ज़रूरी है. डेस्टिनेशन की वह कलेक्शन, जो रिस्पॉन्स मैट्रिक्स के कॉलम तय करती है.
travel_mode

RouteTravelMode

ज़रूरी नहीं. परिवहन का साधन बताता है.
routing_preference

RoutingPreference

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

Timestamp

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

ComputeRoutesRequest

ComputeRoutes के अनुरोध का मैसेज.

फ़ील्ड
origin

Waypoint

ज़रूरी है. ऑरिजिन वेपॉइंट.
destination

Waypoint

ज़रूरी है. डेस्टिनेशन वेपॉइंट.
intermediates[]

Waypoint

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

RouteTravelMode

ज़रूरी नहीं. परिवहन का साधन बताता है.
routing_preference

RoutingPreference

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

PolylineQuality

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

PolylineEncoding

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

Timestamp

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

bool

तय करता है कि रूट के अलावा वैकल्पिक रास्तों की गणना करनी है या नहीं.
route_modifiers

RouteModifiers

ज़रूरी नहीं. शर्तों का एक सेट, जो रास्ते की गणना के तरीके को प्रभावित करती है.
language_code

string

ज़रूरी नहीं. BCP-47 भाषा कोड, जैसे कि "en-US" या "sr-Latn" के रूप में जाना जाता है. ज़्यादा जानकारी के लिए, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier देखें. इस्तेमाल की जा सकने वाली भाषाओं की सूची के लिए, भाषा की सुविधा पर जाएं. यह वैल्यू न देने पर, डिसप्ले की भाषा का अनुमान, रास्ते के अनुरोध की जगह के आधार पर लगाया जाता है.
units

Units

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

bool

अगर OptimizeWaypointOrder 'सही' पर सेट है, तो रूट की कुल लागत को कम करने के लिए, बताए गए इंटरमीडिएट वेपॉइंट को फिर से क्रम में लगाने की कोशिश की जाती है. अगर कोई भी इंटरमीडिएट वेपॉइंट, वेपॉइंट से होकर गुज़रता है, तो अनुरोध फ़ेल हो जाता है. नया क्रम देखने के लिए, ComputeRoutesResponse.Routes.Optimize_intermediate_waypoint_index का इस्तेमाल करें. अगर X-Goog-FieldMask हेडर में route.Optimize_intermediate_waypoint_index का अनुरोध नहीं किया जाता, तो अनुरोध पूरा नहीं होता. अगर OptimizeWaypointOrder को 'गलत' पर सेट किया गया है, तो ComputeRoutesResponse.Optimize_intermediate_waypoint_index खाली रहता है.

ComputeRoutesResponse

यह रिस्पॉन्स मैसेज को कैलकुलेट करता है.

फ़ील्ड
routes[]

Route

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

FallbackInfo

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

CustomRoute

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

फ़ील्ड
route

Route

रास्ता 'सबसे अच्छा' माना जाता है का इस्तेमाल करें.
token

string

वेब पर सुरक्षित होने वाला base64 कोड में बदला गया रूट टोकन, जिसे NavSDK को भेजा जा सकता है. इसकी मदद से, NavSDK ने नेविगेशन के दौरान रूट को फिर से बनाया है. साथ ही, रूट करने की स्थिति में रूट को फिर से बनाने के लिए, RoutesPreferred ComputeCustomRoutes पर कॉल किया जाता है. ग्राहकों को इस टोकन को ओपेक ब्लॉब के रूप में देखना चाहिए.

FallbackInfo

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

फ़ील्ड
routing_mode

FallbackRoutingMode

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

FallbackReason

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

FallbackReason

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

Enums
FALLBACK_REASON_UNSPECIFIED फ़ॉलबैक की कोई वजह नहीं बताई गई है.
SERVER_ERROR आपके पसंदीदा रूटिंग मोड का इस्तेमाल करके, रूट का हिसाब लगाते समय सर्वर में कोई गड़बड़ी हुई. हालांकि, हम किसी दूसरे मोड का इस्तेमाल करके कैलकुलेट किया गया नतीजा दिखाने में सफल रहे.
LATENCY_EXCEEDED हम आपके पसंदीदा रूटिंग मोड से समय पर कैलकुलेशन को पूरा नहीं कर पाए, लेकिन हम किसी दूसरे मोड से कैलकुलेट किए गए नतीजे को वापस ला पाए.

FallbackRoutingMode

फ़ॉलबैक रिस्पॉन्स के लिए, असल रूटिंग मोड इस्तेमाल किया जाता है.

Enums
FALLBACK_ROUTING_MODE_UNSPECIFIED इस्तेमाल नहीं किया गया.
FALLBACK_TRAFFIC_UNAWARE "TRAFFIC_UNAWARE" को दिखाता है रिस्पॉन्स का हिसाब लगाने के लिए, रूटिंग मोड का इस्तेमाल किया गया था.
FALLBACK_TRAFFIC_AWARE "TRAFFIC_AWARE" को दर्शाता है रिस्पॉन्स का हिसाब लगाने के लिए, रूटिंग मोड का इस्तेमाल किया गया था.

जगह

जगह को इनकैप्सुलेट करता है (भौगोलिक पॉइंट और वैकल्पिक हेडिंग).

फ़ील्ड
lat_lng

LatLng

वेपॉइंट के भौगोलिक निर्देशांक.
heading

Int32Value

ट्रैफ़िक के फ़्लो की दिशा से जुड़ा कंपास हेडिंग. इस वैल्यू का इस्तेमाल सड़क के उस हिस्से के बारे में बताने के लिए किया जाता है जिसका इस्तेमाल पिकअप और ड्रॉप-ऑफ़ के लिए किया जाना है. शीर्षक का मान 0 से 360 तक हो सकता है, जहां 0 उत्तरी दिशा की हेडिंग के बारे में बताता है, 90 आखिरी दिशा की हेडिंग के बारे में बताता है, वगैरह. आप इस फ़ील्ड का इस्तेमाल सिर्फ़ DRIVE और TWO_WHEELER के यात्रा मोड के लिए कर सकते हैं.

मैन्युवर

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

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 गोलचक्कर पर दाएँ मुड़ें.
फ़ील्ड
maneuver

Maneuver

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

string

इस चरण को नेविगेट करने के लिए निर्देश.

पॉलीलाइन

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

फ़ील्ड
यूनियन फ़ील्ड polyline_type. पॉलीलाइन के टाइप को इनकैप्सुलेट करता है. डिफ़ॉल्ट तौर पर, encoded_polyline काम करने लगता है. polyline_type इनमें से सिर्फ़ एक हो सकता है:
encoded_polyline

string

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

Struct

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

PolylineEncoding

यह बताता है कि पसंद के मुताबिक पॉलीलाइन किस तरह की है.

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

PolylineQuality

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

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

रास्ता

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

फ़ील्ड
legs[]

RouteLeg

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

int32

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

Duration

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

Duration

ट्रैफ़िक की स्थितियों को ध्यान में रखे बिना रूट पर यात्रा करने की अवधि.
polyline

Polyline

पूरे रास्ते की पॉलीलाइन. यह पॉलीलाइन, सभी legs की मिली-जुली पॉलीलाइन होगी.
description

string

रास्ते की जानकारी.
warnings[]

string

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

Viewport

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

RouteTravelAdvisory

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

int32

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

RouteLeg

नॉन-via वेपॉइंट के बीच के सेगमेंट को इनकैप्सुलेट करता है.

फ़ील्ड
distance_meters

int32

रास्ते में पड़ने वाली दूरी, मीटर में.
duration

Duration

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

Duration

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

Polyline

इस पैर के लिए पूरी पॉलीलाइन. इसमें हर step की पॉलीलाइन भी शामिल है.
start_location

Location

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

Location

इस पैर के अंत का स्थान. यह कोड, दिए गए destination से अलग हो सकता है. उदाहरण के लिए, अगर दिया गया destination किसी सड़क के पास नहीं है, तो यह सड़क का कोई पॉइंट होता है.
steps[]

RouteLegStep

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

RouteLegTravelAdvisory

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

RouteLegStep

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

फ़ील्ड
distance_meters

int32

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

Duration

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

Polyline

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

Location

इस चरण के शुरू होने की जगह.
end_location

Location

इस चरण के खत्म होने की जगह.
navigation_instruction

NavigationInstruction

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

RouteLegStepTravelAdvisory

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

RouteLegStepTravelAdvisory

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

फ़ील्ड
speed_reading_intervals[]

SpeedReadingInterval

ट्रैफ़िक डेंसिटी की जानकारी देने वाले स्पीड रीडिंग के इंटरवल. यह TRAFFIC_AWARE और TRAFFIC_AWARE_OPTIMAL रूटिंग प्राथमिकताओं के मामले में लागू होता है. ये इंटरवल, RouteLegStep की पूरी पॉलीलाइन को बिना ओवरलैप किए कवर करते हैं. किसी तय इंटरवल का शुरुआती पॉइंट और पिछले इंटरवल का आखिरी पॉइंट एक ही होता है.

उदाहरण:

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

RouteLegTravelAdvisory

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

फ़ील्ड
toll_info

TollInfo

किसी खास RouteLeg पर टोल के बारे में जानकारी इनकैप्सुलेट करता है. इस फ़ील्ड में सिर्फ़ तब जानकारी अपने-आप भरी जाती है, जब हमें लगता है कि RouteLeg पर टोल लगेगा. अगर यह फ़ील्ड सेट है, लेकिन अनुमानित_price सबफ़ील्ड की जानकारी अपने-आप नहीं भरती, तो हम उम्मीद करते हैं कि सड़क पर टोल हैं. हालांकि, हमें इसका अनुमानित किराया नहीं पता. अगर यह फ़ील्ड मौजूद नहीं है, तो RouteLeg पर कोई टोल नहीं लगेगा.
speed_reading_intervals[]

SpeedReadingInterval

ट्रैफ़िक डेंसिटी की जानकारी देने वाले स्पीड रीडिंग के इंटरवल. यह TRAFFIC_AWARE और TRAFFIC_AWARE_OPTIMAL रूटिंग प्राथमिकताओं के मामले में लागू होता है. ये इंटरवल, RouteLg की पूरी पॉलीलाइन को बिना ओवरलैप के कवर करते हैं. किसी तय इंटरवल का शुरुआती पॉइंट और पिछले इंटरवल का आखिरी पॉइंट एक ही होता है.

उदाहरण:

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

RouteMatrixDestination

ComputeRouteMatrixRequest के लिए एक ही डेस्टिनेशन

फ़ील्ड
waypoint

Waypoint

ज़रूरी है. डेस्टिनेशन वेपॉइंट

RouteMatrixElement

यह ComputeRouteMatrix API में, ऑरिजिन/डेस्टिनेशन पेयर के लिए तैयार की गई रास्ते की जानकारी को एन्क्रिप्ट (सुरक्षित) करता है. इस प्रोटो को क्लाइंट पर स्ट्रीम किया जा सकता है.

फ़ील्ड
origin_index

int32

अनुरोध में ऑरिजिन का शून्य-आधारित इंडेक्स.
destination_index

int32

अनुरोध में डेस्टिनेशन का शून्य-आधारित इंडेक्स.
status

Status

इस एलिमेंट के लिए, गड़बड़ी की स्थिति का कोड.
condition

RouteMatrixElementCondition

बताता है कि रास्ता नहीं मिला. स्थिति से अलग.
distance_meters

int32

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

Duration

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

Duration

ट्रैफ़िक की स्थितियों को ध्यान में रखे बिना रूट पर यात्रा करने की अवधि.
travel_advisory

RouteTravelAdvisory

रास्ते के बारे में ज़्यादा जानकारी. उदाहरण के लिए: पाबंदी और टोल की जानकारी
fallback_info

FallbackInfo

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

RouteMatrixElementCondition

दिखाए जा रहे रास्ते की स्थिति.

Enums
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED इसका इस्तेमाल सिर्फ़ तब किया जाता है, जब एलिमेंट का status ठीक नहीं होता.
ROUTE_EXISTS एक रूट मिला और एलिमेंट से जुड़ी जानकारी भर दी गई थी.
ROUTE_NOT_FOUND कोई रास्ता नहीं मिला. एलिमेंट में रास्ते की जानकारी वाले फ़ील्ड, जैसे कि distance_meters या duration नहीं भरे जाएंगे.

RouteMatrixOrigin

ComputeRouteMatrixRequest के लिए एक ऑरिजिन

फ़ील्ड
waypoint

Waypoint

ज़रूरी है. ऑरिजिन वेपॉइंट
route_modifiers

RouteModifiers

ज़रूरी नहीं. हर उस रास्ते के लिए मॉडिफ़ायर जो इसे ऑरिजिन के तौर पर लेता है

RouteModifiers

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

फ़ील्ड
avoid_tolls

bool

बताता है कि जहां मुमकिन हो वहां टोल रोड से बचना है या नहीं. उन रास्तों को प्राथमिकता दी जाएगी जिनमें टोल रोड शामिल नहीं हैं. यह सिर्फ़ DRIVE और TWO_WHEELER यात्रा मोड पर लागू होता है.
avoid_highways

bool

जहां उचित हो, वहां हाइवे से बचने के बारे में बताता है या नहीं. उन रास्तों को प्राथमिकता दी जाएगी जिनमें हाइवे नहीं हैं. यह सिर्फ़ DRIVE और TWO_WHEELER यात्रा मोड पर लागू होता है.
avoid_ferries

bool

बताता है कि जहां उचित हो वहां फ़ेरी से बचना है या नहीं. उन रास्तों को प्राथमिकता दी जाएगी जिनमें फ़ेरी से यात्रा करने की सुविधा नहीं है. यह सिर्फ़ DRIVE और TWO_WHEELER यात्रा मोड पर लागू होता है.
avoid_indoor

bool

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

VehicleInfo

वाहन की जानकारी देती है.
toll_passes[]

TollPass

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

RouteObjective

यह ऐसे मकसद को इनकैप्सुलेट करता है जिसे ComputeCustomRoutes की मदद से ऑप्टिमाइज़ करना है.

फ़ील्ड
rate_card

RateCard

रेटकार्ड का मकसद.

RateCard

रेटकार्ड रूट के मकसद को एनकैप्सुलेट करता है.

फ़ील्ड
cost_per_minute

MonetaryCost

ज़रूरी नहीं. हर मिनट की लागत.
cost_per_km

MonetaryCost

ज़रूरी नहीं. प्रति किलोमीटर लागत.
include_tolls

bool

ज़रूरी नहीं. कुल कीमत में टोल कॉस्ट शामिल करना है या नहीं.

MonetaryCost

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

फ़ील्ड
value

double

ज़रूरी है. अनुरोध से मिली स्थानीय मुद्रा में लागत की वैल्यू.

RouteTravelAdvisory

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

फ़ील्ड
toll_info

TollInfo

रास्ते पर लगने वाले टोल के बारे में जानकारी इनकैप्सुलेट करता है. इस फ़ील्ड में अपने-आप जानकारी तब भरती है, जब हमें लगता है कि रास्ते पर टोल हैं. अगर यह फ़ील्ड सेट है, लेकिन अनुमानित_price सबफ़ील्ड की जानकारी अपने-आप नहीं भरती, तो हम उम्मीद करते हैं कि सड़क पर टोल हैं. हालांकि, हमें इसका अनुमानित किराया नहीं पता. अगर यह फ़ील्ड सेट नहीं है, तो हम उम्मीद करते हैं कि रास्ते पर कोई टोल नहीं लगेगा.
speed_reading_intervals[]

SpeedReadingInterval

ट्रैफ़िक डेंसिटी की जानकारी देने वाले स्पीड रीडिंग के इंटरवल. यह TRAFFIC_AWARE और TRAFFIC_AWARE_OPTIMAL रूटिंग प्राथमिकताओं के मामले में लागू होता है. इंटरवल, बिना ओवरलैप के रूट की पूरी पॉलीलाइन को कवर करता है. किसी तय इंटरवल का शुरुआती पॉइंट और पिछले इंटरवल का आखिरी पॉइंट एक ही होता है.

उदाहरण:

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

RouteTravelMode

यात्रा का मोड बताने के लिए इस्तेमाल की जाने वाली वैल्यू का सेट.

Enums
TRAVEL_MODE_UNSPECIFIED कोई यात्रा मोड दर्ज नहीं है. डिफ़ॉल्ट तौर पर, यह DRIVE पर सेट होता है.
DRIVE यात्री कार से यात्रा करें.
BICYCLE साइकिल से यात्रा करें.
WALK पैदल यात्रा करें.
TWO_WHEELER दोपहिया वाहन. उदाहरण के लिए, मोटरसाइकल. ध्यान दें कि यह यात्रा के BICYCLE मोड से अलग है, जिसमें मैन्युअल तरीके से चलने वाले मोड का इस्तेमाल किया जाता है.
TAXI

लाइसेंस वाली टैक्सी से यात्रा करें. इससे कुछ इलाकों में वाहन, तय की गई टैक्सी लेन पर भी चल सकता है.

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

RoutingPreference

यह उन वैल्यू का सेट है जिन्हें रूट तय करते समय ध्यान में रखना चाहिए.

Enums
ROUTING_PREFERENCE_UNSPECIFIED कोई रूटिंग प्राथमिकता दर्ज नहीं की गई. डिफ़ॉल्ट रूप से TRAFFIC_AWARE.
TRAFFIC_UNAWARE ट्रैफ़िक की स्थितियों को ध्यान में रखे बिना, रूट का हिसाब लगाता है. यह तब दिखाया जाता है, जब ट्रैफ़िक का हाल कोई मायने नहीं रखता है. इस वैल्यू का इस्तेमाल करने पर, इंतज़ार का समय कम से कम हो जाता है.
TRAFFIC_AWARE ट्रैफ़िक की स्थितियों को ध्यान में रखते हुए रास्तों की गणना करता है. TRAFFIC_AWARE_OPTIMAL के उलट, इंतज़ार के समय को काफ़ी कम करने के लिए, कुछ ऑप्टिमाइज़ेशन लागू किए जाते हैं.
TRAFFIC_AWARE_OPTIMAL ज़्यादातर परफ़ॉर्मेंस ऑप्टिमाइज़ेशन को लागू किए बिना, ट्रैफ़िक की स्थितियों को ध्यान में रखकर रास्तों की गणना करता है. इस वैल्यू का इस्तेमाल करने पर, इंतज़ार का समय सबसे ज़्यादा बनता है.

SpeedReadingInterval

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

फ़ील्ड
start_polyline_point_index

int32

पॉलीलाइन में इस इंटरवल का शुरुआती इंडेक्स. JSON में, जब इंडेक्स 0 होता है, तो ऐसा लगता है कि फ़ील्ड में जानकारी नहीं भरी गई है.
end_polyline_point_index

int32

पॉलीलाइन में इस इंटरवल का आखिरी इंडेक्स. JSON में, जब इंडेक्स 0 होता है, तो ऐसा लगता है कि फ़ील्ड में जानकारी नहीं भरी गई है.
speed

Speed

इस इंटरवल में ट्रैफ़िक की स्पीड.

स्पीड

ट्रैफ़िक डेटा के आधार पर पॉलीलाइन स्पीड का वर्गीकरण.

Enums
SPEED_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
NORMAL सामान्य स्पीड, धीमे ट्रैफ़िक का पता नहीं चला.
SLOW धीमे ट्रैफ़िक का पता चला, लेकिन कोई ट्रैफ़िक जाम नहीं हुआ.
TRAFFIC_JAM ट्रैफ़िक जाम का पता चला.

TollInfo

Route या RouteLeg पर टोल की जानकारी को इनकैप्सुलेट करता है.

फ़ील्ड
estimated_price[]

Money

इससे जुड़े रास्ते या राऊटर के लिए टोल की रकम. इस सूची में हर उस मुद्रा के लिए एक रकम होती है जिसके लिए टोल स्टेशन से शुल्क चुकाना होता है. आम तौर पर, इस सूची में एक मुद्रा में टोल वाले रास्तों के लिए सिर्फ़ एक आइटम होगा. अंतरराष्ट्रीय यात्राओं के लिए, इस सूची में अलग-अलग मुद्राओं में टोल दिखाने के लिए कई आइटम हो सकते हैं.

TollPass

दुनिया भर के जिन टोल पास से पेमेंट स्वीकार किया जाता है उनकी सूची.

Enums
TOLL_PASS_UNSPECIFIED इस्तेमाल नहीं किया गया. अगर इस वैल्यू का इस्तेमाल किया जाता है, तो अनुरोध पूरा नहीं होता.
AU_ETOLL_TAG सिडनी के टोल पास देने वाली कई कंपनियों में से एक. https://www.myetoll.com.au
AU_EWAY_TAG सिडनी के टोल पास देने वाली कई कंपनियों में से एक. https://www.tollpay.com.au/
AU_LINKT ऑस्ट्रेलिया का टोल पास. ज़्यादा जानकारी के लिए https://www.linkt.com.au/ पर जाएं.
AR_TELEPASE अर्जेंटीना का टोल पास. ज़्यादा जानकारी के लिए https://telepase.com.ar पर जाएं
BR_AUTO_EXPRESO ब्राज़ील का टोल पास. ज़्यादा जानकारी https://www.autoexpreso.com पर देखें
BR_CONECTCAR ब्राज़ील का टोल पास. ज़्यादा जानकारी के लिए https://conectcar.com पर जाएं.
BR_MOVE_MAIS ब्राज़ील का टोल पास. https://movemais.com पर जाकर ज़्यादा जानकारी देखें.
BR_PASSA_RAPIDO ब्राज़ील का टोल पास. ज़्यादा जानकारी के लिए https://pasorapido.gob.do/ पर जाएं
BR_SEM_PARAR ब्राज़ील का टोल पास. ज़्यादा जानकारी के लिए, https://www.semparar.com.br पर जाएं.
BR_TAGGY ब्राज़ील का टोल पास. https://taggy.com.br पर ज़्यादा जानकारी देखें.
BR_VELOE ब्राज़ील का टोल पास. ज़्यादा जानकारी के लिए, https://veloe.com.br/site/onde-usar पर जाएं.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD कनाडा से संयुक्त राज्य अमेरिका की सीमा पार करना.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD कनाडा से संयुक्त राज्य अमेरिका की सीमा पार करना.
CA_US_BLUE_WATER_EDGE_PASS ओंटेरियो, कनाडा से मिशिगन, संयुक्त राज्य अमेरिका की सीमा क्रॉसिंग.
CA_US_CONNEXION ओंटेरियो, कनाडा से मिशिगन, संयुक्त राज्य अमेरिका की सीमा क्रॉसिंग.
CA_US_NEXUS_CARD कनाडा से संयुक्त राज्य अमेरिका की सीमा पार करना.
ID_E_TOLL इंडोनेशिया. टोल के पेमेंट के लिए कई बैंकों की ओर से दिया गया ई-कार्ड. बैंक से मिलने वाले सभी ई-कार्ड के लिए एक ही शुल्क लिया जाता है. इसलिए, सिर्फ़ एक ई-कार्ड की वैल्यू देना ज़रूरी है. उदाहरण के लिए, बैंक मंदिरी https://www.bankmandiri.co.id/e-money बीसीए https://www.bca.co.id/flazz बीएनआई https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG India.
IN_LOCAL_HP_PLATE_EXEMPT भारत, HP की स्टेट प्लेट छूट.
MX_TAG_IAVE मेक्सिको का टोल पास.
MX_TAG_TELEVIA मेक्सिको की टोल पास कंपनी. यह मेक्सिको सिटी में मौजूद कई कारोबारों में से एक है. ज़्यादा जानकारी के लिए, https://www.televia.com.mx पर जाएं.
MX_VIAPASS मेक्सिको का टोल पास. ज़्यादा जानकारी के लिए https://www.viapass.com.mx/viapass/web_home.aspx पर जाएं.
US_AL_FREEDOM_PASS ऐएल, अमेरिका.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS एके, अमेरिका.
US_CA_FASTRAK कैलिफ़ोर्निया, अमेरिका.
US_CA_FASTRAK_CAV_STICKER इससे पता चलता है कि डीएमवी की ओर से जारी किए गए क्लीन एयर व्हीकल (सीएवी) के स्टिकर के अलावा, ड्राइवर के पास कोई भी FasTrak पास है. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, अमेरिका.
US_CO_GO_PASS CO, अमेरिका.
US_DE_EZPASSDE जर्मनी, अमेरिका.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL, USA.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL, USA.
US_FL_EPASS FL, USA.
US_FL_GIBA_TOLL_PASS FL, USA.
US_FL_LEEWAY FL, USA.
US_FL_SUNPASS FL, USA.
US_FL_SUNPASS_PRO FL, USA.
US_IL_EZPASSIL इलिनॉय, अमेरिका.
US_IL_IPASS इलिनॉय, अमेरिका.
US_IN_EZPASSIN भारत, अमेरिका.
US_KS_BESTPASS_HORIZON केएस, अमेरिका.
US_KS_KTAG केएस, अमेरिका.
US_KS_NATIONALPASS केएस, अमेरिका.
US_KS_PREPASS_ELITEPASS केएस, अमेरिका.
US_LA_GEAUXPASS लॉस एंजेलिस, अमेरिका.
US_LA_TOLL_TAG लॉस एंजेलिस, अमेरिका.
US_MA_EZPASSMA MA, अमेरिका.
US_MD_EZPASSMD एमडी, अमेरिका.
US_ME_EZPASSME मैं, अमेरिका.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, USA.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, USA.
US_MI_IQ_PROX_CARD MI, USA.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, USA.
US_MI_NEXPRESS_TOLL MI, USA.
US_MN_EZPASSMN MN, अमेरिका.
US_NC_EZPASSNC उत्तरी कैरोलाइना, अमेरिका.
US_NC_PEACH_PASS उत्तरी कैरोलाइना, अमेरिका.
US_NC_QUICK_PASS उत्तरी कैरोलाइना, अमेरिका.
US_NH_EZPASSNH एनएच, अमेरिका.
US_NJ_DOWNBEACH_EXPRESS_PASS न्यू जर्सी, अमेरिका.
US_NJ_EZPASSNJ न्यू जर्सी, अमेरिका.
US_NY_EXPRESSPASS न्यूयॉर्क, अमेरिका.
US_NY_EZPASSNY न्यूयॉर्क, अमेरिका.
US_OH_EZPASSOH ओह, अमेरिका.
US_PA_EZPASSPA PA, अमेरिका.
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS एससी, अमेरिका.
US_TX_BANCPASS टेक्सस, अमेरिका.
US_TX_DEL_RIO_PASS टेक्सस, अमेरिका.
US_TX_EFAST_PASS टेक्सस, अमेरिका.
US_TX_EAGLE_PASS_EXPRESS_CARD टेक्सस, अमेरिका.
US_TX_EPTOLL टेक्सस, अमेरिका.
US_TX_EZ_CROSS टेक्सस, अमेरिका.
US_TX_EZTAG टेक्सस, अमेरिका.
US_TX_LAREDO_TRADE_TAG टेक्सस, अमेरिका.
US_TX_PLUSPASS टेक्सस, अमेरिका.
US_TX_TOLLTAG टेक्सस, अमेरिका.
US_TX_TXTAG टेक्सस, अमेरिका.
US_TX_XPRESS_CARD टेक्सस, अमेरिका.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD यूटी, अमेरिका.
US_VA_EZPASSVA VA, USA.
US_WA_BREEZEBY वॉशिंगटन, अमेरिका.
US_WA_GOOD_TO_GO वॉशिंगटन, अमेरिका.
US_WV_EZPASSWV पश्चिमी अमेरिका, भारत.
US_WV_MEMORIAL_BRIDGE_TICKETS पश्चिमी अमेरिका, भारत.
US_WV_NEWELL_TOLL_BRIDGE_TICKET पश्चिमी अमेरिका, भारत.

इकाइयां

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

Enums
UNITS_UNSPECIFIED माप की इकाइयां दी नहीं गई हैं. अनुरोध से मिली माप की इकाई की डिफ़ॉल्ट वैल्यू.
METRIC माप की मेट्रिक इकाइयां.
IMPERIAL इंपीरियल (अंग्रेज़ी) माप की इकाइयां.

VehicleEmissionType

वाहन के उत्सर्जन का टाइप बताने वाली वैल्यू का सेट. यह सिर्फ़ 'डिस्क' के यात्रा मोड पर लागू होता है.

Enums
VEHICLE_EMISSION_TYPE_UNSPECIFIED उत्सर्जन का टाइप नहीं बताया गया है. डिफ़ॉल्ट रूप से GASOLINE पर जाएं.
GASOLINE पेट्रोल/पेट्रोल वाला वाहन.
ELECTRIC बिजली से चलने वाला वाहन.
HYBRID हाइब्रिड ईंधन (जैसे, पेट्रोल + इलेक्ट्रिक) वाहन.

VehicleInfo

इसमें वाहन की जानकारी शामिल होती है. जैसे, लाइसेंस प्लेट का आखिरी वर्ण.

फ़ील्ड
emission_type

VehicleEmissionType

यह बताता है कि वाहन किस तरह का उत्सर्जन करता है. यह सिर्फ़ 'डिस्क' के यात्रा मोड पर लागू होता है.

वेपॉइंट

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

फ़ील्ड
via

bool

इस तरीके को स्टॉप पॉइंट के बजाय एक माइलस्टोन के तौर पर मार्क करता है. अनुरोध में बताए गए हर नॉन-थ्रू वेपॉइंट के लिए, जवाब legs कलेक्शन में एक एंट्री जोड़ देता है, ताकि यात्रा के उस हिस्से के स्टॉपओवर के बारे में जानकारी दी जा सके. इस वैल्यू को 'सही' पर तब सेट करें, जब आप चाहते हैं कि रूट बिना रुके इस वेपॉइंट से होकर गुज़र जाए. वेपॉइंट के ज़रिए, legs कलेक्शन में कोई एंट्री नहीं जोड़ी जाती, लेकिन वे वेपॉइंट से यात्रा को रूट करते हैं. आप इस मान को केवल वेपॉइंट पर सेट कर सकते हैं, जो मध्यवर्ती होते हैं. अगर इस फ़ील्ड को टर्मिनल वेपॉइंट पर सेट किया जाता है, तो अनुरोध पूरा नहीं होता. अगर ComputeRoutesRequest.ऑप्टिमाइज़_waypoint_order को 'सही' पर सेट किया गया हो, तो इस फ़ील्ड को 'सही है' पर सेट नहीं किया जा सकता; ऐसा न होने पर, अनुरोध पूरा नहीं हो पाता.
vehicle_stopover

bool

इससे यह पता चलता है कि वेपॉइंट, वाहनों को उस जगह पर रोकने के लिए है जहां इसे पिक अप या ड्रॉप-ऑफ़ किया जा सकता है. यह वैल्यू सेट करने पर, आपके दिए गए फ़ॉर्मूला के आधार पर तैयार किए गए रास्ते में, उन सड़कों पर via वेपॉइंट शामिल नहीं होंगे जो पिकअप और ड्रॉप-ऑफ़ के लिए सही नहीं हैं. यह विकल्प सिर्फ़ DRIVE और TWO_WHEELER के यात्रा मोड में काम करता है. साथ ही, यह location_type के location होने पर काम करता है.
side_of_road

bool

यह बताता है कि इस वेपॉइंट की जगह को प्राथमिकता दी गई है, ताकि वाहन को सड़क के किसी खास तरफ़ रोका जा सके. जब आप यह मान सेट करते हैं, तो मार्ग उस स्थान से गुजरेगा ताकि वाहन सड़क के उस किनारे पर रुक सके जिस स्थान का स्थान सड़क के बीच से पूर्वाग्रह है. यह विकल्प सिर्फ़ 'Drive' के लिए काम करता है और 'TWO_WHEELER' यात्रा के साधन और जब 'location_type' 'location' पर सेट है.
यूनियन फ़ील्ड location_type. किसी जगह को दिखाने के अलग-अलग तरीके. location_type इनमें से सिर्फ़ एक हो सकता है:
location

Location

भौगोलिक निर्देशांक का इस्तेमाल करके तय किया गया पॉइंट, जिसमें एक वैकल्पिक शीर्षक भी शामिल होता है.
place_id

string

वेपॉइंट से जुड़ा लोकप्रिय जगह का आईडी.