Package google.maps.routing.v2

इंडेक्स

रास्ते

Routes API.

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, वाइल्डकार्ड (*) रिस्पॉन्स फ़ील्ड मास्क का इस्तेमाल करने से रोकता है, क्योंकि:

  • सिर्फ़ ज़रूरी फ़ील्ड चुनने से, हमारे सर्वर को कंप्यूटेशन साइकल सेव करने में मदद मिलती है. इससे हम आपको कम समय में नतीजे दिखा पाते हैं.
  • प्रोडक्शन जॉब में सिर्फ़ ज़रूरी फ़ील्ड चुनने से, लेटेन्सी की परफ़ॉर्मेंस बेहतर होती है. हम आने वाले समय में, जवाब के ज़्यादा फ़ील्ड जोड़ सकते हैं. इन नए फ़ील्ड के लिए, ज़्यादा समय लग सकता है. सभी फ़ील्ड चुनने पर या टॉप लेवल पर सभी फ़ील्ड चुनने पर, परफ़ॉर्मेंस में गिरावट आ सकती है. ऐसा इसलिए, क्योंकि जोड़े गए किसी भी नए फ़ील्ड को जवाब में अपने-आप शामिल कर लिया जाएगा.
  • सिर्फ़ उन फ़ील्ड को चुनने से जिनकी आपको ज़रूरत है, जवाब का साइज़ छोटा हो जाता है. इससे नेटवर्क थ्रूपुट बढ़ जाता है.
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) पर फ़ील्ड मास्क तय करने का सुझाव नहीं देता है. इसकी वजह यह है कि:

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

ComputeRouteMatrixRequest

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

फ़ील्ड
origins[]

RouteMatrixOrigin

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

  • place_id या address के तौर पर तय किए गए ऑरिजिन और डेस्टिनेशन की कुल संख्या 50 से ज़्यादा नहीं होनी चाहिए.
  • किसी भी मामले में, ऑरिजिन की संख्या × डेस्टिनेशन की संख्या का गुणनफल 625 से ज़्यादा नहीं होना चाहिए.
  • अगर routing_preference को TRAFFIC_AWARE_OPTIMAL पर सेट किया गया है, तो ऑरिजिन की संख्या × डेस्टिनेशन की संख्या का गुणनफल 100 से ज़्यादा नहीं होना चाहिए.
  • अगर travel_mode को TRANSIT पर सेट किया गया है, तो मूल जगहों की संख्या × मंज़िलों की संख्या का गुणनफल 100 से ज़्यादा नहीं होना चाहिए.
destinations[]

RouteMatrixDestination

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

travel_mode

RouteTravelMode

ज़रूरी नहीं. इससे यात्रा के साधन के बारे में पता चलता है.

routing_preference

RoutingPreference

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

departure_time

Timestamp

ज़रूरी नहीं. रवाना होने का समय. अगर आपने यह वैल्यू सेट नहीं की है, तो यह वैल्यू डिफ़ॉल्ट रूप से उस समय पर सेट हो जाती है जब आपने अनुरोध किया था. ध्यान दें: departure_time को सिर्फ़ तब पुरानी तारीख पर सेट किया जा सकता है, जब RouteTravelMode को TRANSIT पर सेट किया गया हो.

arrival_time

Timestamp

ज़रूरी नहीं. पहुंचने का समय. ध्यान दें: इसे सिर्फ़ तब सेट किया जा सकता है, जब RouteTravelMode को TRANSIT पर सेट किया गया हो. departure_time या arrival_time में से किसी एक को तय किया जा सकता है, लेकिन दोनों को नहीं.

language_code

string

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

region_code

string

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

units

Units

ज़रूरी नहीं. यह डिसप्ले फ़ील्ड के लिए, मेज़रमेंट की यूनिट तय करता है.

extra_computations[]

ExtraComputation

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

traffic_model

TrafficModel

ज़रूरी नहीं. ट्रैफ़िक में लगने वाले समय का हिसाब लगाते समय इस्तेमाल की जाने वाली मान्यताओं के बारे में बताता है. इस सेटिंग से, RouteMatrixElement में मौजूद अवधि फ़ील्ड में दिखाई गई वैल्यू पर असर पड़ता है. इस वैल्यू में, अब तक के औसत समय के आधार पर ट्रैफ़िक में लगने वाले अनुमानित समय की जानकारी होती है. TrafficModel सिर्फ़ उन अनुरोधों के लिए उपलब्ध है जिनमें RoutingPreference को TRAFFIC_AWARE_OPTIMAL और RouteTravelMode को DRIVE पर सेट किया गया है. अगर ट्रैफ़िक का अनुरोध किया गया है और TrafficModel की वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट रूप से इसकी वैल्यू BEST_GUESS होती है.

transit_preferences

TransitPreferences

ज़रूरी नहीं. यह उन प्राथमिकताओं के बारे में बताता है जो TRANSIT रास्तों के लिए दिखाए गए रूट पर असर डालती हैं. ध्यान दें: RouteTravelMode को TRANSIT पर सेट करने पर ही, transit_preferences की जानकारी दी जा सकती है.

ExtraComputation

अनुरोध पूरा करते समय, अतिरिक्त कैलकुलेशन की जाती हैं.

Enums
EXTRA_COMPUTATION_UNSPECIFIED इस्तेमाल नहीं किया जाता. इस वैल्यू वाले अनुरोध पूरे नहीं किए जा सकेंगे.
TOLLS मैट्रिक्स एलिमेंट के लिए टोल की जानकारी.

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

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

arrival_time

Timestamp

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

compute_alternative_routes

bool

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

route_modifiers

RouteModifiers

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

language_code

string

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

region_code

string

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

units

Units

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

optimize_waypoint_order

bool

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

requested_reference_routes[]

ReferenceRoute

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

extra_computations[]

ExtraComputation

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

traffic_model

TrafficModel

ज़रूरी नहीं. ट्रैफ़िक में लगने वाले समय का हिसाब लगाते समय इस्तेमाल की जाने वाली मान्यताओं के बारे में बताता है. इस सेटिंग से, Route और RouteLeg में मौजूद अवधि फ़ील्ड में दिखाई गई वैल्यू पर असर पड़ता है. इस वैल्यू में, ट्रैफ़िक के हिसाब से अनुमानित समय शामिल होता है. यह अनुमान, पिछले समय के औसत के आधार पर लगाया जाता है. TrafficModel सिर्फ़ उन अनुरोधों के लिए उपलब्ध है जिनमें RoutingPreference को TRAFFIC_AWARE_OPTIMAL और RouteTravelMode को DRIVE पर सेट किया गया है. अगर ट्रैफ़िक का अनुरोध किया गया है और TrafficModel की वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट रूप से इसकी वैल्यू BEST_GUESS होती है.

transit_preferences

TransitPreferences

