रास्तों के मैट्रिक्स की समीक्षा करें

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

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

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

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

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

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

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

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

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

Powered by Google, ©YEAR Google

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

Powered by Google, ©2023 Google

रिस्पॉन्स में रूट की पहचान करें

रिस्पॉन्स में मौजूद हर रूट की पहचान करने के लिए, originIndex और destinationIndex रिस्पॉन्स प्रॉपर्टी का इस्तेमाल करें. इन प्रॉपर्टी में, इनपुट origin और इनपुट destination वेपॉइंट का शून्य-आधारित इंडेक्स होता है, जिनका इस्तेमाल रूट कैलकुलेट करने के लिए किया जाता है. इसका मतलब है कि अनुरोध में पहला ऑरिजिन वेपॉइंट और पहला डेस्टिनेशन वेपॉइंट, अरे इंडेक्स 0 पर है.

उदाहरण के लिए, जवाब में दिए गए रूट में यह शामिल है:

"originIndex": 1,
"destinationIndex": 0

इन प्रॉपर्टी से पता चलता है कि रूट को कैलकुलेट करने के लिए, इनपुट ऐरे में इंडेक्स 1 पर ऑरिजिन वेपॉइंट से और इंडेक्स 0 पर डेस्टिनेशन वेपॉइंट से तय किया गया है.

अगले रास्ते के लिए:

"originIndex": 4,
"destinationIndex": 1

इनपुट कलेक्शन में इंडेक्स 4 पर मौजूद ऑरिजिन वेपॉइंट से और इंडेक्स 1 पर डेस्टिनेशन वेपॉइंट से रूट का हिसाब लगाया गया है.

जवाब के बारे में जानकारी

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

originIndex और destinationIndex प्रॉपर्टी के साथ-साथ, हर रास्ते में उस रास्ते की खास जानकारी होती है, जैसे कि distanceMeters, duration, और travelAdvisory.

जवाब का यह फ़ॉर्म होगा:

[
  // One array element for each combination of origin and destination waypoints.
  {
    // The route for source waypoint 0 and destination waypoint 0.
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  {
    // The route for source waypoint 0 and destination waypoint 1.
    "originIndex": 0,
    "destinationIndex": 1,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  …
]