هر باند یا فراداده مشخص شده از تصویر موجود در مجموعه به تصویر منبع اضافه میشود و اگر باندها یا فرادادهها از قبل وجود داشته باشند، رونویسی میشوند. اگر تصویر منطبقی پیدا نشود، هر باند جدید یا بهروزرسانی شده به طور کامل پوشانده میشود و هر فراداده جدید یا بهروزرسانی شده تهی خواهد بود. ردپای خروجی همان ردپای تصویر منبع خواهد بود.
اگر تصویر منبع و تصویری در مجموعه دارای یک ویژگی فراداده معادل خاص باشند، تطابق تعیین میشود. اگر بیش از یک تصویر مجموعه مطابقت داشته باشد، تصویر مجموعه انتخاب شده دلخواه است. به طور پیشفرض، تصاویر بر اساس ویژگی فراداده 'system:index' خود تطبیق داده میشوند.
این تابع پیوند، روشی آسان برای افزودن باندها به یک تصویر هدف بر اساس یک ویژگی فراداده مشترک مشخص است و برای پشتیبانی از مجموعههای پیوندی که پردازش/تولید محصول متفاوتی را بر روی تصاویر منبع یکسان اعمال میکنند، در نظر گرفته شده است. برای پیوند رساتر که به عنوان «پیوستن» شناخته میشود، به https://developers.google.com/earth-engine/guides/joins_intro مراجعه کنید.
| کاربرد | بازگشتها |
|---|---|
Image. linkCollection (imageCollection, linkedBands , linkedProperties , matchPropertyName ) | تصویر |
| استدلال | نوع | جزئیات |
|---|---|---|
این: input | تصویر | تصویر منبع، تصویری که در مجموعه با آن مطابقت دارد را به آن لینک میدهد. |
imageCollection | مجموعه تصاویر | مجموعه تصاویر برای استخراج تصویری مطابق با منبع جستجو کرد. |
linkedBands | شیء، پیشفرض: تهی | نام گروه یا فهرستی از نامهای گروه برای افزودن یا بهروزرسانی از تصویر منطبق. |
linkedProperties | شیء، پیشفرض: تهی | یک ویژگی فراداده یا فهرستی از ویژگیها که باید از تصویر منطبق اضافه یا بهروزرسانی شود. |
matchPropertyName | رشته، پیشفرض: "system:index" | نام ویژگی فرادادهای که به عنوان معیار تطابق استفاده میشود. |