ee.Image.linkCollection

מקשר את תמונת המקור לתמונה תואמת מאוסף תמונות.

כל הפסים או המטא-נתונים שצוינו יתווספו לתמונת המקור מהתמונה שנמצאת באוסף, ואם הפסים או המטא-נתונים כבר קיימים הם יוחלפו. אם לא נמצאה תמונה תואמת, כל הפסים החדשים או המעודכנים יוסתרו באופן מלא וכל המטא-נתונים החדשים או המעודכנים יהיו null. השטח של הפלט יהיה זהה לשטח של תמונת המקור.

התאמה נקבעת אם לתמונת המקור ולתמונה באוסף יש מאפיין מטא-נתונים מקביל ספציפי. אם יש יותר מתמונה אחת לקולקציה שמתאימה, התמונה שנבחרת היא אקראית. כברירת מחדל, התמונות משויכות לפי מאפיין המטא-נתונים '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	שם מאפיין המטא-נתונים שמשמש כקריטריון להתאמה.