रास्ते के जवाब की समीक्षा करें

जब Routes API किसी रास्ते का हिसाब लगाता है, तो वह इनपुट के तौर पर आपके दिए गए वे पॉइंट और कॉन्फ़िगरेशन पैरामीटर लेता है. इसके बाद, एपीआई जवाब दिखाता है जिसमें डिफ़ॉल्ट रास्ता और एक या एक से ज़्यादा वैकल्पिक रास्ते होते हैं.

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

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

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

फ़ील्ड मास्क के बारे में जानकारी

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

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

ज़्यादा जानकारी के लिए, चुनें कि कौनसी जानकारी दी जाए.

कॉपीराइट दिखाने के बारे में जानकारी

अपने उपयोगकर्ताओं को नतीजे दिखाते समय आपको यह कॉपीराइट स्टेटमेंट ज़रूर शामिल करना होगा:

Powered by Google, ©YEAR Google

उदाहरण के लिए:

Powered by Google, ©2023 Google

रास्तों, पैरों, और कदमों के बारे में जानकारी

रूट एपीआई से मिले जवाब को देखने से पहले, आपको को रूट बनाने वाले कॉम्पोनेंट की समझ होनी चाहिए:

आपके जवाब में इन रूट के हर कॉम्पोनेंट के बारे में जानकारी हो सकती है:

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

• लेग: किसी रूट में एक वेपॉइंट से अगले वेपॉइंट तक का रास्ता रूट हर पैर में एक या उससे ज़्यादा अलग-अलग कदम होते हैं.

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

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

• चरण: किसी रास्ते पर चलने के लिए एक निर्देश. कोई कदम किसी रूट की ऐटॉमिक यूनिट. उदाहरण के लिए, किसी चरण में "Main Street पर बाईं ओर मुड़ें'' लिखा हो सकता है.

जवाब में क्या जानकारी मौजूद है

एपीआई रिस्पॉन्स को दिखाने वाले JSON ऑब्जेक्ट में ये टॉप-लेवल प्रॉपर्टी शामिल होती हैं:

• routes, एलिमेंट के टाइप का कलेक्शन रास्ता. routes कलेक्शन में, एपीआई से मिले हर रूट के लिए एक एलिमेंट होता है. इस अरे में ज़्यादा से ज़्यादा पांच एलिमेंट शामिल हो सकते हैं: डिफ़ॉल्ट रूट, और तीन वैकल्पिक रास्ते शामिल किए जा सकते हैं.

• geocodingResults, GeocodingResults टाइप के एलिमेंट का कलेक्शन. अनुरोध में बताई गई हर जगह (ऑरिजिन, डेस्टिनेशन या इंटरमीडिएट वॉयपॉइंट) के लिए, एपीआई प्लेस आईडी लुकअप करता है. जगह की जानकारी, पते की स्ट्रिंग या प्लस कोड के तौर पर दी जाती है. इस कलेक्शन के हर एलिमेंट में किसी जगह का आईडी. अनुरोध में इन जगहों की जानकारी दी गई है जगह का आईडी या अक्षांश/देशांतर निर्देशांक शामिल नहीं होते. अगर आपने जगह के आईडी या अक्षांश और देशांतर का इस्तेमाल करके सभी जगहों की जानकारी दे दी है निर्देशांक नहीं हैं, तो यह श्रेणी उपलब्ध नहीं है.

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

जवाब का फ़ॉर्मैट यह है:

{
  // The routes array.
  "routes": [
    {
      object (Route)
    }
  ],
  // The place ID lookup results.
  "geocodingResults": [
    {
      object (GeocodedWaypoint)
    }
  ],
  // The fallback property.
  "fallbackInfo": {
    object (FallbackInfo)
  }
}

रूट अरे को समझें

रिस्पॉन्स में routes अरे शामिल होता है, जहां हर अरे एलिमेंट का टाइप कुछ होता है रास्ता. अरे का हर एलिमेंट, ऑरिजिन से डेस्टिनेशन तक के पूरे रूट को दिखाता है. कॉन्टेंट बनाने एपीआई हमेशा कम से कम एक रूट दिखाता है, जिसे डिफ़ॉल्ट रूट कहा जाता है.

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

