ee.ImageCollection.linkCollection
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
تصاویر موجود در این مجموعه را به تصاویر منطبق از
imageCollection پیوند می دهد.
برای هر تصویر منبع در این مجموعه، هر باند یا ابرداده مشخص شده از تصویر منطبق موجود در به تصویر منبع اضافه می شود.
imageCollection . اگر باندها یا ابرداده ها از قبل وجود داشته باشند، بازنویسی می شوند. اگر تصاویر منطبق پیدا نشد، هر باند جدید یا به‌روزرسانی شده کاملاً پوشانده می‌شود و هر متادیتای جدید یا به‌روزرسانی شده پوچ خواهد بود. ردپای خروجی همانند ردپای تصویر منبع خواهد بود.
اگر یک تصویر منبع و یک تصویر در imageCollection دارای خاصیت فراداده معادل خاصی باشند، تطابق تعیین می شود. اگر بیش از یک تصویر مجموعه مطابقت داشته باشد، تصویر مجموعه انتخاب شده دلخواه است. به‌طور پیش‌فرض، تصاویر در ویژگی فوق‌داده «system:index» مطابقت دارند.
این تابع پیوند یک روش راحت برای افزودن باندها به تصاویر هدف بر اساس خاصیت فوق داده مشترک مشخص شده است و برای پشتیبانی از مجموعه‌های پیوندی که پردازش/تولید محصول متفاوتی را به تصویر منبع یکسان اعمال می‌کنند، در نظر گرفته شده است. برای پیوندهای گویاتر به نام
«پیوستن»، به https://developers.google.com/earth-engine/guides/joins_intro مراجعه کنید.
مجموعه تصاویر مرتبط را برمی گرداند.
| استفاده | برمی گرداند | ImageCollection. linkCollection (imageCollection, linkedBands , linkedProperties , matchPropertyName ) | ImageCollection |
| استدلال | تایپ کنید | جزئیات | این: imagecollection | ImageCollection | نمونه ImageCollection. |
imageCollection | ImageCollection | مجموعه تصاویر برای یافتن موارد منطبق از این مجموعه جستجو شد. |
linkedBands | List<String>، اختیاری است | فهرست اختیاری نام گروه‌ها برای افزودن یا به‌روزرسانی از تصاویر منطبق. |
linkedProperties | List<String>، اختیاری است | فهرست اختیاری ویژگی‌های ابرداده برای افزودن یا به‌روزرسانی از تصاویر منطبق. |
matchPropertyName | رشته، اختیاری | نام ویژگی فراداده برای استفاده به عنوان معیار مطابقت. پیش‌فرض «system:index» است. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe \u003ccode\u003elinkCollection\u003c/code\u003e function connects images in one collection to matching images in another based on shared metadata.\u003c/p\u003e\n"],["\u003cp\u003eIt adds or updates bands and metadata in the first collection using information from matching images in the second collection.\u003c/p\u003e\n"],["\u003cp\u003eMatching images are identified by a specified metadata property, with "system:index" as the default.\u003c/p\u003e\n"],["\u003cp\u003eUnmatched images will have masked bands and null metadata for newly added or updated properties.\u003c/p\u003e\n"],["\u003cp\u003eThis function simplifies linking images derived from the same source but with different processing applied.\u003c/p\u003e\n"]]],[],null,["# ee.ImageCollection.linkCollection\n\n\u003cbr /\u003e\n\nLinks images in this collection to matching images from `imageCollection`.\n\n\u003cbr /\u003e\n\nFor each source image in this collection, any specified bands or metadata will be added to the source image from the matching image found in\n\n`imageCollection`. If bands or metadata are already present, they will be overwritten. If matching images are not found, any new or updated bands will be fully masked and any new or updated metadata will be null. The output footprint will be the same as the source image footprint.\n\nMatches are determined if a source image and an image in `imageCollection` have a specific equivalent metadata property. If more than one collection image would match, the collection image selected is arbitrary. By default, images are matched on their 'system:index' metadata property.\n\nThis linking function is a convenience method for adding bands to target images based on a specified shared metadata property and is intended to support linking collections that apply different processing/product generation to the same source imagery. For more expressive linking known as\n\n'joining', see https://developers.google.com/earth-engine/guides/joins_intro.\n\nReturns the linked image collection.\n\n| Usage | Returns |\n|-------------------------------------------------------------------------------------------------------------------|-----------------|\n| ImageCollection.linkCollection`(imageCollection, `*linkedBands* `, `*linkedProperties* `, `*matchPropertyName*`)` | ImageCollection |\n\n| Argument | Type | Details |\n|-------------------------|--------------------------|------------------------------------------------------------------------------------|\n| this: `imagecollection` | ImageCollection | The ImageCollection instance. |\n| `imageCollection` | ImageCollection | The image collection searched to find matches from this collection. |\n| `linkedBands` | List\\\u003cString\\\u003e, optional | Optional list of band names to add or update from matching images. |\n| `linkedProperties` | List\\\u003cString\\\u003e, optional | Optional list of metadata properties to add or update from matching images. |\n| `matchPropertyName` | String, optional | The metadata property name to use as a match criteria. Defaults to \"system:index\". |"]]