ज़रूरी नहीं. यह उन प्राथमिकताओं के बारे में बताता है जो TRANSIT रास्तों के लिए दिखाए गए रूट पर असर डालती हैं. ध्यान दें: RouteTravelMode को TRANSIT पर सेट करने पर ही, transit_preferences की जानकारी दी जा सकती है.

ExtraComputation

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

Enums
EXTRA_COMPUTATION_UNSPECIFIED इस्तेमाल नहीं किया जाता. इस वैल्यू वाले अनुरोध पूरे नहीं किए जा सकेंगे.
TOLLS रास्ते के लिए टोल की जानकारी.
FUEL_CONSUMPTION रास्ते के लिए ईंधन की अनुमानित खपत.
TRAFFIC_ON_POLYLINE रास्ते के लिए, ट्रैफ़िक की जानकारी देने वाली पॉलीलाइन.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstruction को फ़ॉर्मैट किए गए एचटीएमएल टेक्स्ट स्ट्रिंग के तौर पर दिखाया जाता है. इस कॉन्टेंट को जैसा है वैसा ही पढ़ा जाना चाहिए. यह कॉन्टेंट सिर्फ़ दिखाने के लिए है. इसे प्रोग्राम के हिसाब से पार्स न करें.
FLYOVER_INFO_ON_POLYLINE रास्ते के फ़्लाइओवर की जानकारी. यह जानकारी पाने के लिए, routes.polyline_details.flyover_info फ़ील्डमास्क तय करना ज़रूरी है. फ़िलहाल, यह डेटा सिर्फ़ भारत के कुछ महानगरों के लिए उपलब्ध होगा. यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है. इसलिए, एसकेयू/शुल्क में बदलाव हो सकता है.
NARROW_ROAD_INFO_ON_POLYLINE रास्ते की संकरी सड़क की जानकारी. यह जानकारी पाने के लिए, routes.polyline_details.narrow_road_info फ़ील्डमास्क तय करना ज़रूरी है. फ़िलहाल, यह डेटा सिर्फ़ भारत के कुछ महानगरों के लिए उपलब्ध होगा. यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है. इसलिए, एसकेयू/शुल्क में बदलाव हो सकता है.
TUNNEL_INFO_ON_POLYLINE रास्ते में आने वाली सुरंगों के बारे में जानकारी. यह जानकारी पाने के लिए, routes.polyline_details.tunnel_info फ़ील्डमास्क तय करना ज़रूरी है.
BRIDGE_INFO_ON_POLYLINE रास्ते के पुल की जानकारी. यह जानकारी पाने के लिए, routes.polyline_details.bridge_info फ़ील्डमास्क तय करना ज़रूरी है.
SKYWAY_INFO_ON_POLYLINE रास्ते के लिए स्काईवे की जानकारी. यह जानकारी पाने के लिए, routes.polyline_details.skyway_info फ़ील्डमास्क तय करना ज़रूरी है.

ReferenceRoute

ComputeRoutesRequest पर, सहायता पाने के लिए रेफ़रंस रूट.

Enums
REFERENCE_ROUTE_UNSPECIFIED इस्तेमाल नहीं किया जाता. इस वैल्यू वाले अनुरोध पूरे नहीं किए जा सकते.
FUEL_EFFICIENT ईंधन की कम खपत वाला रास्ता.
SHORTER_DISTANCE

कम दूरी वाला रास्ता. यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है.

DRIVE अनुरोधों के लिए, यह सुविधा ड्राइविंग के दौरान मिलने वाली सुविधा के बजाय कम दूरी को प्राथमिकता देती है. उदाहरण के लिए, यह हाइवे के बजाय स्थानीय सड़कों को प्राथमिकता दे सकता है, कच्ची सड़कों पर चल सकता है, पार्किंग लॉट से होकर जा सकता है वगैरह. यह सुविधा ऐसे किसी भी मोड़ या गतिविधि के बारे में जानकारी नहीं देती जिसे Google Maps गैर-कानूनी मानता है.

BICYCLE और TWO_WHEELER के अनुरोधों के लिए, यह सुविधा ऐसे रास्ते दिखाती है जो requested_reference_routes तय न करने पर दिखाए जाते हैं.

यह सुविधा, यात्रा के किसी अन्य तरीके, बीच के वेपॉइंट या optimize_waypoint_order के साथ काम नहीं करती. ऐसे अनुरोध पूरे नहीं किए जा सकेंगे. हालांकि, इसका इस्तेमाल किसी भी routing_preference के साथ किया जा सकता है.

ComputeRoutesResponse

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

फ़ील्ड
routes[]

Route

compute_alternatives_routes तय करने पर, इसमें कैलकुलेट किए गए रास्तों (ज़्यादा से ज़्यादा तीन) की एक कैटगरी होती है. वहीं, इसे तय न करने पर, इसमें सिर्फ़ एक रास्ता होता है. जब इस ऐरे में कई एंट्री होती हैं, तो पहली एंट्री सबसे ज़्यादा सुझाई गई यात्रा का रास्ता होती है. अगर ऐरे खाली है, तो इसका मतलब है कि कोई रास्ता नहीं मिला.

fallback_info

FallbackInfo

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

geocoding_results

GeocodingResults

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

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 RoutingPreference का इस्तेमाल किया गया था.
FALLBACK_TRAFFIC_AWARE इससे पता चलता है कि जवाब जनरेट करने के लिए, TRAFFIC_AWARE RoutingPreference का इस्तेमाल किया गया था.

GeocodedWaypoint

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

फ़ील्ड
geocoder_status

Status

इससे, जियोकोडिंग ऑपरेशन से मिले स्टेटस कोड की जानकारी मिलती है.

type[]

string

नतीजे का टाइप, शून्य या उससे ज़्यादा टाइप टैग के तौर पर. इस्तेमाल किए जा सकने वाले टाइप: पते के टाइप और पते के कॉम्पोनेंट टाइप.

partial_match

bool

इससे पता चलता है कि जियोकोडर ने मूल अनुरोध के लिए सटीक मैच नहीं दिया है. हालांकि, वह अनुरोध किए गए पते के कुछ हिस्से से मेल खाने वाली जानकारी दे पाया है. ऐसा हो सकता है कि आपने पते में स्पेलिंग की कोई गलती की हो या पता अधूरा हो. इसलिए, हमारा सुझाव है कि आप मूल अनुरोध की जांच करें.

place_id

string

इस नतीजे के लिए जगह का आईडी.

intermediate_waypoint_request_index

int32

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

GeocodingResults

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

फ़ील्ड
origin

GeocodedWaypoint

ऑरिजिन का जियोकोड किया गया वेपॉइंट.

destination

GeocodedWaypoint

मंज़िल के जियोकोड किए गए वेपॉइंट.

intermediates[]

GeocodedWaypoint

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

LocalizedTime

