Method: computeRoutes

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

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

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

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

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

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

एचटीटीपी अनुरोध

POST https://routes.googleapis.com/directions/v2:computeRoutes

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
फ़ील्ड
origin

object (Waypoint)

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

destination

object (Waypoint)

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

intermediates[]

object (Waypoint)

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

travelMode

enum (RouteTravelMode)

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

routingPreference

enum (RoutingPreference)

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

polylineQuality

enum (PolylineQuality)

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

polylineEncoding

enum (PolylineEncoding)

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

departureTime

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

arrivalTime

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

computeAlternativeRoutes

boolean

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

routeModifiers

object (RouteModifiers)

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

languageCode

string

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

regionCode

string

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

units

enum (Units)

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

optimizeWaypointOrder

boolean

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

requestedReferenceRoutes[]

enum (ReferenceRoute)

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

extraComputations[]

enum (ExtraComputation)

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

trafficModel

enum (TrafficModel)

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

transitPreferences

object (TransitPreferences)

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

जवाब का मुख्य भाग

जवाब देने वाले मैसेज को v2.computeRoutes पर दे सकता है.

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

JSON के काेड में दिखाना
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
फ़ील्ड
routes[]

object (Route)

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

fallbackInfo

object (FallbackInfo)

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

geocodingResults

object (GeocodingResults)

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

PolylineQuality

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

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

PolylineEncoding

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

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

ReferenceRoute

ComputeRoutesRequest पर काम करने वाला रेफ़रंस रूट.

Enums
REFERENCE_ROUTE_UNSPECIFIED इस्तेमाल नहीं किया गया. इस वैल्यू वाले अनुरोध पूरे नहीं हो पाते.
FUEL_EFFICIENT ईंधन की बचत वाला रास्ता. इस वैल्यू के साथ लेबल किए गए रास्तों को, ईंधन की खपत जैसे पैरामीटर के हिसाब से ऑप्टिमाइज़ किया जाता है.

ExtraComputation

अनुरोध पूरा करने के दौरान, की जाने वाली अतिरिक्त कंप्यूटेशन की जानकारी.

Enums
EXTRA_COMPUTATION_UNSPECIFIED इस्तेमाल नहीं किया गया. इस वैल्यू वाले अनुरोध पूरे नहीं हो पाएंगे.
TOLLS रास्तों के लिए टोल की जानकारी.
FUEL_CONSUMPTION रास्तों में ईंधन की अनुमानित खपत.
TRAFFIC_ON_POLYLINE रास्तों के लिए ट्रैफ़िक जागरूक पॉलीलाइन.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions को फ़ॉर्मैट किए गए एचटीएमएल टेक्स्ट स्ट्रिंग के तौर पर दिखाया जाता है. इस कॉन्टेंट को उसी तरह पढ़ा जाना चाहिए. यह कॉन्टेंट सिर्फ़ दिखाने के लिए है. इसे प्रोग्राम के हिसाब से पार्स न करें.

रास्ता

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

JSON के काेड में दिखाना
{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string
}
फ़ील्ड
routeLabels[]

enum (RouteLabel)

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

legs[]

object (RouteLeg)

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

distanceMeters

integer

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

duration

string (Duration format)

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

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".

staticDuration

string (Duration format)

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

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".

polyline

object (Polyline)

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

description

string

रास्ते की जानकारी.

warnings[]

string

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

viewport

object (Viewport)

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

travelAdvisory

object (RouteTravelAdvisory)

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

optimizedIntermediateWaypointIndex[]

integer

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

localizedValues

object (RouteLocalizedValues)

Route की प्रॉपर्टी को टेक्स्ट में दिखाया गया है.

routeToken

string

एक वेब-सुरक्षित, base64-एन्कोडेड मार्ग टोकन, जिसे नेविगेशन SDK को पास किया जा सकता है, जो नेविगेशन SDK को नेविगेशन के दौरान मार्ग का पुनर्निर्माण करने की अनुमति देता है और मार्ग बदलने की स्थिति में, v2.computeRoutes को कॉल करके रूट बनाते समय आपने मूल उद्देश्य का सम्मान किया था. ग्राहकों को इस टोकन को ओपेक ब्लॉब के रूप में देखना चाहिए. सभी अनुरोधों में इसके मान की तुलना न करें -- यह टोकन बदल सकता है भले ही ठीक उसी मार्ग को लौटाया गया हो. ध्यान दें: Route.route_token सिर्फ़ उन अनुरोधों के लिए उपलब्ध है जिनमें ComputeRoutesRequest.routing_preference को TRAFFIC_AWARE या TRAFFIC_AWARE_OPTIMAL पर सेट किया गया है. Route.route_token के ज़रिए वेपॉइंट वाले अनुरोध स्वीकार नहीं किए जा सकते.

RouteLabel

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

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

RouteLeg

इसमें via वेपॉइंट के बीच का एक सेगमेंट शामिल है.

JSON के काेड में दिखाना
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
फ़ील्ड
distanceMeters

integer

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

duration

string (Duration format)

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

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".

staticDuration

