Las bandas o los metadatos especificados se agregarán a la imagen de origen a partir de la imagen que se encuentre en la colección y, si las bandas o los metadatos ya están presentes, se reemplazarán. Si no se encuentra una imagen coincidente, las bandas nuevas o actualizadas se enmascararán por completo y los metadatos nuevos o actualizados serán nulos. La huella de salida será la misma que la de la imagen de origen.
Se determina una coincidencia si la imagen fuente y una imagen de la colección tienen una propiedad de metadatos equivalente específica. Si coinciden más de una imagen de la colección, la imagen de la colección seleccionada es arbitraria. De forma predeterminada, las imágenes coinciden con su propiedad de metadatos "system:index".
Esta función de vinculación es un método conveniente para agregar bandas a una imagen de destino en función de una propiedad de metadatos compartidos especificada y está diseñada para admitir la vinculación de colecciones que aplican diferentes procesos o generación de productos a las mismas imágenes de origen. Para obtener más información sobre la vinculación más expresiva, conocida como "unión", consulta https://developers.google.com/earth-engine/guides/joins_intro.
| Uso | Muestra |
|---|---|
Image.linkCollection(imageCollection, linkedBands, linkedProperties, matchPropertyName) | Imagen |
| Argumento | Tipo | Detalles |
|---|---|---|
esta: input | Imagen | Es la imagen de origen a la que se vinculará una imagen coincidente de la colección. |
imageCollection | ImageCollection | Es la colección de imágenes en la que se busca para extraer una imagen que coincida con la fuente. |
linkedBands | Objeto, valor predeterminado: nulo | Es el nombre de una banda o una lista de nombres de bandas para agregar o actualizar desde la imagen coincidente. |
linkedProperties | Objeto, valor predeterminado: nulo | Es una propiedad de metadatos o una lista de propiedades que se agregarán o actualizarán a partir de la imagen coincidente. |
matchPropertyName | Cadena. El valor predeterminado es "system:index". | Nombre de la propiedad de metadatos que se usará como criterio de coincidencia. |