समय के बारे में स्थानीय भाषा में जानकारी.

फ़ील्ड
time

LocalizedText

किसी टाइम ज़ोन में, स्ट्रिंग के तौर पर दिया गया समय.

time_zone

string

इसमें टाइम ज़ोन की जानकारी होती है. यह वैल्यू, आईएएनए टाइम ज़ोन डेटाबेस में तय किए गए टाइम ज़ोन का नाम है. जैसे, "America/New_York".

जगह

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

फ़ील्ड
lat_lng

LatLng

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

heading

Int32Value

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

सामान को एक जगह से दूसरी जगह ले जाने में मदद

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

Enums
MANEUVER_UNSPECIFIED इस्तेमाल नहीं किया जाता.
TURN_SLIGHT_LEFT थोड़ा बाईं ओर मुड़ें.
TURN_SHARP_LEFT तेज़ी से बाईं ओर मुड़ें.
UTURN_LEFT बाईं ओर यू-टर्न लें.
TURN_LEFT बाईं ओर मुड़ें.
TURN_SLIGHT_RIGHT थोड़ा राइट मुड़ें.
TURN_SHARP_RIGHT तेज़ी से दाईं ओर मुड़ें.
UTURN_RIGHT दाईं ओर यू-टर्न लें.
TURN_RIGHT दाईं ओर मुड़ें.
STRAIGHT सीधे जाओ.
RAMP_LEFT बाईं ओर मौजूद रैंप का इस्तेमाल करें.
RAMP_RIGHT राइट साइड वाला रैंप लें.
MERGE ट्रैफ़िक में शामिल हों.
FORK_LEFT बाएँ फ़ोर्क का इस्तेमाल करें.
FORK_RIGHT दाईं ओर वाली सड़क लें.
FERRY फ़ेरी लें.
FERRY_TRAIN ट्रेन से फ़ेरी तक जाएं.
ROUNDABOUT_LEFT गोल चक्कर से लेफ़्ट मुड़ें.
ROUNDABOUT_RIGHT गोल चक्कर से राइट मुड़ें.
DEPART शुरुआती पैंतरा.
NAME_CHANGE इसका इस्तेमाल, सड़क का नाम बदलने की जानकारी देने के लिए किया जाता है.

इस कुकी में, RouteLegStep के लिए नेविगेशन के निर्देशों की जानकारी होती है.

फ़ील्ड
maneuver

Maneuver

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

instructions

string

इस चरण को पूरा करने के निर्देश.

पॉलीलाइन

इसमें कोड में बदली गई पॉलीलाइन शामिल होती है.

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

string

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

geo_json_linestring

Struct

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

PolylineDetails

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

फ़ील्ड
tunnel_info[]

TunnelInfo

पॉलीलाइन के साथ-साथ टनल की जानकारी. अगर अनुरोध में avoid_tunnels रूट मॉडिफ़ायर के बारे में बताया गया है और नतीजे के तौर पर मिले रूट में उनका इस्तेमाल नहीं किया गया है, तो इस फ़ील्ड में जानकारी अपने-आप भर जाती है. इसके अलावा, अगर extra_computations में TUNNEL_INFO_ON_POLYLINE के बारे में बताया गया है और रूट में सुरंगें शामिल हैं, तो भी इस फ़ील्ड में जानकारी अपने-आप भर जाती है.

restriction_info[]

RestrictionInfo

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

flyover_info[]

FlyoverInfo

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

narrow_road_info[]

NarrowRoadInfo

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

bridge_info[]

BridgeInfo

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

skyway_info[]

SkywayInfo

पॉलीलाइन के साथ-साथ स्काईवे की जानकारी.

BridgeInfo

इसमें पॉलीलाइन के साथ-साथ पुलों के बारे में जानकारी शामिल होती है.

फ़ील्ड
bridge_presence

RoadFeatureState

इससे पता चलता है कि पॉलीलाइन के किसी हिस्से के लिए पुल मौजूद है या नहीं.

polyline_point_index

PolylinePointIndex

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

FlyoverInfo

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

फ़ील्ड
flyover_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

पॉलीलाइन के साथ-साथ फ़्लाइओवर से जुड़ी जानकारी की जगह.

NarrowRoadInfo

इसमें पॉलीलाइन के साथ-साथ संकरी सड़कों के बारे में जानकारी होती है.

फ़ील्ड
narrow_road_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

पॉलीलाइन के साथ-साथ, संकरी सड़क से जुड़ी जानकारी की जगह.

PolylinePointIndex

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

फ़ील्ड
start_index

int32

पॉलीलाइन में इस जानकारी का शुरुआती इंडेक्स.

end_index

int32

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

RestrictionInfo

इस फ़ील्ड में, पॉलीलाइन के साथ-साथ अलग-अलग पाबंदियों के बारे में जानकारी शामिल होती है.

फ़ील्ड
restriction_presence

RoadFeatureState

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि पॉलीलाइन के किसी हिस्से पर पाबंदी है या नहीं.

polyline_point_index

PolylinePointIndex

पॉलीलाइन के साथ-साथ पाबंदी से जुड़ी जानकारी की जगह.

यूनियन फ़ील्ड restriction. इससे यह पता चलता है कि पॉलीलाइन के किसी हिस्से पर किस तरह की पाबंदियां लागू हो सकती हैं. restriction इनमें से सिर्फ़ एक हो सकता है:
restricted_height_mm

int64

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

restricted_weight_kg

int64

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

hazardous_goods

bool

खतरनाक सामान ले जाने पर पाबंदी होने पर, इस फ़ील्ड को 'सही है' पर सेट किया जाता है.

trucks_prohibited

bool

ट्रकों को अनुमति न होने पर, इस फ़ील्ड को 'सही है' पर सेट किया जाता है.

RoadFeatureState

इसमें पॉलीलाइन के किसी हिस्से में मौजूद सड़क की सुविधाओं की स्थितियां शामिल होती हैं.

Enums
ROAD_FEATURE_STATE_UNSPECIFIED सड़क की सुविधा की स्थिति का हिसाब नहीं लगाया गया (डिफ़ॉल्ट वैल्यू).
EXISTS सड़क की सुविधा मौजूद है.
DOES_NOT_EXIST सड़क की सुविधा मौजूद नहीं है.

SkywayInfo

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

फ़ील्ड
skyway_presence

RoadFeatureState

इससे पता चलता है कि पॉलीलाइन के किसी हिस्से के लिए स्काईवे मौजूद है या नहीं.

polyline_point_index

PolylinePointIndex

पॉलीलाइन के साथ-साथ स्काईवे से जुड़ी जानकारी की जगह.

TunnelInfo

इसमें पॉलीलाइन के साथ-साथ टनल के बारे में जानकारी शामिल होती है.

फ़ील्ड
tunnel_presence

RoadFeatureState

