Package google.maps.routes.v1

इंडेक्स

RoutesPreferred

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 और 'TWO_WHEELER' का इस्तेमाल किया जा सकता है.
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". ज़्यादा जानकारी के लिए, यूनिकोड लोकल आइडेंटिफ़ायर देखें. इस्तेमाल की जा सकने वाली भाषाओं की सूची के लिए, भाषा से जुड़ी सहायता देखें. अगर आपने यह वैल्यू नहीं दी है, तो डिसप्ले भाषा का अनुमान, रास्ते के अनुरोध की जगह से लगाया जाता है.
units

Units

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

ComputeCustomRoutesResponse

ComputeCustomRoutes के जवाब का मैसेज.

फ़ील्ड
routes[]

CustomRoute

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

CustomRoute

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

CustomRoute

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

FallbackInfo

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

FallbackInfo

ComputeCustomRoutes के लिए फ़ॉलबैक की जानकारी को एन्क्रिप्ट (सुरक्षित) करता है. ComputeCustomRoutes दो तरह के फ़ॉलबैक करता है:

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

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

फ़ील्ड
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 से ज़्यादा नहीं होनी चाहिए.
  • अगर routing_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". ज़्यादा जानकारी के लिए, यूनिकोड लोकल आइडेंटिफ़ायर देखें. इस्तेमाल की जा सकने वाली भाषाओं की सूची के लिए, भाषा की सुविधा पर जाएं. यह वैल्यू न देने पर, डिसप्ले की भाषा का अनुमान, रास्ते के अनुरोध की जगह के आधार पर लगाया जाता है.
units

Units

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

bool

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

ComputeRoutesResponse

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

फ़ील्ड
routes[]

Route

compute_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 गोलचक्कर पर दाएं मुड़ें.
DEPART शुरुआती मैन्युवर.
NAME_CHANGE इसका इस्तेमाल सड़क के नाम में बदलाव को दिखाने के लिए किया जाता है.
फ़ील्ड
maneuver

Maneuver

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

string

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

पॉलीलाइन

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

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

string

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

Struct

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

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

ध्यान दें: फ़िलहाल, इस फ़ील्ड में कोई जानकारी नहीं है.

RouteLegTravelAdvisory

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

फ़ील्ड
toll_info

TollInfo

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

SpeedReadingInterval

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

उदाहरण:

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 के हिसाब से ऑप्टिमाइज़ करने के लिए, किसी मकसद को शामिल करता है.

फ़ील्ड
यूनियन फ़ील्ड objective. रूट का मकसद. objective इनमें से कोई एक हो सकता है:
rate_card

RateCard

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

RateCard

RateCard रूट के मकसद को शामिल करता है.

फ़ील्ड
cost_per_minute

MonetaryCost

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

MonetaryCost

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

bool

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

MonetaryCost

रेट कार्ड में इस्तेमाल की गई कीमत को शामिल करता है.

फ़ील्ड
value

double

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

RouteTravelAdvisory

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

फ़ील्ड
toll_info

TollInfo

