रूट मैट्रिक्स के अनुरोध में, यात्रा शुरू करने की जगह और मंज़िल के वेपॉइंट का कलेक्शन इनपुट के तौर पर लिया जाता है. इसके बाद, Routes API, शुरुआत की जगह के हर वेपॉइंट से मंज़िल के हर वेपॉइंट तक के रास्ते का हिसाब लगाता है. उदाहरण के लिए, अगर आपने दो शुरुआती वेपॉइंट और दो डेस्टिनेशन वेपॉइंट तय किए हैं, तो एपीआई चार अलग-अलग रास्तों का हिसाब लगाता है.
एपीआई से मिली जानकारी में एक कलेक्शन होता है. इसमें मौजूद हर एलिमेंट, शुरुआती जगह के एक वेपॉइंट से मंज़िल के एक वेपॉइंट तक के रूट से जुड़ा होता है. इसलिए, अगर आपने शुरुआत की जगह के दो वेपॉइंट और मंज़िल के दो वेपॉइंट तय किए हैं, तो रिस्पॉन्स कलेक्शन में चार एलिमेंट शामिल होंगे. इनमें से हर एलिमेंट, कैलकुलेट किए गए हर रास्ते के लिए होगा.
जवाब का इस्तेमाल करके, अपने ग्राहकों को रास्ते के अलग-अलग विकल्प दिए जा सकते हैं. इसके बाद, उपयोगकर्ता अपनी ज़रूरतों के हिसाब से सही रास्ता चुन सकता है.
फ़ील्ड मास्क के बारे में जानकारी
किसी रास्ते का हिसाब लगाने के लिए, किसी तरीके को कॉल करते समय आपको फ़ील्ड मास्क की जानकारी देनी होगी. इससे यह तय होता है कि आपको जवाब में कौनसे फ़ील्ड चाहिए. वापस किए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं होती. अगर इस सूची को शामिल नहीं किया जाता है, तो तरीके गड़बड़ी का मैसेज दिखाते हैं.
इस दस्तावेज़ में दिए गए उदाहरणों में, फ़ील्ड मास्क को ध्यान में रखे बिना पूरा रिस्पॉन्स ऑब्जेक्ट दिखाया गया है. प्रोडक्शन एनवायरमेंट में, आपके जवाब में सिर्फ़ वे फ़ील्ड शामिल होंगे जिन्हें आपने फ़ील्ड मास्क में साफ़ तौर पर बताया है.
ज़्यादा जानकारी के लिए, चुनें कि कौनसी जानकारी दिखानी है लेख पढ़ें.
कॉपीराइट दिखाने के बारे में जानकारी
अपने उपयोगकर्ताओं को नतीजे दिखाते समय, आपको कॉपीराइट से जुड़ा यह स्टेटमेंट शामिल करना होगा:
Powered by Google, ©YEAR Google
उदाहरण के लिए:
Powered by Google, ©2023 Google
जवाब में रूट की पहचान करना
जवाब में हर रास्ते की पहचान करने के लिए, originIndex और destinationIndex रिस्पॉन्स प्रॉपर्टी का इस्तेमाल करें. इन प्रॉपर्टी में, इनपुट ऑरिजिन और इनपुट डेस्टिनेशन वेपॉइंट का ज़ीरो-बेस्ड इंडेक्स शामिल होता है. इसका इस्तेमाल, रास्ते का हिसाब लगाने के लिए किया जाता है. इसका मतलब है कि अनुरोध में मौजूद, शुरुआत की जगह का पहला वेपॉइंट और मंज़िल का पहला वेपॉइंट, कलेक्शन इंडेक्स 0 पर हैं.
उदाहरण के लिए, जवाब में दिए गए रास्ते में ये चीज़ें शामिल होती हैं:
"originIndex": 1, "destinationIndex": 0
इन प्रॉपर्टी से पता चलता है कि रूट का हिसाब, इनपुट कलेक्शन में इंडेक्स 1 पर मौजूद शुरुआती वेपॉइंट और इंडेक्स 0 पर मौजूद डेस्टिनेशन वेपॉइंट से लगाया गया था.
अगले रास्ते के लिए:
"originIndex": 4, "destinationIndex": 1
रास्ते का हिसाब, इनपुट कलेक्शन में इंडेक्स 4 पर मौजूद शुरुआती वेपॉइंट और इनपुट कलेक्शन में इंडेक्स 1 पर मौजूद मंज़िल के वेपॉइंट से लगाया गया था.
जवाब में रास्ते की जानकारी के बारे में जानकारी
एपीआई से मिली जानकारी में एक कलेक्शन होता है. इसमें मौजूद हर एलिमेंट, एक ऑरिजिन वेपॉइंट से एक डेस्टिनेशन वेपॉइंट तक का रास्ता तय करता है. ये एलिमेंट, gRPC तरीके में RouteMatrixElements या एचटीटीपी रिस्पॉन्स में रिस्पॉन्स बॉडी होते हैं.
originIndex और destinationIndex प्रॉपर्टी के साथ-साथ, हर एलिमेंट में उस रास्ते से जुड़ी बुनियादी जानकारी ही शामिल होती है. जैसे, distanceMeters, duration, और travelAdvisory. किसी रास्ते के बारे में ज़्यादा जानकारी पाने के लिए, computeRoutes का इस्तेमाल करें. जैसे, पॉलीलाइन.
जवाब का फ़ॉर्मैट ऐसा होता है:
[ // 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) } } … ]