Mọi dải tần hoặc siêu dữ liệu được chỉ định sẽ được thêm vào hình ảnh nguồn từ hình ảnh tìm thấy trong bộ sưu tập. Nếu dải tần hoặc siêu dữ liệu đã có thì sẽ bị ghi đè. Nếu không tìm thấy hình ảnh phù hợp, thì mọi dải tần mới hoặc được cập nhật sẽ bị che hoàn toàn và mọi siêu dữ liệu mới hoặc được cập nhật sẽ là null. Dấu vết đầu ra sẽ giống như dấu vết hình ảnh nguồn.
Một kết quả trùng khớp được xác định nếu hình ảnh nguồn và một hình ảnh trong bộ sưu tập có một thuộc tính siêu dữ liệu tương đương cụ thể. Nếu có nhiều hình ảnh trong bộ sưu tập trùng khớp, thì hình ảnh được chọn trong bộ sưu tập sẽ là tuỳ ý. Theo mặc định, hình ảnh được so khớp dựa trên thuộc tính siêu dữ liệu "system:index".
Hàm liên kết này là một phương thức tiện lợi để thêm dải tần vào hình ảnh mục tiêu dựa trên một thuộc tính siêu dữ liệu dùng chung được chỉ định và nhằm hỗ trợ liên kết các bộ sưu tập áp dụng quy trình xử lý/tạo sản phẩm khác nhau cho cùng một hình ảnh nguồn. Để biết thêm về tính năng liên kết biểu cảm hơn, còn được gọi là "kết hợp", hãy xem https://developers.google.com/earth-engine/guides/joins_intro.
| Cách sử dụng | Giá trị trả về |
|---|---|
Image.linkCollection(imageCollection, linkedBands, linkedProperties, matchPropertyName) | Hình ảnh |
| Đối số | Loại | Thông tin chi tiết |
|---|---|---|
this: input | Hình ảnh | Hình ảnh nguồn mà hình ảnh phù hợp trong bộ sưu tập sẽ được liên kết. |
imageCollection | ImageCollection | Bộ sưu tập hình ảnh được tìm kiếm để trích xuất một hình ảnh phù hợp với nguồn. |
linkedBands | Đối tượng, mặc định: null | Tên dải tần hoặc danh sách tên dải tần để thêm hoặc cập nhật từ hình ảnh phù hợp. |
linkedProperties | Đối tượng, mặc định: null | Thuộc tính siêu dữ liệu hoặc danh sách thuộc tính để thêm hoặc cập nhật từ hình ảnh phù hợp. |
matchPropertyName | Chuỗi, mặc định: "system:index" | Tên thuộc tính siêu dữ liệu dùng làm tiêu chí so khớp. |