إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ee.Image.linkCollection
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يربط الصورة المصدر بصورة مطابقة من مجموعة صور.
ستتم إضافة أي نطاقات أو بيانات وصفية محدّدة إلى الصورة المصدر من الصورة المتوفّرة في المجموعة، وإذا كانت النطاقات أو البيانات الوصفية متوفّرة من قبل، سيتم استبدالها. في حال عدم العثور على صورة مطابقة، سيتم إخفاء أي نطاقات جديدة أو معدَّلة بالكامل، وستكون أي بيانات وصفية جديدة أو معدَّلة فارغة. ستكون مساحة المخرجات مماثلة لمساحة الصورة المصدر.
يتم تحديد التطابق إذا كانت الصورة المصدر وصورة في المجموعة تتضمّنان خاصية بيانات وصفية مكافئة ومحدّدة. إذا كان من الممكن أن تتطابق أكثر من صورة مجموعة واحدة، تكون صورة المجموعة المحدّدة عشوائية. تتم مطابقة الصور تلقائيًا استنادًا إلى سمة البيانات الوصفية "system:index".
وظيفة الربط هذه هي طريقة ملائمة لإضافة نطاقات إلى صورة مستهدَفة استنادًا إلى خاصية بيانات وصفية مشترَكة محدّدة، وهي تهدف إلى إتاحة ربط المجموعات التي تطبّق معالجة أو إنشاء منتجات مختلفة على صور المصدر نفسها. للحصول على معلومات أكثر تفصيلاً حول الربط المعروف باسم "الدمج"، يُرجى الاطّلاع على https://developers.google.com/earth-engine/guides/joins_intro.
| الاستخدام | المرتجعات |
|---|
Image.linkCollection(imageCollection, linkedBands, linkedProperties, matchPropertyName) | صورة |
| الوسيطة | النوع | التفاصيل |
|---|
هذا: input | صورة | تمثّل هذه السمة صورة المصدر التي سيتم ربطها بصورة مطابقة في المجموعة. |
imageCollection | ImageCollection | مجموعة الصور التي تم البحث فيها لاستخراج صورة مطابقة للمصدر |
linkedBands | كائن، القيمة التلقائية: null | اسم فرقة موسيقية أو قائمة بأسماء فرق موسيقية لإضافتها أو تعديلها من الصورة المطابقة |
linkedProperties | كائن، القيمة التلقائية: null | سمة بيانات وصفية أو قائمة سمات لإضافتها أو تعديلها من الصورة المطابقة |
matchPropertyName | سلسلة، القيمة التلقائية: "system:index" | اسم سمة البيانات الوصفية التي سيتم استخدامها كمعيار مطابقة |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eLinks a source image to a matching image within a specified image collection based on a shared metadata property, such as 'system:index'.\u003c/p\u003e\n"],["\u003cp\u003eIf a match is found, it adds or overwrites bands and metadata from the collection image to the source image, otherwise, new bands are masked and metadata is nulled.\u003c/p\u003e\n"],["\u003cp\u003ePrimarily used to link collections with varied processing applied to the same base imagery, providing a streamlined method for band and metadata integration.\u003c/p\u003e\n"],["\u003cp\u003eOffers basic linking functionality; for more complex scenarios requiring joins, refer to the Earth Engine guide on joins.\u003c/p\u003e\n"],["\u003cp\u003eThe output maintains the source image's footprint regardless of the linking outcome.\u003c/p\u003e\n"]]],["The `linkCollection` function links a source image to a matching image from a collection based on a shared metadata property, defaulting to 'system:index'. It adds or overwrites specified bands and metadata from the matched collection image onto the source image. If no match is found, new or updated bands are masked, and metadata is null. The function accepts arguments for the collection, bands, metadata properties to link, and the match property name. The output footprint matches the source image.\n"],null,["# ee.Image.linkCollection\n\nLinks the source image to a matching image from an image collection.\n\n\u003cbr /\u003e\n\nAny specified bands or metadata will be added to the source image from the image found in the collection, and if the bands or metadata are already present they will be overwritten. If a matching image is 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\nA match is determined if the source image and an image in the collection 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 a target image 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 'joining', see https://developers.google.com/earth-engine/guides/joins_intro.\n\n| Usage | Returns |\n|---------------------------------------------------------------------------------------------------------|---------|\n| Image.linkCollection`(imageCollection, `*linkedBands* `, `*linkedProperties* `, `*matchPropertyName*`)` | Image |\n\n| Argument | Type | Details |\n|---------------------|---------------------------------|-------------------------------------------------------------------------------------|\n| this: `input` | Image | The source image a matching image in the collection will be linked to. |\n| `imageCollection` | ImageCollection | The image collection searched to extract an image matching the source. |\n| `linkedBands` | Object, default: null | A band name or list of band names to add or update from the matching image. |\n| `linkedProperties` | Object, default: null | A metadata property or list of properties to add or update from the matching image. |\n| `matchPropertyName` | String, default: \"system:index\" | The metadata property name to use as a match criteria. |"]]
