ستتم إضافة أي نطاقات أو بيانات وصفية محدّدة إلى الصورة المصدر من الصورة المتوفّرة في المجموعة، وإذا كانت النطاقات أو البيانات الوصفية متوفّرة من قبل، سيتم استبدالها. في حال عدم العثور على صورة مطابقة، سيتم إخفاء أي نطاقات جديدة أو معدَّلة بالكامل، وستكون أي بيانات وصفية جديدة أو معدَّلة فارغة. ستكون مساحة المخرجات مماثلة لمساحة الصورة المصدر.
يتم تحديد التطابق إذا كانت الصورة المصدر وصورة في المجموعة تتضمّنان خاصية بيانات وصفية مكافئة ومحدّدة. إذا كان من الممكن أن تتطابق أكثر من صورة مجموعة واحدة، تكون صورة المجموعة المحدّدة عشوائية. تتم مطابقة الصور تلقائيًا استنادًا إلى سمة البيانات الوصفية "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" | اسم سمة البيانات الوصفية التي سيتم استخدامها كمعيار مطابقة |