公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ui.Chart.image.byRegion
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
從圖片生成圖表。擷取並繪製圖片中一或多個區域的波段值，每個波段都位於不同的序列中。
- X 軸 = 由 xProperty 標記的區域 (預設值：'system:index')
- Y 軸 = 縮減函式輸出內容。
- Series = Band name。
傳回圖表。
| 用量 | 傳回 |
|---|
ui.Chart.image.byRegion(image, regions, reducer, scale, xProperty) | ui.Chart |
| 引數 | 類型 | 詳細資料 |
|---|
image | 圖片 | 要從中擷取波段值的圖片。 |
regions | Feature|FeatureCollection|Geometry|List<Feature>|List<Geometry>，選用 | 要縮減的區域。預設為圖片的足跡。 |
reducer | 縮減函式 (選用) | 產生 Y 軸值的 Reducer。每個頻帶必須傳回單一值。預設為 ee.Reducer.mean()。 |
scale | 號碼 (選填) | 以公尺為單位，與縮減器搭配使用。 |
xProperty | 字串 (選用) | 做為 X 軸上每個區域標籤的屬性。預設值為「system:index」。 |
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eGenerates a chart that visualizes band values within specified regions of an image.\u003c/p\u003e\n"],["\u003cp\u003eCharts display band values on the y-axis, region labels on the x-axis, and separate series for each band.\u003c/p\u003e\n"],["\u003cp\u003eUsers can customize the chart by defining regions, specifying a reducer for calculations, setting a scale, and choosing a property for x-axis labels.\u003c/p\u003e\n"],["\u003cp\u003eThe default reducer is \u003ccode\u003eee.Reducer.mean()\u003c/code\u003e, and the default x-axis property is \u003ccode\u003e'system:index'\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe function returns a \u003ccode\u003eui.Chart\u003c/code\u003e object.\u003c/p\u003e\n"]]],["The core functionality involves creating a chart from an image by extracting and plotting band values from specified regions. Users define `image`, `regions`, `reducer`, `scale`, and `xProperty`. It extracts band values, uses the provided `reducer` to compute a single y-value per band, which are then plotted as separate series. `regions` are labeled on the x-axis, based on the provided `xProperty`. The chart plots the reduced values per band in different regions, returning a `ui.Chart` object.\n"],null,["# ui.Chart.image.byRegion\n\n\u003cbr /\u003e\n\nGenerates a Chart from an image. Extracts and plots band values in one or more regions in the image, with each band in a separate series.\n\n\u003cbr /\u003e\n\n- X-axis = Region labeled by xProperty (default: 'system:index')\n\n- Y-axis = Reducer output.\n\n- Series = Band name.\n\nReturns a chart.\n\n| Usage | Returns |\n|-----------------------------------------------------------------------------------------|----------|\n| `ui.Chart.image.byRegion(image, `*regions* `, `*reducer* `, `*scale* `, `*xProperty*`)` | 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. Defaults to ee.Reducer.mean(). |\n| `scale` | Number, optional | Scale to use with the reducer in meters. |\n| `xProperty` | String, optional | Property to be used as the label for each Region on the x-axis. Defaults to 'system:index'. |"]]
