ee.Image.linkCollection
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Associe l'image source à une image correspondante d'une collection d'images.
Toutes les bandes ou métadonnées spécifiées seront ajoutées à l'image source à partir de l'image trouvée dans la collection. Si les bandes ou les métadonnées sont déjà présentes, elles seront remplacées. Si aucune image correspondante n'est trouvée, les nouvelles bandes ou celles qui ont été modifiées seront entièrement masquées, et les nouvelles métadonnées ou celles qui ont été modifiées seront nulles. L'empreinte de sortie sera identique à celle de l'image source.
Une correspondance est établie si l'image source et une image de la collection ont une propriété de métadonnées équivalente spécifique. Si plusieurs images de collection correspondent, l'image de collection sélectionnée est arbitraire. Par défaut, les images sont mises en correspondance en fonction de leur propriété de métadonnées "system:index".
Cette fonction d'association est une méthode pratique pour ajouter des bandes à une image cible en fonction d'une propriété de métadonnées partagée spécifiée. Elle est destinée à prendre en charge l'association de collections qui appliquent un traitement/une génération de produit différents à la même imagerie source. Pour en savoir plus sur l'association plus expressive appelée "jointure", consultez https://developers.google.com/earth-engine/guides/joins_intro.
| Utilisation | Renvoie |
|---|
Image.linkCollection(imageCollection, linkedBands, linkedProperties, matchPropertyName) | Image |
| Argument | Type | Détails |
|---|
ceci : input | Image | L'image source à laquelle une image correspondante de la collection sera associée. |
imageCollection | ImageCollection | Collection d'images dans laquelle la recherche est effectuée pour extraire une image correspondant à la source. |
linkedBands | Objet, valeur par défaut : null | Nom ou liste de noms de groupes à ajouter ou à modifier à partir de l'image correspondante. |
linkedProperties | Objet, valeur par défaut : null | Propriété ou liste de propriétés de métadonnées à ajouter ou à mettre à jour à partir de l'image correspondante. |
matchPropertyName | Chaîne, par défaut : "system:index" | Nom de la propriété de métadonnées à utiliser comme critère de correspondance. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eLinks a source image to a matching image within a specified image collection based on a shared metadata property, such as 'system:index'.\u003c/p\u003e\n"],["\u003cp\u003eIf a match is found, it adds or overwrites bands and metadata from the collection image to the source image, otherwise, new bands are masked and metadata is nulled.\u003c/p\u003e\n"],["\u003cp\u003ePrimarily used to link collections with varied processing applied to the same base imagery, providing a streamlined method for band and metadata integration.\u003c/p\u003e\n"],["\u003cp\u003eOffers basic linking functionality; for more complex scenarios requiring joins, refer to the Earth Engine guide on joins.\u003c/p\u003e\n"],["\u003cp\u003eThe output maintains the source image's footprint regardless of the linking outcome.\u003c/p\u003e\n"]]],["The `linkCollection` function links a source image to a matching image from a collection based on a shared metadata property, defaulting to 'system:index'. It adds or overwrites specified bands and metadata from the matched collection image onto the source image. If no match is found, new or updated bands are masked, and metadata is null. The function accepts arguments for the collection, bands, metadata properties to link, and the match property name. The output footprint matches the source image.\n"],null,["# ee.Image.linkCollection\n\nLinks the source image to a matching image from an image collection.\n\n\u003cbr /\u003e\n\nAny specified bands or metadata will be added to the source image from the image found in the collection, and if the bands or metadata are already present they will be overwritten. If a matching image is not found, any new or updated bands will be fully masked and any new or updated metadata will be null. The output footprint will be the same as the source image footprint.\n\nA match is determined if the source image and an image in the collection have a specific equivalent metadata property. If more than one collection image would match, the collection image selected is arbitrary. By default, images are matched on their 'system:index' metadata property.\n\nThis linking function is a convenience method for adding bands to a target image based on a specified shared metadata property and is intended to support linking collections that apply different processing/product generation to the same source imagery. For more expressive linking known as 'joining', see https://developers.google.com/earth-engine/guides/joins_intro.\n\n| Usage | Returns |\n|---------------------------------------------------------------------------------------------------------|---------|\n| Image.linkCollection`(imageCollection, `*linkedBands* `, `*linkedProperties* `, `*matchPropertyName*`)` | Image |\n\n| Argument | Type | Details |\n|---------------------|---------------------------------|-------------------------------------------------------------------------------------|\n| this: `input` | Image | The source image a matching image in the collection will be linked to. |\n| `imageCollection` | ImageCollection | The image collection searched to extract an image matching the source. |\n| `linkedBands` | Object, default: null | A band name or list of band names to add or update from the matching image. |\n| `linkedProperties` | Object, default: null | A metadata property or list of properties to add or update from the matching image. |\n| `matchPropertyName` | String, default: \"system:index\" | The metadata property name to use as a match criteria. |"]]
