ee.Image.paint
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Peint les géométries d'une collection sur une image, en utilisant la valeur de "couleur" donnée pour remplacer les valeurs de chaque bande là où une géométrie couvre l'image (ou, si une largeur de ligne est spécifiée, là où les périmètres le font).
Cet algorithme est le plus adapté à la conversion de données catégorielles des propriétés des entités en pixels dans une image. Si vous souhaitez visualiser une collection, envisagez plutôt d'utiliser FeatureCollection.style, qui accepte les couleurs RVB, alors que cet algorithme est strictement "monochrome" (utilisant des valeurs numériques uniques).
Utilisation | Renvoie |
---|
Image.paint(featureCollection, color, width) | Image |
Argument | Type | Détails |
---|
ceci : image | Image | Image sur laquelle la collection est peinte. |
featureCollection | FeatureCollection | Collection peinte sur l'image. |
color | Objet, valeur par défaut : 0 | Valeur de pixel à peindre dans chaque bande de l'image d'entrée, soit sous la forme d'un nombre qui sera utilisé pour toutes les caractéristiques, soit sous la forme du nom d'une propriété numérique à extraire de chaque caractéristique de la collection. |
width | Objet, valeur par défaut : null | Épaisseur de la ligne, soit sous la forme d'un nombre qui correspond à l'épaisseur de la ligne pour toutes les géométries, soit sous la forme du nom d'une propriété numérique à extraire de chaque entité de la collection. Si aucune valeur n'est spécifiée, les géométries seront remplies au lieu d'être entourées. |
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\u003ePaints geometries from a FeatureCollection onto an image, replacing pixel values with a specified color or property value where geometries overlap.\u003c/p\u003e\n"],["\u003cp\u003eIdeal for converting categorical feature data to image pixels, offering a monochrome visualization.\u003c/p\u003e\n"],["\u003cp\u003eOffers options to fill geometries or outline them using a specified line width, which can be uniform or vary based on feature properties.\u003c/p\u003e\n"],["\u003cp\u003eUses a single color value for all bands of the image, making it suitable for thematic mapping and data representation rather than visual styling.\u003c/p\u003e\n"],["\u003cp\u003eFor visualizing collections with RGB colors and more styling options, FeatureCollection.style is recommended as a more suitable alternative.\u003c/p\u003e\n"]]],[],null,["# ee.Image.paint\n\nPaints the geometries of a collection onto an image, using the given 'color' value to replace each band's values where any geometry covers the image (or, if a line width is specified, where the perimeters do).\n\n\u003cbr /\u003e\n\nThis algorithm is most suitable for converting categorical data from feature properties to pixels in an image; if you wish to visualize a collection, consider using FeatureCollection.style instead, which supports RGB colors whereas this algorithm is strictly 'monochrome' (using single numeric values).\n\n| Usage | Returns |\n|---------------------------------------------------------|---------|\n| Image.paint`(featureCollection, `*color* `, `*width*`)` | Image |\n\n| Argument | Type | Details |\n|---------------------|-----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `image` | Image | The image on which the collection is painted. |\n| `featureCollection` | FeatureCollection | The collection painted onto the image. |\n| `color` | Object, default: 0 | The pixel value to paint into every band of the input image, either as a number which will be used for all features, or the name of a numeric property to take from each feature in the collection. |\n| `width` | Object, default: null | Line width, either as a number which will be the line width for all geometries, or the name of a numeric property to take from each feature in the collection. If unspecified, the geometries will be filled instead of outlined. |"]]