संग्रह में मौजूद इमेज से, सोर्स इमेज में तय किए गए बैंड या मेटाडेटा जोड़ दिए जाएंगे. अगर बैंड या मेटाडेटा पहले से मौजूद हैं, तो उन्हें बदल दिया जाएगा. अगर मिलती-जुलती इमेज नहीं मिलती है, तो नए या अपडेट किए गए सभी बैंड पूरी तरह से मास्क कर दिए जाएंगे. साथ ही, नया या अपडेट किया गया मेटाडेटा शून्य हो जाएगा. आउटपुट इमेज का फ़ुटप्रिंट, सोर्स इमेज के फ़ुटप्रिंट जैसा ही होगा.
अगर सोर्स इमेज और कलेक्शन में मौजूद किसी इमेज में एक जैसी मेटाडेटा प्रॉपर्टी है, तो उसे मैच माना जाता है. अगर एक से ज़्यादा कलेक्शन इमेज मैच करती हैं, तो चुनी गई कलेक्शन इमेज कोई भी हो सकती है. डिफ़ॉल्ट रूप से, इमेज का मिलान उनकी 'system:index' मेटाडेटा प्रॉपर्टी के आधार पर किया जाता है.
लिंक करने की यह सुविधा, शेयर की गई मेटाडेटा प्रॉपर्टी के आधार पर, टारगेट इमेज में बैंड जोड़ने का एक आसान तरीका है. इसका मकसद, ऐसे कलेक्शन को लिंक करने में मदद करना है जो एक ही सोर्स इमेज पर अलग-अलग प्रोसेसिंग/प्रोडक्ट जनरेशन लागू करते हैं. 'जॉइनिंग' के तौर पर जाने जाने वाले ज़्यादा एक्सप्रेसिव लिंकिंग के बारे में जानने के लिए, https://developers.google.com/earth-engine/guides/joins_intro पर जाएं.
| इस्तेमाल | रिटर्न |
|---|---|
Image.linkCollection(imageCollection, linkedBands, linkedProperties, matchPropertyName) | इमेज |
| आर्ग्यूमेंट | टाइप | विवरण |
|---|---|---|
यह: input | इमेज | सोर्स इमेज, कलेक्शन में मौजूद मिलती-जुलती इमेज से लिंक की जाएगी. |
imageCollection | ImageCollection | इमेज का वह कलेक्शन जिसमें सोर्स से मिलती-जुलती इमेज खोजने के लिए खोज की गई है. |
linkedBands | Object, डिफ़ॉल्ट: null | बैंड का नाम या बैंड के नामों की सूची, जिसे मिलती-जुलती इमेज से जोड़ा या अपडेट किया जाना है. |
linkedProperties | Object, डिफ़ॉल्ट: null | मेटाडेटा प्रॉपर्टी या प्रॉपर्टी की सूची, जिसे मिलती-जुलती इमेज से जोड़ा या अपडेट किया जाना है. |
matchPropertyName | स्ट्रिंग, डिफ़ॉल्ट: "system:index" | मेटाडेटा प्रॉपर्टी का वह नाम जिसे मैचिंग के मानदंड के तौर पर इस्तेमाल करना है. |