As bandas ou metadados especificados serão adicionados à imagem de origem da imagem encontrada na coleção. Se já estiverem presentes, serão substituídos. Se uma imagem correspondente não for encontrada, todas as bandas novas ou atualizadas serão totalmente mascaradas, e todos os metadados novos ou atualizados serão nulos. A área de saída será igual à da imagem de origem.
Uma correspondência é determinada se a imagem de origem e uma imagem na coleção têm uma propriedade de metadados equivalente específica. Se mais de uma imagem de coleção corresponder, a imagem selecionada será arbitrária. Por padrão, as imagens são correspondidas na propriedade de metadados "system:index".
Essa função de vinculação é um método conveniente para adicionar bandas a uma imagem de destino com base em uma propriedade de metadados compartilhada especificada. Ela foi criada para oferecer suporte à vinculação de coleções que aplicam processamento/geração de produtos diferentes às mesmas imagens de origem. Para uma vinculação mais expressiva, conhecida como "junção", consulte https://developers.google.com/earth-engine/guides/joins_intro.
| Uso | Retorna |
|---|---|
Image.linkCollection(imageCollection, linkedBands, linkedProperties, matchPropertyName) | Imagem |
| Argumento | Tipo | Detalhes |
|---|---|---|
isso: input | Imagem | A imagem de origem a que uma imagem correspondente na coleção será vinculada. |
imageCollection | ImageCollection | A coleção de imagens pesquisada para extrair uma imagem correspondente à origem. |
linkedBands | Objeto, padrão: nulo | Um nome de banda ou uma lista de nomes de bandas para adicionar ou atualizar na imagem correspondente. |
linkedProperties | Objeto, padrão: nulo | Uma propriedade de metadados ou uma lista de propriedades a serem adicionadas ou atualizadas da imagem correspondente. |
matchPropertyName | String, padrão: "system:index" | O nome da propriedade de metadados a ser usada como um critério de correspondência. |