Annuncio: tutti i progetti non commerciali registrati per l'utilizzo di Earth Engine prima del
15 aprile 2025 devono
verificare l'idoneità non commerciale per mantenere l'accesso a Earth Engine.
ee.Image.where
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Esegue la sostituzione condizionale dei valori.
Per ogni pixel in ogni banda di "input", se il pixel corrispondente in "test" è diverso da zero, restituisci il pixel corrispondente in value, altrimenti restituisci il pixel di input.
Se in un determinato pixel viene mascherato il test o il valore, viene utilizzato il valore di input. Se l'input è mascherato, non viene eseguita alcuna operazione.
Le bande di output hanno gli stessi nomi delle bande di input. Il tipo di output di ogni banda è il maggiore tra i tipi di input e di valore. L'immagine di output conserva i metadati e l'impronta dell'immagine di input.
Utilizzo | Resi |
---|
Image.where(test, value) | Immagine |
Argomento | Tipo | Dettagli |
---|
questo: input | Immagine | L'immagine di input. |
test | Immagine | L'immagine di test. I pixel di questa immagine determinano quali pixel di input vengono restituiti. Se si tratta di una singola banda, viene utilizzata per tutte le bande dell'immagine di input. Potrebbe non essere un'immagine di array. |
value | Immagine | Il valore di output da utilizzare quando il test non è zero. Se si tratta di una singola banda, viene utilizzata per tutte le bande dell'immagine di input. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-26 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]