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.where
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Realiza a substituição condicional de valores.
Para cada pixel em cada banda de "input", se o pixel correspondente em "test" for diferente de zero, gere o pixel correspondente em "value". Caso contrário, gere o pixel de entrada.
Se em um determinado pixel, o teste ou o valor estiverem mascarados, o valor de entrada será usado. Se a entrada estiver mascarada, nada será feito.
As bandas de saída têm os mesmos nomes das bandas de entrada. O tipo de saída de cada intervalo é o maior entre os tipos de entrada e valor. A imagem de saída retém os metadados e a área da imagem de entrada.
| Uso | Retorna |
|---|
Image.where(test, value) | Imagem |
| Argumento | Tipo | Detalhes |
|---|
isso: input | Imagem | A imagem de entrada. |
test | Imagem | A imagem de teste. Os pixels dessa imagem determinam quais dos pixels de entrada são retornados. Se for uma única banda, ela será usada para todas as bandas na imagem de entrada. Talvez não seja uma imagem de matriz. |
value | Imagem | O valor de saída a ser usado quando o teste não for zero. Se for uma única banda, ela será usada para todas as bandas na imagem de entrada. |
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\u003eReplaces input image pixel values with values from a secondary image based on a test image's pixel values.\u003c/p\u003e\n"],["\u003cp\u003eIf the test image pixel is non-zero, the corresponding pixel from the value image is used; otherwise, the original input pixel is retained.\u003c/p\u003e\n"],["\u003cp\u003eInput image metadata and footprint are preserved in the output image.\u003c/p\u003e\n"],["\u003cp\u003eOutput image band types are determined by the larger type between the input and value images.\u003c/p\u003e\n"],["\u003cp\u003eMasked pixels in either test or value images result in the original input pixel being used in the output.\u003c/p\u003e\n"]]],[],null,["# ee.Image.where\n\nPerforms conditional replacement of values.\n\n\u003cbr /\u003e\n\nFor each pixel in each band of 'input', if the corresponding pixel in 'test' is nonzero, output the corresponding pixel in value, otherwise output the input pixel.\n\nIf at a given pixel, either test or value is masked, the input value is used. If the input is masked, nothing is done.\n\nThe output bands have the same names as the input bands. The output type of each band is the larger of the input and value types. The output image retains the metadata and footprint of the input image.\n\n| Usage | Returns |\n|----------------------------|---------|\n| Image.where`(test, value)` | Image |\n\n| Argument | Type | Details |\n|---------------|-------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `input` | Image | The input image. |\n| `test` | Image | The test image. The pixels of this image determines which of the input pixels is returned. If this is a single band, it is used for all bands in the input image. This may not be an array image. |\n| `value` | Image | The output value to use where test is not zero. If this is a single band, it is used for all bands in the input image. |"]]
