ee.Image.reduceResolution
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Active la reprojection à l'aide du réducteur donné pour combiner tous les pixels d'entrée correspondant à chaque pixel de sortie. Si le réducteur ne comporte qu'une seule entrée, il sera appliqué séparément à chaque bande de la collection. Sinon, il doit comporter le même nombre d'entrées que l'image d'entrée comporte de bandes.
Les noms de sortie du réducteur déterminent les noms des bandes de sortie : les réducteurs avec plusieurs entrées utiliseront directement les noms de sortie, les réducteurs avec une seule entrée et une seule sortie conserveront les noms des bandes d'entrée, et les réducteurs avec une seule entrée et plusieurs sorties préfixeront le nom de sortie avec le nom de la bande d'entrée (par exemple, '10_mean', '10_stdDev', '20_mean', '20_stdDev').
Les pondérations d'entrée du réducteur seront le produit du masque d'entrée et de la fraction du pixel de sortie couverte par le pixel d'entrée.
| Utilisation | Renvoie |
|---|
Image.reduceResolution(reducer, bestEffort, maxPixels) | Image |
| Argument | Type | Détails |
|---|
ceci : image | Image | Image d'entrée. |
reducer | Réducteur | Réducteur à appliquer pour combiner les pixels. |
bestEffort | Booléen, valeur par défaut : false | Si l'utilisation de l'entrée à sa résolution par défaut nécessite trop de pixels, commencez par les pixels d'entrée déjà réduits à partir d'un niveau de pyramide qui permet à l'opération de réussir. |
maxPixels | Entier, par défaut : 64 | Nombre maximal de pixels d'entrée à combiner pour chaque pixel de sortie. Si vous définissez une valeur trop élevée, des problèmes de mémoire insuffisante se produiront. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eThis operation reprojects images using a reducer to combine input pixels for each output pixel, applying it per band or across bands based on reducer input.\u003c/p\u003e\n"],["\u003cp\u003eOutput band names are determined by the reducer's output names, sometimes preserving, prefixing, or directly using them.\u003c/p\u003e\n"],["\u003cp\u003eInput pixel weights are calculated using input mask and fractional output pixel coverage.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ereduceResolution\u003c/code\u003e method takes an image, reducer, and optional parameters for handling large operations, returning a reprojected image.\u003c/p\u003e\n"],["\u003cp\u003eOptional parameters \u003ccode\u003ebestEffort\u003c/code\u003e and \u003ccode\u003emaxPixels\u003c/code\u003e control memory usage and allow for processing large images by adjusting input resolution and pixel combination limits.\u003c/p\u003e\n"]]],[],null,["# ee.Image.reduceResolution\n\nEnables reprojection using the given reducer to combine all input pixels corresponding to each output pixel. If the reducer has a single input, it will be applied separately to each band of the collection; otherwise it must have the same number of inputs as the input image has bands.\n\n\u003cbr /\u003e\n\nThe reducer output names determine the names of the output bands: reducers with multiple inputs will use the output names directly, reducers with a single input and single output will preserve the input band names, and reducers with a single input and multiple outputs will prefix the output name with the input band name (e.g., '10_mean', '10_stdDev', '20_mean', '20_stdDev').\n\nReducer input weights will be the product of the input mask and the fraction of the output pixel covered by the input pixel.\n\n| Usage | Returns |\n|-------------------------------------------------------------------|---------|\n| Image.reduceResolution`(reducer, `*bestEffort* `, `*maxPixels*`)` | Image |\n\n| Argument | Type | Details |\n|---------------|-------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `image` | Image | The input image. |\n| `reducer` | Reducer | The reducer to apply to be used for combining pixels. |\n| `bestEffort` | Boolean, default: false | If using the input at its default resolution would require too many pixels, start with already-reduced input pixels from a pyramid level that allows the operation to succeed. |\n| `maxPixels` | Integer, default: 64 | The maximum number of input pixels to combine for each output pixel. Setting this too large will cause out-of-memory problems. |"]]