इससे पता चलता है कि पॉलीलाइन के किसी हिस्से के लिए टनल मौजूद है या नहीं.

polyline_point_index

PolylinePointIndex

पॉलीलाइन के साथ-साथ, सुरंग से जुड़ी जानकारी की जगह.

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 विकल्प का इस्तेमाल करने की तुलना में कम होता है.

रास्ता

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

फ़ील्ड
route_labels[]

RouteLabel

Route के लिए लेबल. इनकी मदद से, रास्ते की खास प्रॉपर्टी की पहचान की जा सकती है, ताकि उनकी तुलना अन्य प्रॉपर्टी से की जा सके.

legs[]

RouteLeg

लेग (वेपॉइंट के बीच के पाथ सेगमेंट) का ऐसा कलेक्शन जो रूट बनाता है. हर लेग, दो नॉन-via Waypoints के बीच की यात्रा से जुड़ा होता है. उदाहरण के लिए, अगर किसी रास्ते में कोई इंटरमीडिएट वेपॉइंट नहीं है, तो उसमें सिर्फ़ एक लेग होता है. ऐसे रूट में दो लेग होते हैं जिसमें एक नॉन-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

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

localized_values

RouteLocalizedValues

Route की प्रॉपर्टी के टेक्स्ट फ़ॉर्मैट में दिए गए उदाहरण.

route_token

string

यह एक ओपेक टोकन है. इसे Navigation SDK को पास किया जा सकता है. इससे नेविगेशन के दौरान रास्ते को फिर से बनाया जा सकता है. साथ ही, रास्ता बदलने की स्थिति में, रास्ता बनाते समय उपयोगकर्ता के मूल मकसद को पूरा किया जा सकता है. इस टोकन को ओपेक ब्लोब के तौर पर माना जाता है. इसकी वैल्यू की तुलना अलग-अलग अनुरोधों के लिए न करें, क्योंकि सेवा से एक ही रूट की जानकारी मिलने पर भी इसकी वैल्यू बदल सकती है.

ध्यान दें: Route.route_token सिर्फ़ उन अनुरोधों के लिए उपलब्ध है जिनमें ComputeRoutesRequest.routing_preference को TRAFFIC_AWARE या TRAFFIC_AWARE_OPTIMAL पर सेट किया गया है. Route.route_token फ़ंक्शन, उन अनुरोधों के लिए काम नहीं करता जिनमें रास्ते में पड़ने वाली जगहों के वेपॉइंट शामिल होते हैं.

polyline_details

PolylineDetails

इसमें पॉलीलाइन के साथ-साथ जानकारी होती है.

RouteLocalizedValues

कुछ प्रॉपर्टी के टेक्स्ट वर्शन.

फ़ील्ड
distance

LocalizedText

यात्रा की दूरी को टेक्स्ट के तौर पर दिखाया गया है.

duration

LocalizedText

अवधि, जिसे टेक्स्ट के तौर पर दिखाया जाता है और क्वेरी के देश/इलाके के हिसाब से स्थानीय भाषा में दिखाया जाता है. इसमें ट्रैफ़िक का हाल ध्यान में रखा जाता है. ध्यान दें: अगर आपने ट्रैफ़िक की जानकारी का अनुरोध नहीं किया है, तो यह वैल्यू, static_duration की वैल्यू के बराबर होती है.

static_duration

LocalizedText

ट्रैफ़िक की स्थिति को ध्यान में रखे बिना, टेक्स्ट के तौर पर दिखाया गया समय.

transit_fare

LocalizedText

किराये की जानकारी टेक्स्ट के तौर पर दी गई है.

RouteLabel

Route के लिए लेबल. इनकी मदद से, रास्ते की खास प्रॉपर्टी की पहचान की जा सकती है, ताकि उनकी तुलना अन्य प्रॉपर्टी से की जा सके.

Enums
ROUTE_LABEL_UNSPECIFIED डिफ़ॉल्ट - इसका इस्तेमाल नहीं किया जाता.
DEFAULT_ROUTE रास्ते का हिसाब लगाने के लिए, डिफ़ॉल्ट तौर पर "सबसे अच्छा" रूट दिखाया जाता है.
DEFAULT_ROUTE_ALTERNATE डिफ़ॉल्ट रूप से चुने गए "सबसे अच्छे" रास्ते के अलावा कोई दूसरा रास्ता. compute_alternative_routes के बारे में जानकारी देने पर, इस तरह के रास्ते दिखाए जाएंगे.
FUEL_EFFICIENT ईंधन की कम खपत वाला रास्ता. इस वैल्यू के साथ लेबल किए गए रास्तों को, ईंधन की खपत जैसे इको पैरामीटर के लिए ऑप्टिमाइज़ किया जाता है.
SHORTER_DISTANCE कम दूरी वाला रास्ता. यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है.

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

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

localized_values

RouteLegLocalizedValues

RouteLeg की प्रॉपर्टी के टेक्स्ट फ़ॉर्मैट में दिए गए उदाहरण.

steps_overview

StepsOverview

इस RouteLeg में दिए गए चरणों के बारे में खास जानकारी. यह फ़ील्ड सिर्फ़ सार्वजनिक परिवहन के रास्तों के लिए भरा जाता है.

RouteLegLocalizedValues

कुछ प्रॉपर्टी के टेक्स्ट वर्शन.

फ़ील्ड
distance

LocalizedText

यात्रा की दूरी को टेक्स्ट के तौर पर दिखाया गया है.

duration

LocalizedText

अवधि, जिसे टेक्स्ट के तौर पर दिखाया जाता है और क्वेरी के क्षेत्र के हिसाब से स्थानीय भाषा में दिखाया जाता है. इसमें ट्रैफ़िक का हाल ध्यान में रखा जाता है. ध्यान दें: अगर आपने ट्रैफ़िक की जानकारी का अनुरोध नहीं किया है, तो यह वैल्यू, static_duration की वैल्यू के बराबर होती है.

static_duration

LocalizedText

ट्रैफ़िक की स्थिति को ध्यान में रखे बिना, टेक्स्ट के तौर पर दिखाया गया समय.

StepsOverview

RouteLegStep की सूची के बारे में खास जानकारी देता है.

फ़ील्ड
multi_modal_segments[]

MultiModalSegment

RouteLeg.steps के अलग-अलग मल्टी-मॉडल सेगमेंट के बारे में खास जानकारी. अगर RouteLeg में चरणों के दौरान कोई मल्टी-मॉडल सेगमेंट शामिल नहीं है, तो इस फ़ील्ड में अपने-आप जानकारी नहीं भरती.

MultiModalSegment