कैटगरी में मौजूद हर रूट की पहचान, routeLabels कलेक्शन प्रॉपर्टी की मदद से की जाती है:

legs कलेक्शन में, रास्ते के हर पैर के बारे में जानकारी होती है. शेष distanceMeters, duration, और polyline, जैसी प्रॉपर्टी में रूट के बारे में पूरी जानकारी:

{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "routeLabels": [string],
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  }
  "routeToken": string
}

ड्राइविंग की वर्तमान स्थितियों और अन्य कारकों के कारण डिफ़ॉल्ट रास्ता और तो ईको-फ़्रेंडली रास्ता एक ही हो सकता है. इस मामले में, routeLabels कलेक्शन दोनों लेबल शामिल हैं: DEFAULT_ROUTE और FUEL_EFFICIENT.

{
  "routes": [
    {
      "routeLabels": [
        "DEFAULT_ROUTE",
        "FUEL_EFFICIENT"
      ],
     …
    }
  ]
}

लेग अरे को समझें

जवाब के हर route में एक legs कलेक्शन होता है, जिसमें हर legs अरे होता है तत्व का प्रकार है RouteLeg. सरणी में हर पैर एक वेपॉइंट से अगले वेपॉइंट तक पथ को परिभाषित करता है ट्रैक किया जा सकता है. किसी रास्ते में हमेशा कम से कम एक पैर होता है.

legs प्रॉपर्टी में, steps कलेक्शन में पैर के हर चरण की परिभाषा होती है. बाकी प्रॉपर्टी, जैसे कि distanceMeters, duration, और polyline में पैर के बारे में जानकारी है.

{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  }
}

चरणों की कैटगरी को समझना

जवाब के हर चरण में एक steps कलेक्शन होता है, जिसमें हर steps अरे होता है तत्व का प्रकार है RouteLegStep. चरण में पैर पर मौजूद एक निर्देश से मेल खाता है. किसी लेग में हमेशा कम से कम एक चरण होता है.

steps कलेक्शन के हर एलिमेंट में navigationInstruction शामिल होता है प्रॉपर्टी, प्रकार का NavigationInstruction, इसमें चरण के लिए निर्देश होता है. उदाहरण के लिए:

"navigationInstruction": {
  "maneuver": "TURN_LEFT",
  "instructions": "Turn left toward Frontage Rd"
}

instructions में, इस चरण के बारे में ज़्यादा जानकारी मौजूद हो सकती है. इसके लिए उदाहरण:

"navigationInstruction": {
  "maneuver": "TURN_SLIGHT_LEFT",
  "instructions": "Slight left (signs for I-90 W/Worcester)nParts of this road may be closed at certain times or days"
}

चरण की बाकी प्रॉपर्टी, चरण के बारे में जानकारी देती हैं, जैसे distanceMeters, duration, और polyline के तौर पर:

{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  }
}

चरण वाले निर्देशों की भाषा तय करें

एपीआई, रूट की जानकारी को स्थानीय भाषा में, अगर ज़रूरी हो, तो उपयोगकर्ता के हिसाब से पढ़ी जा सकने वाली स्क्रिप्ट भाषा. पते के सभी कॉम्पोनेंट उसी भाषा में दिखाए जाते हैं.

• इस्तेमाल की जा सकने वाली भाषाओं की सूची में से, रूट की भाषा को साफ़ तौर पर सेट करने के लिए, अनुरोध के languageCode पैरामीटर का इस्तेमाल करें. Google, काम करने वाली भाषाओं की सूची को समय-समय पर अपडेट करता रहता है. इसलिए, हो सकता है कि इस सूची में सभी भाषाएं शामिल न हों.

• अगर कोई नाम बताई गई भाषा में उपलब्ध नहीं है, तो एपीआई सबसे नज़दीकी मिलान.

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

जियोकोडिंग परिणाम अरे को समझें