string (Duration format)

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

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".

polyline

object (Polyline)

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

startLocation

object (Location)

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

endLocation

object (Location)

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

steps[]

object (RouteLegStep)

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

travelAdvisory

object (RouteLegTravelAdvisory)

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

localizedValues

object (RouteLegLocalizedValues)

RouteLeg की प्रॉपर्टी को टेक्स्ट में दिखाया गया है.

stepsOverview

object (StepsOverview)

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

पॉलीलाइन

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

JSON के काेड में दिखाना
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}
फ़ील्ड
यूनियन फ़ील्ड polyline_type. पॉलीलाइन के टाइप को इनकैप्सुलेट करता है. डिफ़ॉल्ट तौर पर, encoded_polyline काम करने लगता है. polyline_type इनमें से सिर्फ़ एक हो सकता है:
encodedPolyline

string

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

geoJsonLinestring

object (Struct format)

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

RouteLegStep

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

JSON के काेड में दिखाना
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
फ़ील्ड
distanceMeters

integer

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

staticDuration

string (Duration format)

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

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".

polyline

object (Polyline)

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

startLocation

object (Location)

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

endLocation

object (Location)

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

navigationInstruction

object (NavigationInstruction)

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

travelAdvisory

object (RouteLegStepTravelAdvisory)

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

localizedValues

object (RouteLegStepLocalizedValues)

RouteLegStep की प्रॉपर्टी को टेक्स्ट में दिखाया गया है.

transitDetails

object (RouteLegStepTransitDetails)

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

travelMode