RouteLeg.steps के अलग-अलग मल्टी-मॉडल सेगमेंट के बारे में खास जानकारी देता है. एक से ज़्यादा मोड वाले सेगमेंट को एक या उससे ज़्यादा लगातार RouteLegStep के तौर पर तय किया जाता है. इनमें एक ही RouteTravelMode होता है. अगर RouteLeg में चरणों के दौरान कोई मल्टी-मॉडल सेगमेंट शामिल नहीं है, तो इस फ़ील्ड में अपने-आप जानकारी नहीं भरती.

फ़ील्ड
navigation_instruction

NavigationInstruction

मल्टी-मॉडल सेगमेंट के लिए NavigationInstruction.

travel_mode

RouteTravelMode

अलग-अलग मोड वाले सेगमेंट के लिए यात्रा का मोड.

step_start_index

int32

यह RouteLegStep इंडेक्स, मल्टी-मॉडल सेगमेंट की शुरुआत में होता है.

step_end_index

int32

इससे जुड़ा RouteLegStep इंडेक्स, जो मल्टी-मॉडल सेगमेंट का आखिरी हिस्सा है.

RouteLegStep

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

फ़ील्ड
distance_meters

int32

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

static_duration

Duration

इस चरण में यात्रा करने में लगने वाला समय. इसमें ट्रैफ़िक का हाल ध्यान में नहीं रखा जाता. कुछ मामलों में, इस फ़ील्ड में कोई वैल्यू नहीं हो सकती.

polyline

Polyline

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

start_location

Location

इस चरण के लिए यात्रा शुरू करने की जगह.

end_location

Location

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

navigation_instruction

NavigationInstruction

नेविगेशन के निर्देश.

travel_advisory

RouteLegStepTravelAdvisory

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

localized_values

RouteLegStepLocalizedValues

RouteLegStep की प्रॉपर्टी के टेक्स्ट फ़ॉर्मैट में दिए गए उदाहरण.

transit_details

RouteLegStepTransitDetails

अगर यात्रा का मोड TRANSIT है, तो इस चरण के बारे में जानकारी.

travel_mode

RouteTravelMode

इस चरण के लिए इस्तेमाल किया गया यात्रा मोड.

RouteLegStepLocalizedValues

कुछ प्रॉपर्टी के टेक्स्ट वर्शन.

फ़ील्ड
distance

LocalizedText

यात्रा की दूरी को टेक्स्ट के तौर पर दिखाया गया है.

static_duration

LocalizedText

ट्रैफ़िक की स्थिति को ध्यान में रखे बिना, टेक्स्ट के तौर पर दिखाया गया समय.

RouteLegStepTransitDetails

RouteLegStep के लिए, TRANSIT रास्तों से जुड़ी अतिरिक्त जानकारी.

फ़ील्ड
stop_details

TransitStopDetails

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

localized_values

TransitDetailsLocalizedValues

RouteLegStepTransitDetails की प्रॉपर्टी के टेक्स्ट फ़ॉर्मैट में दिए गए उदाहरण.

headsign

string

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

headway

Duration

इस समय, एक ही स्टॉप से जाने के समय के बीच का अंतर बताता है. उदाहरण के लिए, अगर हेडवे सेकंड की वैल्यू 600 है, तो बस छूट जाने पर आपको दस मिनट इंतज़ार करना होगा.

transit_line

TransitLine

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

stop_count

int32

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

trip_short_text

string

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

TransitDetailsLocalizedValues

RouteTransitDetails के लिए वैल्यू की स्थानीय भाषा में जानकारी.

फ़ील्ड
arrival_time

LocalizedTime

टाइमज़ोन के साथ, फ़ॉर्मैट किए गए टेक्स्ट के तौर पर समय.

departure_time

LocalizedTime

टाइमज़ोन के साथ, फ़ॉर्मैट किए गए टेक्स्ट के तौर पर समय.

TransitStopDetails

RouteLegStep के ट्रांज़िट स्टॉप के बारे में जानकारी.

फ़ील्ड
arrival_stop

TransitStop

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

arrival_time

Timestamp

इस चरण के पूरा होने का अनुमानित समय.

departure_stop

TransitStop

इस चरण के लिए, बस के रवाना होने के स्टॉप की जानकारी.

departure_time

Timestamp

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

RouteLegStepTravelAdvisory

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

फ़ील्ड
speed_reading_intervals[]

SpeedReadingInterval

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

RouteLegTravelAdvisory

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

फ़ील्ड
toll_info

TollInfo

इस कुकी में, किसी खास RouteLeg पर लगने वाले टोल के बारे में जानकारी होती है. इस फ़ील्ड में वैल्यू सिर्फ़ तब भरी जाती है, जब हमें लगता है कि RouteLeg पर टोल है और TOLLS को अनुरोध के ComputeRoutesRequest.extra_computations में शामिल किया गया है. अगर यह फ़ील्ड सेट है, लेकिन estimated_price सब-फ़ील्ड में वैल्यू नहीं भरी गई है, तो इसका मतलब है कि सड़क पर टोल है, लेकिन हमें अनुमानित कीमत के बारे में जानकारी नहीं है. अगर toll_info मौजूद नहीं है, तो RouteLeg पर कोई टोल नहीं है.

speed_reading_intervals[]

SpeedReadingInterval

ट्रैफ़िक की सघनता दिखाने वाले स्पीड रीडिंग इंटरवल. यह फ़ील्ड सिर्फ़ उन अनुरोधों के लिए भरा जाता है जिनमें अनुरोध की वैल्यू TRAFFIC_AWARE या TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference होती है. साथ ही, TRAFFIC_ON_POLYLINE को ComputeRoutesRequest.extra_computations में शामिल किया जाता है. ये इंटरवल, 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 में, शुरुआती जगह/मंज़िल के जोड़े के लिए कैलकुलेट की गई रास्ते की जानकारी होती है. इस प्रोटो को क्लाइंट को स्ट्रीम किया जा सकता है.

फ़ील्ड
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

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

localized_values

LocalizedValues

RouteMatrixElement की प्रॉपर्टी के टेक्स्ट फ़ॉर्मैट में दिए गए उदाहरण.

origin_index

int32

अनुरोध में मौजूद ऑरिजिन का ज़ीरो-आधारित इंडेक्स.

destination_index

int32

अनुरोध में मौजूद डेस्टिनेशन का ज़ीरो-आधारित इंडेक्स.

LocalizedValues

कुछ प्रॉपर्टी के टेक्स्ट वर्शन.

फ़ील्ड
distance

LocalizedText

यात्रा की दूरी को टेक्स्ट के तौर पर दिखाया गया है.

duration

LocalizedText

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

static_duration

LocalizedText

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

transit_fare

LocalizedText

किराये की जानकारी टेक्स्ट के तौर पर दी गई है.

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 RouteTravelMode पर लागू होता है.

avoid_highways

bool

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

avoid_ferries

bool

