公告:凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案,都必須
驗證非商業用途資格,才能繼續存取。如未在 2025 年 9 月 26 日前完成驗證,存取權可能會暫停。
ee.Image.sampleRectangle
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
從圖片中擷取矩形像素區域,並以每個頻帶為單位,擷取至 ND 陣列。陣列會以特徵形式傳回,保留與圖片相同的屬性,以及與用於取樣圖片相同的幾何圖形 (或圖片足跡,如果未指定)。每個波段都會在輸入投影中取樣,如果未指定幾何圖形,則會使用足跡取樣。如果是純量頻帶,輸出陣列為 2D。如果是陣列頻帶,輸出陣列為 (2+N)D,其中 N 是原始頻帶的維度數。如果對陣列頻帶取樣,所有陣列的元素數量必須相同。如果頻帶的取樣區域完全遮蓋,且指定了預設陣列值,系統會使用預設陣列值,而非對圖片取樣。
| 用量 | 傳回 |
|---|
Image.sampleRectangle(region, properties, defaultValue, defaultArrayValue) | 功能 |
| 引數 | 類型 | 詳細資料 |
|---|
這個:image | 圖片 | 要取樣的圖片。 |
region | 幾何圖形,預設值:null | 用於對圖片取樣的投影式邊界方塊區域。預設值為每個頻段的涵蓋範圍。 |
properties | 清單,預設值為空值 | 要從樣本圖片複製的屬性。預設為所有非系統屬性。 |
defaultValue | 浮點值,預設值為空值 | 當取樣的像素遭到遮蓋或超出頻帶範圍時,系統會使用的預設值。 |
defaultArrayValue | 陣列,預設值為空值 | 當取樣陣列像素遭到遮蓋或超出頻帶範圍時,使用的預設值。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[],["It extracts a rectangular pixel region from an image into an ND array per band, returning a feature with the same properties and geometry as the input. Bands are sampled in their input projection using a specified region or the image footprint. Output arrays are 2D for scalar bands and (2+N)D for array bands. If a sampled region is entirely masked, a specified default value or array is used. Properties from the image can be copied.\n"]]