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