公告：所有在
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 | 列表，默认值：null | 一个列表，用于指定结果中波段的顺序。如果指定，则必须与结果中的完整频段列表相匹配。 |
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-26。
[null,null,["最后更新时间 (UTC)：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. |"]]