enum (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 इसका इस्तेमाल सड़क के नाम में बदलाव को दिखाने के लिए किया जाता है.

RouteLegStepTravelAdvisory

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

JSON के काेड में दिखाना
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
फ़ील्ड
speedReadingIntervals[]

object (SpeedReadingInterval)

ध्यान दें: यह फ़ील्ड अभी अपने-आप नहीं भरा गया है.

RouteLegStepLocalizedValues

कुछ प्रॉपर्टी को टेक्स्ट में दिखाना.

JSON के काेड में दिखाना
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
फ़ील्ड
distance

object (LocalizedText)

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

staticDuration

object (LocalizedText)

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

RouteLegStepTransitDetails

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

JSON के काेड में दिखाना
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
फ़ील्ड
stopDetails

object (TransitStopDetails)

इस चरण में आने और जाने के स्टॉप की जानकारी.

localizedValues

object (TransitDetailsLocalizedValues)

RouteLegStepTransitDetails की प्रॉपर्टी को टेक्स्ट में दिखाया गया है.

headsign

string

वाहन पर या जाने के स्टॉप पर इस लाइन पर यात्रा की दिशा बताता है. अक्सर टर्मिनस स्टेशन की दिशा होती है.

headway

string (Duration format)

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

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".

transitLine

object (TransitLine)

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

stopCount

integer

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

tripShortText

string

शेड्यूल और साइन बोर्ड में दिखने वाला टेक्स्ट, जिससे यात्रियों के लिए बस, मेट्रो वगैरह की यात्रा के बारे में पता चलता है. टेक्स्ट को सेवा के दिन में यात्रा की खास तौर पर पहचान करनी चाहिए. उदाहरण के लिए, "538" ट्रेन की tripShortText है.

TransitStopDetails

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

JSON के काेड में दिखाना
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
फ़ील्ड
arrivalStop

object (TransitStop)

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

arrivalTime

string (Timestamp format)

कदम के पहुंचने का अनुमानित समय.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

departureStop

object (TransitStop)

कदम के लिए रवाना होने वाले स्टॉप के बारे में जानकारी.

departureTime

string (Timestamp format)

कदम के लिए निकलने का अनुमानित समय.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

TransitStop

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

JSON के काेड में दिखाना
{
  "name": string,
  "location": {
    object (Location)
  }
}
फ़ील्ड
name

string

ट्रांज़िट स्टॉप का नाम.

location

object (Location)

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

TransitDetailsLocalizedValues

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

JSON के काेड में दिखाना
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
फ़ील्ड
arrivalTime

object (LocalizedTime)

फ़ॉर्मैट किए गए टेक्स्ट में समय को संबंधित टाइम ज़ोन के साथ दिखाएं.

departureTime

object (LocalizedTime)

फ़ॉर्मैट किए गए टेक्स्ट में समय को संबंधित टाइम ज़ोन के साथ दिखाएं.

LocalizedTime

समय का स्थानीय भाषा में लिखा हुआ विवरण.

JSON के काेड में दिखाना
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
फ़ील्ड
time

object (LocalizedText)

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

timeZone

string

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

TransitLine

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

JSON के काेड में दिखाना
{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
फ़ील्ड
agencies[]

object (TransitAgency)

इस ट्रांज़िट लाइन को चलाने वाली ट्रांसपोर्ट एजेंसी या एजेंसियां.

name

string

इस ट्रांज़िट लाइन का पूरा नाम, जैसे कि "8 Avenue Local".

uri

string

इस ट्रांज़िट लाइन का यूआरआई, जैसा कि ट्रांसपोर्ट एजेंसी ने उपलब्ध कराया है.

color

string

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

iconUri

string

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

nameShort

string

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

textColor

string

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

vehicle

object (TransitVehicle)

इस ट्रांज़िट लाइन पर चलने वाले वाहन का टाइप.

TransitAgency

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

JSON के काेड में दिखाना
{
  "name": string,
  "phoneNumber": string,
  "uri": string
}
फ़ील्ड
name

string

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

phoneNumber

string

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

uri

string

सार्वजनिक परिवहन एजेंसी का यूआरआई.

TransitVehicle

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

JSON के काेड में दिखाना
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
फ़ील्ड
name

object (LocalizedText)

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

type

enum (TransitVehicleType)

इस्तेमाल किया गया वाहन किस तरह का है.

iconUri

string

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

localIconUri

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 ट्रॉली बस.

RouteLegTravelAdvisory

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

JSON के काेड में दिखाना
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
फ़ील्ड
tollInfo

object (TollInfo)

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

speedReadingIntervals[]

object (SpeedReadingInterval)

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

उदाहरण:

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

RouteLegLocalizedValues

कुछ प्रॉपर्टी को टेक्स्ट में दिखाना.

JSON के काेड में दिखाना
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
फ़ील्ड
distance

object (LocalizedText)

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

duration

object (LocalizedText)

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

staticDuration

object (LocalizedText)

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

StepsOverview

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

JSON के काेड में दिखाना
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
फ़ील्ड
multiModalSegments[]

object (MultiModalSegment)

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

MultiModalSegment

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

JSON के काेड में दिखाना
{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
फ़ील्ड
navigationInstruction

object (NavigationInstruction)

मल्टी-मॉडल सेगमेंट के लिए नेविगेशन से जुड़े निर्देश.

travelMode

enum (RouteTravelMode)

मल्टी-मॉडल सेगमेंट का यात्रा मोड.

stepStartIndex

integer

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

stepEndIndex

integer

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

व्यूपोर्ट

अक्षांश-देशांतर व्यूपोर्ट, जिसे low और high पॉइंट के दो तिरछे तरीके से दिखाया गया है. व्यूपोर्ट को एक बंद क्षेत्र माना जाता है, यानी कि इसमें इसकी सीमा शामिल होती है. अक्षांश की सीमाएं -90 से 90 डिग्री के बीच और देशांतर की सीमाएं -180 से 180 डिग्री के बीच होनी चाहिए. कई मामलों में ये शामिल हैं:

  • अगर low = high है, तो व्यूपोर्ट में वह सिंगल पॉइंट होता है.

  • अगर low.longitude > high.longitude में, देशांतर की रेंज उलटी हो जाती है (व्यूपोर्ट में 180 डिग्री देशांतर लाइन है).

  • अगर low.longitude = -180 डिग्री और high.longitude = 180 डिग्री है, तो व्यूपोर्ट में सभी देशांतर शामिल होते हैं.

  • अगर low.longitude = 180 डिग्री और high.longitude = -180 डिग्री है, तो देशांतर रेंज खाली होती है.

  • अगर low.latitude > high.latitude, अक्षांश की रेंज खाली है.

low और high, दोनों में जानकारी भरी जानी चाहिए. साथ ही, दिखाया गया बॉक्स खाली नहीं होना चाहिए (जैसा कि ऊपर दी गई परिभाषाओं में बताया गया है). व्यूपोर्ट को खाली छोड़ने पर गड़बड़ी हो सकती है.

उदाहरण के लिए, यह व्यूपोर्ट न्यूयॉर्क शहर को पूरी तरह से घेरता है:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON के काेड में दिखाना
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
फ़ील्ड
low

object (LatLng)

ज़रूरी है. व्यूपोर्ट का निचला पॉइंट.

high

object (LatLng)

ज़रूरी है. व्यूपोर्ट का सबसे ऊपरी पॉइंट.

RouteLocalizedValues

कुछ प्रॉपर्टी को टेक्स्ट में दिखाना.

JSON के काेड में दिखाना
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
फ़ील्ड
distance

object (LocalizedText)

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

duration

object (LocalizedText)

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

staticDuration

object (LocalizedText)

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

transitFare

object (LocalizedText)

बस, मेट्रो वगैरह का किराया, टेक्स्ट फ़ॉर्मैट में दिखाया जाता है.

GeocodingResults

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

JSON के काेड में दिखाना
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
फ़ील्ड
origin

object (GeocodedWaypoint)

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

destination

object (GeocodedWaypoint)

डेस्टिनेशन जियोकोड किया गया वेपॉइंट.

intermediates[]

object (GeocodedWaypoint)

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

GeocodedWaypoint

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

JSON के काेड में दिखाना
{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
फ़ील्ड
geocoderStatus

object (Status)

जियोकोडिंग कार्रवाई के नतीजे वाले स्थिति कोड को दिखाता है.

type[]

string

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

partialMatch

boolean

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

placeId

string

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

intermediateWaypointRequestIndex

integer

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