अनुरोध में शामिल हर जगह के लिए (शुरुआत की जगह, डेस्टिनेशन या इंटरमीडिएट) वेपॉइंट) को किसी पता स्ट्रिंग या प्लस कोड के रूप में दिखाया जाता था, एपीआई, सबसे काम की जगह ढूंढने की कोशिश करता है, जिसकी जानकारी मिलती-जुलती हो आईडी. geocodingResults ऐरे के हर एलिमेंट में placeID फ़ील्ड होता है. इसमें जगह की जानकारी, प्लेस आईडी के तौर पर होती है. साथ ही, type फ़ील्ड में जगह के टाइप की जानकारी होती है, जैसे कि street_address, premise या airport.

geocodingResults कलेक्शन में तीन फ़ील्ड होते हैं:

• origin: अगर इसे किसी पते की स्ट्रिंग या Plus कोड के तौर पर बताया गया था, तो शुरुआत की जगह का आईडी. ऐसा न होने पर, इस फ़ील्ड को जवाब में शामिल नहीं किया जाता.

• destination: अगर इसे पते की स्ट्रिंग या Plus Code के तौर पर बताया गया था, गंतव्य का स्थान आईडी. ऐसा न करने पर, इस फ़ील्ड को रिस्पॉन्स से हटा दिया जाता है.

• intermediates: यह एक कलेक्शन है, जिसमें किसी भी बीच के waypoints का प्लेस आईडी होता है. यह आईडी, पते की स्ट्रिंग या Plus कोड के तौर पर दिया जाता है. अगर आप तय करते हैं कि स्थान आईडी या अक्षांश का इस्तेमाल करके एक मध्यवर्ती वेपॉइंट और देशांतर निर्देशांक, इसे जवाब में शामिल नहीं किया जाता. इसका इस्तेमाल करें पता लगाने के लिए, रिस्पॉन्स में intermediateWaypointRequestIndex प्रॉपर्टी मिली अनुरोध का कौन सा इंटरमीडिएट वेपॉइंट इसमें स्थान आईडी से मेल खाता है जवाब को प्राथमिकता दें.

"geocodingResults": {
    "origin": {
        "geocoderStatus": {},
        "type": [
             enum (Type)
        ],
        "placeId": string
    },
    "destination": {
        "geocoderStatus": {},
        "type": [
            enum (Type)
        ],
        "placeId": string
    },
    "intermediates": [
        {
            "geocoderStatus": {},
            "intermediateWaypointRequestIndex": integer,
            "type": [
                enum (Type)
            ],
            "placeId": string
        },
        {
           "geocoderStatus": {},
           "intermediateWaypointRequestIndex": integer,
            "type": [
                enum (Type)
            ],
            "placeId": string
        }
    ]
}

स्थानीय भाषा में जवाब देने की वैल्यू समझना

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

उदाहरण के लिए, अगर जर्मन (de) और इंपीरियल यूनिट के लिए भाषा कोड दिया जाता है, तो आपको distanceMeters की वैल्यू 49889.7 मिलती है. साथ ही, आपको स्थानीय भाषा में लिखा गया टेक्स्ट भी मिलता है, जिसमें दूरी को जर्मन और इंपीरियल यूनिट में दिखाया जाता है. जैसे, "31 मील."

स्थानीय भाषा के मुताबिक वैल्यू के लिए आपको क्या दिखेगा, इसका एक उदाहरण यहां दिया गया है:

{ "localized_values":
  {
    "distance": { "text": "31,0 Meile/n" },
    "duration": { "text": 38 Minuten}.
    "static_duration": { "text": 36 Minuten}.
  }
}

अगर भाषा या यूनिट सिस्टम की जानकारी नहीं दी जाती है, तो एपीआई भाषा का ही पता लगाता है और यूनिट का इस्तेमाल करें:

• ComputeRoutes तरीका, जगह और दूरी का अनुमान लगाता है ऑरिजिन वेपॉइंट से मिली इकाइयां. इसलिए, अमेरिका में रूटिंग अनुरोध के लिए, एपीआई en-US भाषा और IMPERIAL यूनिट का अनुमान लगाता है.
• ComputeRouteMatrix तरीका डिफ़ॉल्ट रूप से 'en-US' पर सेट होता है भाषा और METRIC इकाइयां.