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

रूट मैट्रिक्स अनुरोध, शुरुआत की जगह और मंज़िल की श्रेणी इनपुट के रूप में लेता है वेपॉइंट. इसके बाद, 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)
    }
  }
  …
]