Anuncio: Todos los proyectos no comerciales registrados para usar Earth Engine antes del
15 de abril de 2025 deben
verificar su elegibilidad no comercial para mantener el acceso a Earth Engine.
ee.Image.where
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Realiza un reemplazo condicional de valores.
Para cada píxel de cada banda de "input", si el píxel correspondiente en "test" no es cero, genera el píxel correspondiente en el valor; de lo contrario, genera el píxel de entrada.
Si, en un píxel determinado, se enmascara la prueba o el valor, se usa el valor de entrada. Si la entrada está enmascarada, no se realiza ninguna acción.
Las bandas de salida tienen los mismos nombres que las de entrada. El tipo de salida de cada banda es el mayor de los tipos de entrada y valor. La imagen de salida conserva los metadatos y la huella de la imagen de entrada.
Uso | Muestra |
---|
Image.where(test, value) | Imagen |
Argumento | Tipo | Detalles |
---|
esta: input | Imagen | Es la imagen de entrada. |
test | Imagen | Es la imagen de prueba. Los píxeles de esta imagen determinan cuáles de los píxeles de entrada se devuelven. Si se trata de una sola banda, se usa para todas las bandas de la imagen de entrada. Es posible que esta no sea una imagen de array. |
value | Imagen | Es el valor de salida que se usará cuando la prueba no sea cero. Si se trata de una sola banda, se usa para todas las bandas de la imagen de entrada. |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-26 (UTC)
[null,null,["Última actualización: 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. |"]]