Anúncio: todos os projetos não comerciais registrados para usar o Earth Engine antes de
15 de abril de 2025 precisam
verificar a qualificação não comercial para manter o acesso ao Earth Engine.
ee.Image.linkCollection
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Vincula a imagem de origem a uma imagem correspondente de uma coleção de imagens.
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. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 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. |"]]
