公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.Dictionary.toImage
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
：從字典中的值建立常數映像檔。系統會根據名稱引數排序及命名圖片的波段。如未指定名稱，頻帶會依英數順序排序。
| 用量 | 傳回 |
|---|
Dictionary.toImage(names) | 圖片 |
| 引數 | 類型 | 詳細資料 |
|---|
這個：dictionary | 字典 | 要轉換的字典。 |
names | 清單，預設值為空值 | 輸出頻帶的順序。 |
範例
程式碼編輯器 (JavaScript)
// A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).
var dict = ee.Dictionary({
B1: 182,
B2: 219,
B3: 443
});
var selectedKeysImg = dict.toImage(['B1', 'B2']);
print('Selected keys image band names', selectedKeysImg.bandNames());
var allKeysImg = dict.toImage();
print('All keys image band names', allKeysImg.bandNames());
Python 設定
請參閱
Python 環境頁面，瞭解 Python API 和如何使用 geemap 進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
# A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).
dic = ee.Dictionary({
'B1': 182,
'B2': 219,
'B3': 443
})
selected_keys_img = dic.toImage(['B1', 'B2'])
print('Selected keys image band names:',
selected_keys_img.bandNames().getInfo())
all_keys_img = dic.toImage()
print('All keys image band names:', all_keys_img.bandNames().getInfo())
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eThe \u003ccode\u003eDictionary.toImage()\u003c/code\u003e function transforms a dictionary of values into an image where each key represents a band.\u003c/p\u003e\n"],["\u003cp\u003eBand order in the output image can be customized using the optional \u003ccode\u003enames\u003c/code\u003e argument, otherwise, keys are sorted alphanumerically.\u003c/p\u003e\n"],["\u003cp\u003eThis function is useful for visualizing dictionary data, such as results from \u003ccode\u003eee.Image.reduceRegion\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eUsage involves calling \u003ccode\u003etoImage()\u003c/code\u003e on a dictionary object, optionally providing a list of band names for desired ordering.\u003c/p\u003e\n"]]],[],null,["# ee.Dictionary.toImage\n\nCreates an image of constants from values in a dictionary. The bands of the image are ordered and named according to the names argument. If no names are specified, the bands are sorted alpha-numerically.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------------------------|---------|\n| Dictionary.toImage`(`*names*`)` | Image |\n\n| Argument | Type | Details |\n|--------------------|---------------------|--------------------------------|\n| this: `dictionary` | Dictionary | The dictionary to convert. |\n| `names` | List, default: null | The order of the output bands. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).\nvar dict = ee.Dictionary({\n B1: 182,\n B2: 219,\n B3: 443\n});\n\nvar selectedKeysImg = dict.toImage(['B1', 'B2']);\nprint('Selected keys image band names', selectedKeysImg.bandNames());\n\nvar allKeysImg = dict.toImage();\nprint('All keys image band names', allKeysImg.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 dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).\ndic = ee.Dictionary({\n 'B1': 182,\n 'B2': 219,\n 'B3': 443\n})\n\nselected_keys_img = dic.toImage(['B1', 'B2'])\nprint('Selected keys image band names:',\n selected_keys_img.bandNames().getInfo())\n\nall_keys_img = dic.toImage()\nprint('All keys image band names:', all_keys_img.bandNames().getInfo())\n```"]]