'सही है' के तौर पर सेट होने पर, यह फ़ेरी वाले रास्तों को ഒഴിവാता है. साथ ही, फ़ेरी वाले रास्तों के बजाय उन रास्तों को प्राथमिकता देता है जिनमें फ़ेरी शामिल नहीं होती हैं. यह सिर्फ़ DRIVE औरTWO_WHEELER RouteTravelMode पर लागू होता है.

avoid_indoor

bool

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

vehicle_info

VehicleInfo

इससे वाहन की जानकारी मिलती है.

toll_passes[]

TollPass

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

avoid_tunnels

bool

ज़रूरी नहीं. 'सही है' के तौर पर सेट होने पर, यह उन सुरंगों से बचता है जहां ऐसा करना सही है. साथ ही, उन रास्तों को प्राथमिकता देता है जिनमें सुरंगें नहीं हैं. यह सिर्फ़ DRIVE और TWO_WHEELER RouteTravelMode पर लागू होता है. RoutingPreference को TRAFFIC_AWARE_OPTIMAL पर सेट किया जाना चाहिए. इस फ़ील्ड का इस्तेमाल ComputeRouteMatrix में नहीं किया जा सकता.

RouteTravelAdvisory

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

फ़ील्ड
toll_info

TollInfo

इस कुकी में, रास्ते पर लगने वाले टोल के बारे में जानकारी होती है. इस फ़ील्ड में जानकारी सिर्फ़ तब भरी जाती है, जब रास्ते में टोल लगने की संभावना हो और अनुरोध के ComputeRoutesRequest.extra_computations में TOLLS शामिल हो. अगर यह फ़ील्ड सेट है, लेकिन estimatedPrice सब-फ़ील्ड में वैल्यू नहीं डाली गई है, तो इसका मतलब है कि रास्ते में टोल हैं, लेकिन अनुमानित कीमत की जानकारी नहीं है. अगर toll_info सेट नहीं है, तो इसका मतलब है कि रूट पर कोई टोल नहीं लगेगा.

speed_reading_intervals[]

SpeedReadingInterval

ट्रैफ़िक की सघनता दिखाने वाले स्पीड रीडिंग इंटरवल. यह फ़ील्ड सिर्फ़ उन अनुरोधों के लिए भरा जाता है जिनमें अनुरोध की वैल्यू TRAFFIC_AWARE या TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference होती है. साथ ही, TRAFFIC_ON_POLYLINE को ComputeRoutesRequest.extra_computations में शामिल किया जाता है. ये इंटरवल, रूट की पूरी पॉलीलाइन को बिना ओवरलैप किए कवर करते हैं. किसी अंतराल का शुरुआती पॉइंट, उससे पहले वाले अंतराल के आखिरी पॉइंट के बराबर होता है.

उदाहरण:

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

int64

ईंधन की खपत का अनुमान, माइक्रोलिटर में. इस फ़ील्ड में जानकारी सिर्फ़ तब भरी जाती है, जब अनुरोध के ComputeRoutesRequest.extra_computations में FUEL_CONSUMPTION शामिल हो.

route_restrictions_partially_ignored

bool

ऐसा हो सकता है कि दिखाए गए रास्ते पर कुछ पाबंदियां हों. ये पाबंदियां, यात्रा के अनुरोध किए गए तरीके या रास्ते में बदलाव करने वाले टूल के हिसाब से सही न हों.

transit_fare

Money

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

RouteTravelMode

यात्रा के मोड के बारे में बताने के लिए इस्तेमाल की गई वैल्यू का सेट. ध्यान दें: WALK, BICYCLE, और TWO_WHEELER रास्ते बीटा वर्शन में हैं. इसलिए, हो सकता है कि इनमें कभी-कभी पैदल चलने के लिए साफ़ रास्ते, पैदल चलने के रास्ते या साइकल चलाने के रास्ते न दिखें. आपको पैदल चलने, साइकल चलाने, और दो पहियों वाले वाहनों के सभी रास्तों के लिए, उपयोगकर्ता को यह चेतावनी दिखानी होगी. ये रास्ते आपके ऐप्लिकेशन में दिखते हैं.

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

RoutingPreference

वैल्यू का एक ऐसा सेट जो रास्ते का हिसाब लगाते समय ध्यान में रखे जाने वाले फ़ैक्टर तय करता है.

Enums
ROUTING_PREFERENCE_UNSPECIFIED रूटिंग की कोई प्राथमिकता नहीं दी गई है. डिफ़ॉल्ट रूप से TRAFFIC_UNAWARE पर सेट होता है.
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

पॉलीलाइन में इस इंटरवल का शुरुआती इंडेक्स.

end_polyline_point_index

int32

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

यूनियन फ़ील्ड speed_type. इस इंटरवल में स्पीड का टाइप. speed_type इनमें से सिर्फ़ एक हो सकता है:
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 इंडोनेशिया. टोल का पेमेंट करने के लिए, कई बैंकों से मिला ई-कार्ड. बैंकों से मिलने वाले सभी ई-कार्ड के लिए एक ही शुल्क लिया जाता है. इसलिए, सिर्फ़ एक enum वैल्यू की ज़रूरत होती है. उदाहरण के लिए - 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 AL, अमेरिका.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS अलास्का, अमेरिका.
US_CA_FASTRAK CA, अमेरिका.
US_CA_FASTRAK_CAV_STICKER इससे पता चलता है कि ड्राइवर के पास DMV से जारी किए गए क्लीन एयर व्हीकल (सीएवी) स्टिकर के अलावा, कोई FasTrak पास है. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL कोलोराडो, अमेरिका.
US_CO_GO_PASS कोलोराडो, अमेरिका.
US_DE_EZPASSDE DE, USA.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS फ़्लोरिडा, अमेरिका.
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 फ़्लोरिडा, अमेरिका.
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 LA, USA.
US_LA_TOLL_TAG LA, USA.
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD एमडी, अमेरिका.
US_ME_EZPASSME ME, USA.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD एमआई, अमेरिका.
US_MI_BCPASS एमआई, अमेरिका.
US_MI_BREAKAWAY एमआई, अमेरिका.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG एमआई, अमेरिका.
US_MI_IQ_PROX_CARD

एमआई, अमेरिका. इस पास टाइप के अब मौजूद न होने की वजह से, इसे बंद कर दिया गया है.

