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

ComputeRoutes, जवाब वाले मैसेज को भेजता है.

फ़ील्ड
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 लाइनस्ट्रिंग फ़ॉर्मैट का इस्तेमाल करके, पॉलीलाइन की जानकारी देता है.

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 Mandi 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 कोलोराडो, अमेरिका.
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 फ़्लोरिडा, अमेरिका.
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 मैसाचुसेट्स, अमेरिका.
US_MD_EZPASSMD एमडी, अमेरिका.
US_ME_EZPASSME मेन, अमेरिका.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, USA.
US_MI_BCPASS मिशिगन, अमेरिका.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG मिशिगन, अमेरिका.
US_MI_IQ_PROX_CARD

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

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