公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.Kernel.square
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
產生方形布林值核心。
| 用量 | 傳回 |
|---|
ee.Kernel.square(radius, units, normalize, magnitude) | 核心 |
| 引數 | 類型 | 詳細資料 |
|---|
radius | 浮點值 | 要產生的核心半徑。 |
units | 字串，預設值為「pixels」 | 核心的測量系統 (「像素」或「公尺」)。如果核心是以公尺為單位指定，則會在變更縮放層級時調整大小。 |
normalize | 布林值，預設值為 true | 將核心值正規化為總和為 1。 |
magnitude | 浮點值，預設值為 1 | 將每個值按此金額縮放。 |
範例
程式碼編輯器 (JavaScript)
print('A square kernel', ee.Kernel.square({radius: 3}));
/**
* Output weights matrix (up to 1/100 precision for brevity)
*
* [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]
* [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]
* [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]
* [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]
* [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]
* [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]
* [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]
*/
Python 設定
請參閱
Python 環境頁面，瞭解 Python API 和如何使用 geemap 進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
from pprint import pprint
print('A square kernel:')
pprint(ee.Kernel.square(**{'radius': 3}).getInfo())
# Output weights matrix (up to 1/100 precision for brevity)
# [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]
# [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]
# [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]
# [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]
# [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]
# [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]
# [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eGenerates a square-shaped kernel with a specified radius for use in image processing.\u003c/p\u003e\n"],["\u003cp\u003eThe kernel can be defined in either pixels or meters, with meter-based kernels resizing based on zoom level.\u003c/p\u003e\n"],["\u003cp\u003eKernel values are normalized to sum to 1 by default, ensuring consistent results across different kernel sizes.\u003c/p\u003e\n"],["\u003cp\u003eUsers can control the kernel's magnitude by scaling each value, providing flexibility for various applications.\u003c/p\u003e\n"]]],[],null,["# ee.Kernel.square\n\nGenerates a square-shaped boolean kernel.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------------------------------------------------|---------|\n| `ee.Kernel.square(radius, `*units* `, `*normalize* `, `*magnitude*`)` | Kernel |\n\n| Argument | Type | Details |\n|-------------|---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `radius` | Float | The radius of the kernel to generate. |\n| `units` | String, default: \"pixels\" | The system of measurement for the kernel ('pixels' or 'meters'). If the kernel is specified in meters, it will resize when the zoom-level is changed. |\n| `normalize` | Boolean, default: true | Normalize the kernel values to sum to 1. |\n| `magnitude` | Float, default: 1 | Scale each value by this amount. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\nprint('A square kernel', ee.Kernel.square({radius: 3}));\n\n/**\n * Output weights matrix (up to 1/100 precision for brevity)\n *\n * [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]\n * [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]\n * [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]\n * [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]\n * [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]\n * [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]\n * [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]\n */\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\nfrom pprint import pprint\n\nprint('A square kernel:')\npprint(ee.Kernel.square(**{'radius': 3}).getInfo())\n\n# Output weights matrix (up to 1/100 precision for brevity)\n\n# [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]\n# [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]\n# [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]\n# [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]\n# [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]\n# [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]\n# [0.02, 0.02, 0.02, 0.02, 0.02, 0.02, 0.02]\n```"]]