इसमें रास्ते पर टोल की जानकारी शामिल होती है. इस फ़ील्ड में अपने-आप जानकारी तब भरती है, जब हमें लगता है कि रास्ते पर टोल हैं. अगर यह फ़ील्ड सेट है, लेकिन estimated_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 ट्रैफ़िक की लाइव स्थितियों को ध्यान में रखे बिना, रूट का हिसाब लगाता है. यह तब सही होता है, जब ट्रैफ़िक की स्थिति का कोई फ़र्क़ न पड़ता हो या वह लागू न हो. इस वैल्यू का इस्तेमाल करने पर, इंतज़ार का समय सबसे कम होता है. नोट: RouteTravelMode Drive और TWO_WHEELER के लिए, चुना गया रास्ता और अवधि, सड़क के नेटवर्क और अलग-अलग समय पर ट्रैफ़िक की औसत स्थितियों के आधार पर तय होती है. यह सड़क की मौजूदा स्थिति के हिसाब से नहीं होती. इसलिए, रास्तों में वे सड़कें शामिल हो सकती हैं जो कुछ समय के लिए बंद हैं. सड़क के नेटवर्क में होने वाले बदलावों, ट्रैफ़िक की औसत स्थिति में होने वाले अपडेट, और सेवा के डिस्ट्रिब्यूटेड नेचर की वजह से, किसी अनुरोध के नतीजे समय के साथ अलग-अलग हो सकते हैं. किसी भी समय या फ़्रीक्वेंसी पर, मिलते-जुलते रास्तों के बीच भी नतीजे अलग-अलग हो सकते हैं.
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

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

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 इंडोनेशिया. टोल के पेमेंट के लिए कई बैंकों की ओर से दिया गया ई-कार्ड. बैंकों के ज़रिए जारी किए गए सभी ई-कार्ड के लिए एक ही शुल्क लिया जाता है. इसलिए, सिर्फ़ एक वैल्यू की ज़रूरत होती है. उदाहरण के लिए, Bank Mandiri https://www.bankmandiri.co.id/e-money BCA https://www.bca.co.id/flazz BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG India.
IN_LOCAL_HP_PLATE_EXEMPT भारत, हिमाचल प्रदेश में प्लेट के लिए छूट.
JP_ETC जापान ईटीसी. टोल इकट्ठा करने के लिए इलेक्ट्रॉनिक वायरलेस सिस्टम. https://www.go-etc.jp/
JP_ETC2 जापान ETC2.0. सड़क पर चलने वाले वाहनों और ऐंटीना पर चलने वाले डिवाइसों के बीच, ज़्यादा छूट और दोतरफ़ा कम्यूनिकेशन के साथ, ईटीसी का नया वर्शन. https://www.go-etc.jp/etc2/index.html
MX_IAVE मेक्सिको https://iave.capufe.gob.mx/#/
MX_PASE मेक्सिको https://www.pase.com.mx
MX_QUICKPASS मेक्सिको https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA मेक्सिको http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE मेक्सिको
MX_TAG_TELEVIA मेक्सिको की टोल पास कंपनी. मेक्सिको सिटी में काम करने वाली कई कंपनियों में से एक. ज़्यादा जानकारी के लिए, https://www.televia.com.mx पर जाएं.
MX_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 फ़्लोरिडा, अमेरिका.
US_FL_EPASS फ़्लोरिडा, अमेरिका.
US_FL_GIBA_TOLL_PASS फ़्लोरिडा, अमेरिका.
US_FL_LEEWAY फ़्लोरिडा, अमेरिका.
US_FL_SUNPASS फ़्लोरिडा, अमेरिका.
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 मिशिगन, अमेरिका.
US_MI_BCPASS MI, USA.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, USA.
US_MI_IQ_PROX_CARD

मिशिगन, अमेरिका. यह सुविधा अब उपलब्ध नहीं है, क्योंकि इस तरह का पास अब मौजूद नहीं है.
US_MI_IQ_TAG मिशिगन, अमेरिका.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, USA.
US_MI_NEXPRESS_TOLL मिशिगन, अमेरिका.
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_AVI_TAG टेक्सस, अमेरिका.
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_FUEGO_TAG टेक्सस, अमेरिका.
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 पश्चिमी अमेरिका, भारत.
US_WV_MEMORIAL_BRIDGE_TICKETS पश्चिमी अमेरिका, भारत.
US_WV_MOV_PASS वेस्ट वर्जीनिया, अमेरिका
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

इससे वाहन के उत्सर्जन के टाइप के बारे में पता चलता है. सिर्फ़ DRIVE RouteTravelMode पर लागू होता है.

वेपॉइंट

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

फ़ील्ड
via

bool

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

bool

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

bool

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

Location

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

string

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