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