Package google.maps.routes.v1

इंडेक्स

RoutesPreferred

The Routes Preferred API.

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_routing_mode और रूटिंग_mode_fallback_reason का इस्तेमाल फ़ॉलबैक रूटिंग मोड के बारे में बताने के साथ-साथ फ़ॉलबैक की वजह के बारे में बताने के लिए भी किया जाता है.

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

फ़ील्ड
routing_mode

FallbackRoutingMode

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

FallbackReason

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

FallbackRouteObjective

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

FallbackRouteObjective

रिस्पॉन्स के लिए रूट ऑब्जेक्टिव का इस्तेमाल किया गया.

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

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

कंप्यूट_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; Intermediates: डलास, Bangor, फ़ीनिक्स; डेस्टिनेशन: New York; है. साथ ही, ऑप्टिमाइज़ किया गया इंटरमीडिएट वेपॉइंट ऑर्डर फ़ीनिक्स, डैलस, बैंगर है. इसके बाद, इस फ़ील्ड में वैल्यू [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 पर टोल की जानकारी इकट्ठा करता है. यह फ़ील्ड सिर्फ़ तब भरा जाता है, जब हमें लगता है कि रूटलेग पर टोल मौजूद हैं. अगर यह फ़ील्ड सेट है, लेकिन engagement_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).

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

रास्ते पर टोल की जानकारी शामिल करता है. यह फ़ील्ड सिर्फ़ तब भरा जाता है, जब हमें लगता है कि रास्ते पर टोल हैं. अगर यह फ़ील्ड सेट है, लेकिन engagement_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

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

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 इंडोनेशिया. टोल का पेमेंट करने के लिए कई बैंकों से मिला ई-कार्ड. बैंक से गुज़रने वाले सभी ई-कार्ड पर एक जैसा शुल्क लगता है. इसलिए, सिर्फ़ एक Enum वैल्यू की ज़रूरत होती है. उदाहरण के लिए, Bank Centeri https://www.bankmandiri.co.id/e-money बीसीए https://www.bca.co.id/flazz BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG भारत.
IN_LOCAL_HP_PLATE_EXEMPT भारत, एचपी स्टेट प्लेट में छूट.
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 AL, अमेरिका.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, अमेरिका.
US_CA_FASTRAK कनाडा, अमेरिका.
US_CA_FASTRAK_CAV_STICKER इससे पता चलता है कि डीएमवी की ओर से जारी किए गए क्लीन एयर व्हीकल (सीएवी) स्टिकर के अलावा ड्राइवर के पास कोई FasTrak पास है. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, USA.
US_CO_GO_PASS CO, USA.
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 KS, अमेरिका.
US_KS_KTAG KS, अमेरिका.
US_KS_NATIONALPASS KS, अमेरिका.
US_KS_PREPASS_ELITEPASS KS, अमेरिका.
US_LA_GEAUXPASS लॉस एंजेलिस, अमेरिका.
US_LA_TOLL_TAG लॉस एंजेलिस, अमेरिका.
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD एमडी, अमेरिका.
US_ME_EZPASSME ME, USA.
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 NC, USA.
US_NC_PEACH_PASS NC, USA.
US_NC_QUICK_PASS NC, USA.
US_NH_EZPASSNH एनएच, अमेरिका.
US_NJ_DOWNBEACH_EXPRESS_PASS न्यूजर्सी, अमेरिका.
US_NJ_EZPASSNJ न्यूजर्सी, अमेरिका.
US_NY_EXPRESSPASS न्यूयॉर्क, अमेरिका.
US_NY_EZPASSNY न्यूयॉर्क, अमेरिका.
US_OH_EZPASSOH ओह, अमेरिका.
US_PA_EZPASSPA पीए, अमेरिका.
US_RI_EZPASSRI आरआई, अमेरिका.
US_SC_PALPASS SC, अमेरिका.
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 वीए, अमेरिका.
US_WA_BREEZEBY वॉशिंगटन, अमेरिका.
US_WA_GOOD_TO_GO वॉशिंगटन, अमेरिका.
US_WV_EZPASSWV WV, अमेरिका.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, अमेरिका.
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, अमेरिका.

इकाइयां

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

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

VehicleEmissionType

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

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

VehicleInfo

वाहन की जानकारी, जैसे कि लाइसेंस प्लेट के आखिरी वर्ण की जानकारी को एन्क्रिप्ट (सुरक्षित) करता है.

फ़ील्ड
emission_type

VehicleEmissionType

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

वेपॉइंट

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

फ़ील्ड
via

bool

इस वेपॉइंट को रुकने के बजाय माइलस्टोन के तौर पर मार्क करता है. अनुरोध में दिए गए हर वेपॉइंट के लिए, जो यात्रा के लिए उपलब्ध नहीं है, रिस्पॉन्स legs कलेक्शन में एक एंट्री जोड़ता है, ताकि यात्रा के उस हिस्से के स्टॉप की जानकारी दी जा सके. जब आपको रूट को बिना रुके इस वेपॉइंट से गुज़रना हो, तब इस वैल्यू को 'सही' पर सेट करें. वेपॉइंट के ज़रिए legs कलेक्शन में एंट्री नहीं जोड़ी जाती, लेकिन वे वेपॉइंट से यात्रा को रूट करती हैं. इस वैल्यू को सिर्फ़ इंटरमीडिएट वेपॉइंट पर सेट किया जा सकता है. अगर आप इस फ़ील्ड को टर्मिनल वेपॉइंट पर सेट करते हैं, तो अनुरोध नहीं हो पाता. अगर ComputeRoutesRequest.optimize_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

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