Setiap band atau metadata yang ditentukan akan ditambahkan ke gambar sumber dari gambar yang ditemukan dalam koleksi, dan jika band atau metadata sudah ada, band atau metadata tersebut akan ditimpa. Jika gambar yang cocok tidak ditemukan, semua band baru atau yang diperbarui akan sepenuhnya ditutupi dan semua metadata baru atau yang diperbarui akan bernilai null. Jejak output akan sama dengan jejak gambar sumber.
Kecocokan ditentukan jika gambar sumber dan gambar dalam koleksi memiliki properti metadata yang setara. Jika ada lebih dari satu gambar koleksi yang cocok, gambar koleksi yang dipilih bersifat acak. Secara default, gambar dicocokkan berdasarkan properti metadata 'system:index'.
Fungsi penautan ini adalah metode praktis untuk menambahkan band ke gambar target berdasarkan properti metadata bersama yang ditentukan dan dimaksudkan untuk mendukung penautan koleksi yang menerapkan pemrosesan/pembuatan produk yang berbeda ke gambar sumber yang sama. Untuk penautan yang lebih ekspresif yang dikenal sebagai 'penggabungan', lihat https://developers.google.com/earth-engine/guides/joins_intro.
| Penggunaan | Hasil |
|---|---|
Image.linkCollection(imageCollection, linkedBands, linkedProperties, matchPropertyName) | Gambar |
| Argumen | Jenis | Detail |
|---|---|---|
ini: input | Gambar | Gambar sumber yang cocok dengan gambar dalam koleksi akan ditautkan. |
imageCollection | ImageCollection | Koleksi gambar yang ditelusuri untuk mengekstrak gambar yang cocok dengan sumber. |
linkedBands | Objek, default: null | Nama band atau daftar nama band yang akan ditambahkan atau diperbarui dari gambar yang cocok. |
linkedProperties | Objek, default: null | Properti metadata atau daftar properti yang akan ditambahkan atau diperbarui dari gambar yang cocok. |
matchPropertyName | String, default: "system:index" | Nama properti metadata yang akan digunakan sebagai kriteria kecocokan. |