ComputeRoutes() वाले तरीके को कॉल करते समय, आपको यह बताना होगा कि रिस्पॉन्स में किन फ़ील्ड को दिखाना है. ऐसा करने के लिए, रिस्पॉन्स फ़ील्ड मास्क
का इस्तेमाल किया जा सकता है. यह मास्क, यूआरएल पैरामीटर $fields या fields के साथ दिया जाता है. इसके अलावा, एचटीटीपी/gRPC हेडर X-Goog-FieldMask का इस्तेमाल भी किया जा सकता है. ज़्यादा जानकारी के लिए, सिस्टम पैरामीटर देखें.
फ़ील्ड मास्क
फ़ील्ड मास्क की वैल्यू, फ़ील्ड पाथ की कॉमा-सेपरेटेड लिस्ट है. हर फ़ील्ड पाथ, फ़ील्ड के नाम से अलग की गई एक सूची होती है जो मैसेज के क्रम को दिखाती है. फ़ील्ड का नाम या तो JSON ऑब्जेक्ट कुंजी होता है या प्रोटोबफ़ फ़ील्ड टैग का नाम होता है. फ़ील्ड पाथ, टॉप लेवल रिस्पॉन्स मैसेज टाइप से शुरू होता है. ज़रूरी नहीं है कि इसके बाद एक या उससे ज़्यादा बिंदु हों और फिर फ़ील्ड के नाम के अगले लेवल पर जाएं. आम तौर पर, फ़ील्ड पाथ इस तरह बनाए जाते हैं:
topLevelField[.secondLevelField][.thirdLevelField][...]
एक खास केस फ़ील्ड मास्क एक वाइल्डकार्ड “*” है, जो सभी रूट-लेवल फ़ील्ड को चुनता है.
उदाहरण
इस उदाहरण में, ComputeRoutes() तरीके के लिए फ़ील्ड मास्क सेट करने का तरीका बताया गया है.
उदाहरण 1
सभी उपलब्ध फ़ील्ड का फ़ील्ड मास्क (मैन्युअल जांच के लिए).
X-Goog-FieldMask: *
दूसरा उदाहरण
रूट-लेवल पर तय की गई दूरी, दूरी, और पॉलीलाइन का फ़ील्ड मास्क (उदाहरण के तौर पर, प्रोडक्शन सेटअप).
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline
हम वाइल्डकार्ड (*) रिस्पॉन्स फ़ील्ड मास्क के इस्तेमाल या प्रोडक्शन में टॉप लेवल (रूट) पर फ़ील्ड मास्क तय करने से मना करते हैं. आपको सिर्फ़ अपनी ज़रूरत के फ़ील्ड चुनने होंगे:
इससे हमारे सर्वर को प्रोसेसिंग साइकल को सेव करने की अनुमति मिलती है. इससे हम इंतज़ार के समय को कम करके, नतीजे दिखा पाते हैं.
यह पक्का करता है कि इंतज़ार के समय में कोई बदलाव न हुआ हो. आने वाले समय में, हम ज़्यादा रिस्पॉन्स फ़ील्ड जोड़ सकते हैं और उन नए फ़ील्ड को कैलकुलेट करने में ज़्यादा समय लग सकता है. अगर सभी फ़ील्ड चुने जाते हैं या टॉप लेवल पर सभी फ़ील्ड चुने जाते हैं, तो आपके ऐप्लिकेशन की परफ़ॉर्मेंस में गिरावट आ सकती है. इसकी वजह यह है कि हम जो भी नया फ़ील्ड जोड़ते हैं उसे आपके जवाब में अपने-आप शामिल कर लिया जाता है.
इनमें रिस्पॉन्स का साइज़ छोटा होता है, जिससे नेटवर्क की क्षमता ज़्यादा होती है.
फ़ील्ड पाथ बनाने के तरीके के बारे में ज़्यादा जानने के लिए, field_mask.proto देखें.