公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.Image.rename
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
重新命名圖片的波段。
傳回重新命名的圖片。
| 用量 | 傳回 |
|---|
Image.rename(var_args) | 圖片 |
| 引數 | 類型 | 詳細資料 |
|---|
這個：image | 圖片 | Image 執行個體。 |
var_args | List<String>|Object|VarArgs<String> | 頻段的新名稱。必須與圖片中的頻帶數量相符。 |
範例
程式碼編輯器 (JavaScript)
// A Sentinel-2 surface reflectance image.
var img = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG')
.select(['B11', 'B8', 'B3']);
print('Original selected S2 image band names', img.bandNames());
print('Rename bands using a list (JavaScript array or ee.List)',
img.rename(['SWIR1', 'NIR', 'GREEN']).bandNames());
print('Rename bands using a series of string arguments',
img.rename('swir1', 'nir', 'green').bandNames());
Python 設定
請參閱
Python 環境頁面，瞭解 Python API 和如何使用 geemap 進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
# A Sentinel-2 surface reflectance image.
img = ee.Image(
'COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG'
).select(['B11', 'B8', 'B3'])
print('Original selected S2 image band names:', img.bandNames().getInfo())
print('Rename bands using a list (Python list or ee.List):',
img.rename(['SWIR1', 'NIR', 'GREEN']).bandNames().getInfo())
print('Rename bands using a series of string arguments:',
img.rename('swir1', 'nir', 'green').bandNames().getInfo())
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eThe \u003ccode\u003eImage.rename()\u003c/code\u003e function allows you to change the names of bands in an Earth Engine image.\u003c/p\u003e\n"],["\u003cp\u003eYou can provide new band names as a list or as individual string arguments.\u003c/p\u003e\n"],["\u003cp\u003eThe number of new band names must match the number of bands in the image.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eImage.rename()\u003c/code\u003e returns a new image with the updated band names.\u003c/p\u003e\n"]]],["The core functionality is to rename the bands of an image using the `Image.rename()` method. This method takes either a list or a series of string arguments as new band names. The number of new names provided must match the existing number of bands. The method returns the image with the updated band names. Examples demonstrate renaming bands of a Sentinel-2 image in both JavaScript and Python, using both a list and individual string arguments.\n"],null,["# ee.Image.rename\n\n\u003cbr /\u003e\n\nRename the bands of an image.\n\n\u003cbr /\u003e\n\nReturns the renamed image.\n\n| Usage | Returns |\n|--------------------------|---------|\n| Image.rename`(var_args)` | Image |\n\n| Argument | Type | Details |\n|---------------|-------------------------------------------|---------------------------------------------------------------------------|\n| this: `image` | Image | The Image instance. |\n| `var_args` | List\\\u003cString\\\u003e\\|Object\\|VarArgs\\\u003cString\\\u003e | The new names for the bands. Must match the number of bands in the Image. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A Sentinel-2 surface reflectance image.\nvar img = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG')\n .select(['B11', 'B8', 'B3']);\nprint('Original selected S2 image band names', img.bandNames());\n\nprint('Rename bands using a list (JavaScript array or ee.List)',\n img.rename(['SWIR1', 'NIR', 'GREEN']).bandNames());\n\nprint('Rename bands using a series of string arguments',\n img.rename('swir1', 'nir', 'green').bandNames());\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\n# A Sentinel-2 surface reflectance image.\nimg = ee.Image(\n 'COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG'\n).select(['B11', 'B8', 'B3'])\nprint('Original selected S2 image band names:', img.bandNames().getInfo())\n\nprint('Rename bands using a list (Python list or ee.List):',\n img.rename(['SWIR1', 'NIR', 'GREEN']).bandNames().getInfo())\n\nprint('Rename bands using a series of string arguments:',\n img.rename('swir1', 'nir', 'green').bandNames().getInfo())\n```"]]