US_MI_IQ_TAG एमआई, अमेरिका.
US_MI_MACKINAC_BRIDGE_MAC_PASS एमआई, अमेरिका.
US_MI_NEXPRESS_TOLL एमआई, अमेरिका.
US_MN_EZPASSMN MN, अमेरिका.
US_NC_EZPASSNC NC, अमेरिका.
US_NC_PEACH_PASS NC, अमेरिका.
US_NC_QUICK_PASS NC, अमेरिका.
US_NH_EZPASSNH NH, अमेरिका.
US_NJ_DOWNBEACH_EXPRESS_PASS न्यू जर्सी, अमेरिका.
US_NJ_EZPASSNJ न्यू जर्सी, अमेरिका.
US_NY_EXPRESSPASS न्यूयॉर्क, अमेरिका.
US_NY_EZPASSNY न्यूयॉर्क, अमेरिका.
US_OH_EZPASSOH ओहायो, अमेरिका.
US_PA_EZPASSPA PA, USA.
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 VA, USA.
US_WA_BREEZEBY WA, USA.
US_WA_GOOD_TO_GO WA, USA.
US_WV_EZPASSWV वेस्ट वर्जीनिया, अमेरिका.
US_WV_MEMORIAL_BRIDGE_TICKETS वेस्ट वर्जीनिया, अमेरिका.
US_WV_MOV_PASS वेस्ट वर्जीनिया, अमेरिका
US_WV_NEWELL_TOLL_BRIDGE_TICKET वेस्ट वर्जीनिया, अमेरिका.

TrafficModel

इस फ़ील्ड में, ट्रैफ़िक की स्थितियों में यात्रा में लगने वाले समय का हिसाब लगाने के लिए, नीचे दिए गए इनम में से किसी एक अनुमान के बारे में बताया जाता है. चुने गए enum के आधार पर, TrafficModel रिस्पॉन्स का duration फ़ील्ड अलग-अलग होगा. इस वैल्यू में, ट्रैफ़िक के हिसाब से गंतव्य तक पहुंचने का अनुमानित समय शामिल होता है. यह समय, पुराने डेटा के आधार पर तय किया जाता है. TrafficModel सिर्फ़ उन अनुरोधों के लिए उपलब्ध है जिनमें RoutingPreference को TRAFFIC_AWARE_OPTIMAL और RouteTravelMode को DRIVE पर सेट किया गया है.

Enums
TRAFFIC_MODEL_UNSPECIFIED इस्तेमाल नहीं किया गया. अगर यह तय किया जाता है, तो डिफ़ॉल्ट रूप से BEST_GUESS पर सेट हो जाएगा.
BEST_GUESS इससे पता चलता है कि जवाब में दिया गया duration, यात्रा में लगने वाले समय का सबसे सटीक अनुमान होना चाहिए. इसके लिए, ट्रैफ़िक की पुरानी स्थितियों और लाइव ट्रैफ़िक, दोनों के बारे में उपलब्ध जानकारी का इस्तेमाल किया जाना चाहिए. लाइव ट्रैफ़िक की जानकारी, मौजूदा समयdeparture_time के हिसाब से ज़्यादा अहम होती है.
PESSIMISTIC इससे पता चलता है कि यात्रा में लगने वाला समय, ज़्यादातर दिनों में यात्रा में लगने वाले असल समय से ज़्यादा होना चाहिए. हालांकि, कभी-कभी ट्रैफ़िक का हाल बहुत खराब होने पर, यात्रा में लगने वाला समय इस वैल्यू से ज़्यादा हो सकता है.
OPTIMISTIC इससे पता चलता है कि यात्रा में लगने वाला समय, ज़्यादातर दिनों में यात्रा में लगने वाले असल समय से कम होना चाहिए. हालांकि, कभी-कभी ट्रैफ़िक का हाल अच्छा होने पर, यात्रा में लगने वाला समय इस वैल्यू से कम हो सकता है.

TransitAgency

सार्वजनिक परिवहन एजेंसी, जो सार्वजनिक परिवहन लाइन को मैनेज करती है.

फ़ील्ड
name

string

इस सार्वजनिक परिवहन एजेंसी का नाम.

phone_number

string

ट्रांज़िट एजेंसी का स्थानीय भाषा के हिसाब से फ़ॉर्मैट किया गया फ़ोन नंबर.

uri

string

ट्रांसपोर्ट एजेंसी का यूआरआई.

TransitLine

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

फ़ील्ड
agencies[]

TransitAgency

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

name

string

इस बस, मेट्रो वगैरह का रूट मैप का पूरा नाम. उदाहरण के लिए, "8 एवेन्यू लोकल".

uri

string

सार्वजनिक परिवहन एजेंसी की ओर से दिया गया, इस ट्रांज़िट लाइन का यूआरआई.

color

string

इस लाइन के लिए, साइनेज में आम तौर पर इस्तेमाल किया जाने वाला रंग. इसे हेक्साडेसिमल में दिखाया जाता है.

icon_uri

string

इस लाइन से जुड़े आइकॉन का यूआरआई.

name_short

string

बस, मेट्रो वगैरह की इस लाइन का छोटा नाम. यह नाम आम तौर पर लाइन नंबर होता है, जैसे कि "M7" या "355".

text_color

string

इस लाइन के साइनेज पर टेक्स्ट के लिए आम तौर पर इस्तेमाल किया जाने वाला रंग. इसे हेक्साडेसिमल में दिखाया जाता है.

vehicle

TransitVehicle

इस बस, मेट्रो वगैरह के रूट मैप पर चलने वाले वाहन का टाइप.

TransitPreferences

TRANSIT पर आधारित रास्तों के लिए प्राथमिकताएं. इनसे तय होता है कि कौनसे रास्ते दिखाए जाएं.

फ़ील्ड
allowed_travel_modes[]

TransitTravelMode

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

routing_preference

TransitRoutingPreference

रास्ता चुनने की प्राथमिकता. इसे तय करने पर, TRANSIT से मिले रास्ते पर इसका असर पड़ता है.

TransitRoutingPreference

सार्वजनिक परिवहन के रूट के लिए, रूटिंग की प्राथमिकताएं तय करता है.

Enums
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED कोई प्राथमिकता नहीं दी गई है.
LESS_WALKING इससे पता चलता है कि कैलकुलेट किए गए रास्ते में पैदल चलने की दूरी कम होनी चाहिए.
FEWER_TRANSFERS इससे पता चलता है कि कैलकुलेट किए गए रास्ते में, कम से कम वाहन बदलने चाहिए.

TransitTravelMode

ट्रांज़िट का तरीका बताने के लिए इस्तेमाल की गई वैल्यू का सेट.

Enums
TRANSIT_TRAVEL_MODE_UNSPECIFIED सार्वजनिक परिवहन के मोड की जानकारी नहीं दी गई है.
BUS बस से यात्रा करें.
SUBWAY मेट्रो से यात्रा करें.
TRAIN ट्रेन से यात्रा करें.
LIGHT_RAIL लाइट रेल या ट्राम से यात्रा करें.
RAIL ट्रेन से यात्रा करें. यह SUBWAY, TRAIN, और LIGHT_RAIL के कॉम्बिनेशन के बराबर है.

TransitStop

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

फ़ील्ड
name

string

बस, मेट्रो वगैरह के स्टॉप का नाम.

location

Location

स्टॉप की जगह की जानकारी, अक्षांश/देशांतर के निर्देशांकों में दी जाती है.

