إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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\". |"]]
