هر باند یا ابرداده مشخص شده از تصویر موجود در مجموعه به تصویر منبع اضافه می شود و اگر باندها یا ابرداده ها از قبل وجود داشته باشند، بازنویسی می شوند. اگر تصویر منطبقی پیدا نشد، هر باند جدید یا بهروزرسانی شده کاملاً پوشانده میشود و هر متادیتای جدید یا بهروزرسانی شده پوچ خواهد بود. ردپای خروجی همانند ردپای تصویر منبع خواهد بود.
در صورتی که تصویر منبع و یک تصویر در مجموعه دارای خاصیت فراداده معادل خاصی باشند، تطابق تعیین میشود. اگر بیش از یک تصویر مجموعه مطابقت داشته باشد، تصویر مجموعه انتخاب شده دلخواه است. بهطور پیشفرض، تصاویر در ویژگی فوقداده «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" | نام ویژگی فراداده برای استفاده به عنوان معیار مطابقت. |