公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.Dictionary.map
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
將演算法對應至字典。演算法應會採用 2 個引數，也就是現有字典中的鍵和對應的值，並傳回指定鍵的新值。如果演算法傳回空值，系統會捨棄金鑰。
| 用量 | 傳回 |
|---|
Dictionary.map(baseAlgorithm) | 字典 |
| 引數 | 類型 | 詳細資料 |
|---|
這個：dictionary | 字典 | |
baseAlgorithm | 演算法 | |
範例
程式碼編輯器 (JavaScript)
// A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).
var dict = ee.Dictionary({
B1: 182,
B2: 219,
B3: 443
});
/**
* Convert S2 surface reflectance units to native scale.
*/
function scale(key, value) {
return ee.Number(value).divide(1e4);
}
print('S2 surface reflectance in native units', dict.map(scale));
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
})
def scale(key, value):
"""Convert S2 surface reflectance units to native scale."""
return ee.Number(value).divide(1e4)
print('S2 surface reflectance in native units:', dic.map(scale).getInfo())
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003e\u003ccode\u003eDictionary.map()\u003c/code\u003e applies a provided algorithm to each key-value pair in a dictionary, transforming the values based on the algorithm's logic.\u003c/p\u003e\n"],["\u003cp\u003eThe algorithm used by \u003ccode\u003eDictionary.map()\u003c/code\u003e receives a key and its corresponding value as input, and it should return the new value for that key.\u003c/p\u003e\n"],["\u003cp\u003eIf the algorithm returns null for a specific key, that key-value pair will be excluded from the resulting dictionary.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eDictionary.map()\u003c/code\u003e is particularly useful for tasks like data transformation and filtering within dictionaries, offering a concise way to modify values based on custom logic.\u003c/p\u003e\n"],["\u003cp\u003eExample use cases include converting units of measurement within a dataset or selectively removing entries based on certain criteria applied to the key-value pairs.\u003c/p\u003e\n"]]],["The core content details the `map` function for dictionaries. This function applies a user-defined algorithm to each key-value pair within a dictionary. The algorithm takes a key and its corresponding value as input and returns a new value. The `map` function iterates through the dictionary, executes the provided algorithm on each pair, and generates a new dictionary with the updated values. If the algorithm's result is `null`, the key is removed from the resulting dictionary. Examples illustrate this with scaling values in a dictionary.\n"],null,["# ee.Dictionary.map\n\nMap an algorithm over a dictionary. The algorithm is expected to take 2 arguments, a key from the existing dictionary and the value it corresponds to, and return a new value for the given key. If the algorithm returns null, the key is dropped.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------------------------|------------|\n| Dictionary.map`(baseAlgorithm)` | Dictionary |\n\n| Argument | Type | Details |\n|--------------------|------------|---------|\n| this: `dictionary` | Dictionary | |\n| `baseAlgorithm` | Algorithm | |\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\n/**\n * Convert S2 surface reflectance units to native scale.\n */\nfunction scale(key, value) {\n return ee.Number(value).divide(1e4);\n}\n\nprint('S2 surface reflectance in native units', dict.map(scale));\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\n\ndef scale(key, value):\n \"\"\"Convert S2 surface reflectance units to native scale.\"\"\"\n return ee.Number(value).divide(1e4)\n\nprint('S2 surface reflectance in native units:', dic.map(scale).getInfo())\n```"]]