TransitVehicle

सार्वजनिक परिवहन के रास्तों में इस्तेमाल किए गए वाहन के बारे में जानकारी.

फ़ील्ड
name

LocalizedText

इस वाहन का नाम, कैपिटल लेटर में.

type

TransitVehicleType

इस्तेमाल किए गए वाहन का टाइप.

icon_uri

string

इस वाहन के टाइप से जुड़े आइकॉन का यूआरआई.

local_icon_uri

string

यह वाहन के टाइप से जुड़े आइकॉन का यूआरआई है. यह स्थानीय परिवहन के साइनेज पर आधारित होता है.

TransitVehicleType

सार्वजनिक परिवहन के रास्तों के लिए वाहनों का टाइप.

Enums
TRANSIT_VEHICLE_TYPE_UNSPECIFIED इस्तेमाल नहीं किया गया.
BUS बस.
CABLE_CAR यह एक ऐसा वाहन होता है जो केबल पर चलता है. आम तौर पर, यह ज़मीन पर चलता है. एरियल केबल कार, GONDOLA_LIFT टाइप की हो सकती हैं.
COMMUTER_TRAIN कम्यूटर रेल.
FERRY फ़ेरी.
FUNICULAR एक ऐसा वाहन जिसे केबल की मदद से, खड़ी चढ़ाई पर खींचा जाता है. आम तौर पर, फ़्यूनिकुलर में दो कारें होती हैं. इनमें से हर कार, दूसरी कार के लिए काउंटरवेट का काम करती है.
GONDOLA_LIFT एरियल केबल कार.
HEAVY_RAIL हैवी रेल.
HIGH_SPEED_TRAIN हाई स्पीड ट्रेन.
INTERCITY_BUS एक शहर से दूसरे शहर जाने वाली बस.
LONG_DISTANCE_TRAIN लंबी दूरी की ट्रेन.
METRO_RAIL लाइट रेल ट्रांज़िट.
MONORAIL मोनोरेल.
OTHER अन्य सभी वाहन.
RAIL ट्रेन.
SHARE_TAXI शेयर टैक्सी, बस की तरह होती है. यह अपने रास्ते में कहीं भी यात्रियों को उतार और चढ़ा सकती है.
SUBWAY भूमिगत लाइट रेल.
TRAM ज़मीन के ऊपर बनी लाइट रेल.
TROLLEYBUS ट्रॉलीबस.

इकाइयां

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

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

VehicleEmissionType

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

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

VehicleInfo

इसमें वाहन की जानकारी होती है. जैसे, वाहन से होने वाले उत्सर्जन का टाइप.

फ़ील्ड
emission_type

VehicleEmissionType

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

total_height_mm

int64

वाहन की ऊंचाई. इसमें अटैच किए गए किसी भी ट्रेलर की ऊंचाई भी शामिल है. ट्रकिंग या ट्रेलिंग के लिए इसे सेट करना ज़रूरी है, ताकि यह ट्रिगर हो सके. जब RouteTravelMode DRIVE पर सेट होता है, तब ComputeRouteMatrix में इस फ़ील्ड का इस्तेमाल नहीं किया जा सकता.

total_length_mm

int64

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

total_width_mm

int64

वाहन की चौड़ाई, जिसमें अटैच किए गए किसी भी ट्रेलर की चौड़ाई शामिल है. ट्रकिंग या ट्रेलिंग के लिए इसे सेट करना ज़रूरी है, ताकि यह ट्रिगर हो सके. जब RouteTravelMode DRIVE पर सेट होता है, तब ComputeRouteMatrix में इस फ़ील्ड का इस्तेमाल नहीं किया जा सकता.

total_weight_kg

int64

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

trailer_info[]

TrailerInfo

इसमें हर ट्रेलर के लिए एक एंट्री होती है. अगर ट्रेलर की जानकारी दी गई है, तो RoutingPreference को TRAFFIC_AWARE_OPTIMAL पर सेट करना होगा. जब RouteTravelMode DRIVE पर सेट होता है, तब ComputeRouteMatrix में इस फ़ील्ड का इस्तेमाल नहीं किया जा सकता.

hazardous_goods_types[]

HazardousGoodsType

अगर वाहन में खतरनाक सामान ले जाया जा रहा है, तो उसकी सूची.

HazardousGoodsType

अलग-अलग तरह के खतरनाक सामान.

Enums
HAZARDOUS_GOODS_TYPE_UNSPECIFIED खतरनाक सामान के टाइप के बारे में नहीं बताया गया है.
EXPLOSIVES विस्फोटक सामान.
GASES गैसें.
FLAMMABLE ज्वलनशील सामान.
COMBUSTIBLE ज्वलनशील सामान.
ORGANIC ऑर्गैनिक प्रॉडक्ट उपलब्ध हैं.
POISON ज़हरीले सामान.
RADIOACTIVE रेडियोऐक्टिव सामान.
CORROSIVE जंग लगने वाला सामान.
ASPIRATION_HAZARD खतरनाक सामान को निगलने से होने वाला नुकसान.
ENVIRONMENTAL_HAZARD पर्यावरण के लिए खतरनाक सामान.
OTHER अन्य तरह का सामान.

TrailerInfo

वाहन से जुड़े अलग-अलग ट्रेलर के बारे में जानकारी. ट्रकिंग के लिए, सभी ट्रेलर की लंबाई की जानकारी देनी होगी. अन्य एट्रिब्यूट की वैल्यू देना ज़रूरी नहीं है. कुल एट्रिब्यूट में, किसी भी ट्रेलर के एट्रिब्यूट शामिल होने चाहिए. उदाहरण के लिए, total_height_mm हमेशा trailer_info.height_mm से ज़्यादा या इसके बराबर होना चाहिए.

फ़ील्ड
height_mm

int64

ट्रेलर की ऊंचाई.

length_mm

int64

ट्रेलर की लंबाई.

width_mm

int64

ट्रेलर की चौड़ाई.

weight_kg

int64

ट्रेलर का वज़न. इस संदर्भ में वज़न का मतलब, असल वज़न से है, न कि वज़न की रेटिंग से.

वेपॉइंट

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

फ़ील्ड
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 RouteTravelMode के लिए काम करता है.

यूनियन फ़ील्ड location_type. किसी जगह की जानकारी दिखाने के अलग-अलग तरीके. location_type इनमें से सिर्फ़ एक हो सकता है:
location

Location

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

place_id

string

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

address

string

ऐसा पता जिसे कोई भी व्यक्ति आसानी से पढ़ सके या प्लस कोड. ज़्यादा जानकारी के लिए, https://plus.codes पर जाएं.

navigation_point_token

string

यह एक टोकन है, जो NavigationPoint की पहचान करता है. इसे Geocoding API के SearchDestinations तरीके से हासिल किया जाता है.