ui.Chart.image.regions
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Génère un graphique à partir d'une image. Extrait et représente la valeur de chaque bande dans une ou plusieurs régions.
- Axe X : bande libellée par xProperty (par défaut, nom de la bande).
- Axe Y = sortie du réducteur.
- Série = Région libellée par seriesProperty (par défaut : "system:index").
Renvoie un graphique.
| Utilisation | Renvoie |
|---|
ui.Chart.image.regions(image, regions, reducer, scale, seriesProperty, xLabels) | ui.Chart |
| Argument | Type | Détails |
|---|
image | Image | Image à partir de laquelle extraire les valeurs des bandes. |
regions | Feature|FeatureCollection|Geometry|List<Feature>|List<Geometry>, facultatif | Régions à réduire. Par défaut, il s'agit de l'empreinte de l'image. |
reducer | Réducteur, facultatif | Réducteur qui génère la ou les valeurs de l'axe Y. Doit renvoyer une seule valeur par bande. |
scale | Nombre, facultatif | Échelle de pixels en mètres. |
seriesProperty | Chaîne, facultative | Propriété à utiliser comme libellé pour chaque région de la légende. La valeur par défaut est "system:index". |
xLabels | List<Object>, facultatif | Liste des libellés utilisés pour les bandes sur l'axe X. Doit comporter le même nombre d'éléments que les bandes d'image. Si elle est omise, les bandes seront étiquetées avec leur nom. Si les libellés sont numériques (par exemple, des longueurs d'onde), l'axe X sera continu. |
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\u003eGenerates a chart visualizing the values of image bands within specified regions, plotted against band labels or custom x-axis labels.\u003c/p\u003e\n"],["\u003cp\u003eUsers can define regions for analysis, the reducer for calculating band values, pixel scale, legend labels, and custom x-axis labels for the chart.\u003c/p\u003e\n"],["\u003cp\u003eThe chart's y-axis represents the reducer output, while the x-axis represents either band names or user-defined labels, and separate series are plotted for each region.\u003c/p\u003e\n"],["\u003cp\u003eThe function accepts an image, regions, a reducer, scale, series property for legend labels, and custom x-axis labels as input parameters.\u003c/p\u003e\n"],["\u003cp\u003eIt outputs a chart object displaying the extracted and plotted band values.\u003c/p\u003e\n"]]],[],null,["# ui.Chart.image.regions\n\n\u003cbr /\u003e\n\nGenerates a Chart from an image. Extracts and plots the value of each band in one or more regions.\n\n\u003cbr /\u003e\n\n- X-axis = Band labeled by xProperty (default: band name).\n\n- Y-axis = Reducer output.\n\n- Series = Region labeled by seriesProperty (default: 'system:index').\n\nReturns a chart.\n\n| Usage | Returns |\n|-----------------------------------------------------------------------------------------------------------|----------|\n| `ui.Chart.image.regions(image, `*regions* `, `*reducer* `, `*scale* `, `*seriesProperty* `, `*xLabels*`)` | ui.Chart |\n\n| Argument | Type | Details |\n|------------------|-----------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `image` | Image | Image to extract band values from. |\n| `regions` | Feature\\|FeatureCollection\\|Geometry\\|List\\\u003cFeature\\\u003e\\|List\\\u003cGeometry\\\u003e, optional | Regions to reduce. Defaults to the image's footprint. |\n| `reducer` | Reducer, optional | Reducer that generates the value(s) for the y-axis. Must return a single value per band. |\n| `scale` | Number, optional | The pixel scale in meters. |\n| `seriesProperty` | String, optional | Property to be used as the label for each region in the legend. Defaults to 'system:index'. |\n| `xLabels` | List\\\u003cObject\\\u003e, optional | A list of labels used for bands on the x-axis. Must have the same number of elements as the image bands. If omitted, bands will be labeled with their names. If the labels are numeric (e.g. wavelengths), x-axis will be continuous. |"]]
