公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.Image.cast
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
將圖片的部分或所有波段轉換為指定型別。
| 用量 | 傳回 |
|---|
Image.cast(bandTypes, bandOrder) | 圖片 |
| 引數 | 類型 | 詳細資料 |
|---|
這個：image | 圖片 | 要投放的圖片。 |
bandTypes | 字典 | 從樂團名稱到樂團類型的字典。類型可以是 PixelTypes 或字串。有效字串為：'int8'、'int16'、'int32'、'int64'、'uint8'、'uint16'、'uint32'、'byte'、'short'、'int'、'long'、'float' 和 'double'。如果 bandTypes 包含輸入圖片中沒有的頻帶，系統會將這些頻帶新增至圖片，並設為透明。如果未指定 bandOrder，系統會依字母順序附加新樂團。 |
bandOrder | 清單，預設值為空值 | 清單，指定結果中的波段順序。如有指定，必須與結果中的完整頻帶清單相符。 |
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eCasts image bands to specified data types like 'int8', 'float', etc., allowing for data type conversions within an image.\u003c/p\u003e\n"],["\u003cp\u003eAccepts a dictionary mapping band names to desired types, enabling selective casting for individual bands.\u003c/p\u003e\n"],["\u003cp\u003eCan introduce new bands with specified types, appending them to the image with optional ordering using the \u003ccode\u003ebandOrder\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eReturns a new Image with the converted bands, preserving the original image unchanged.\u003c/p\u003e\n"]]],["The `Image.cast` function modifies an image by changing the data type of its bands. It takes a dictionary, `bandTypes`, mapping band names to new data types (PixelTypes or strings like 'int8', 'float'). If a specified band is not present in the original image, a transparent band of that type is added. An optional `bandOrder` list defines the sequence of the resulting bands. The function returns the modified `Image`.\n"],null,["# ee.Image.cast\n\nCasts some or all bands of an image to the specified types.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|----------------------------------------|---------|\n| Image.cast`(bandTypes, `*bandOrder*`)` | Image |\n\n| Argument | Type | Details |\n|---------------|---------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `image` | Image | The image to cast. |\n| `bandTypes` | Dictionary | A dictionary from band name to band types. Types can be PixelTypes or strings. The valid strings are: 'int8', 'int16', 'int32', 'int64', 'uint8', 'uint16', 'uint32', 'byte', 'short', 'int', 'long', 'float', and 'double'. If bandTypes includes bands that are not already in the input image, they will be added to the image as transparent bands. If bandOrder isn't also specified, new bands will be appended in alphabetical order. |\n| `bandOrder` | List, default: null | A list specifying the order of the bands in the result. If specified, must match the full list of bands in the result. |"]]
