Todas as bandas ou metadados especificados serão adicionados à imagem de origem da imagem encontrada na coleção. Se as bandas ou os metadados já estiverem presentes, eles 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 intervalos 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 |
|---|---|---|
isto: 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 a serem adicionados ou atualizados 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. |