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, toutes les bandes nouvelles ou mises à jour seront entièrement masquées, et toutes les métadonnées nouvelles ou mises à jour seront nulles. L'empreinte de sortie sera identique à celle de l'image source.
Une correspondance est déterminée si l'image source et une image de la collection possèdent une propriété de métadonnées équivalente spécifique. Si plusieurs images de la collection correspondent, l'image de la 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 de liaison 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 la liaison de collections qui appliquent un traitement/une génération de produits différents à la même imagerie source. Pour une liaison 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 |
|---|---|---|
this: input | Image | Image source à laquelle une image correspondante de la collection sera associée. |
imageCollection | ImageCollection | Collection d'images dans laquelle effectuer la recherche pour extraire une image correspondant à la source. |
linkedBands | Objet, valeur par défaut : null | Nom de bande ou liste de noms de bandes à ajouter ou à mettre à jour à partir de l'image correspondante. |
linkedProperties | Objet, valeur par défaut : null | Propriété de métadonnées ou liste de propriétés à ajouter ou à mettre à jour à partir de l'image correspondante. |
matchPropertyName | Chaîne, valeur par défaut : "system:index" | Nom de la propriété de métadonnées à utiliser comme critère de correspondance. |