公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.Image.directionalDistanceTransform
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
針對來源中的每個零值像素，取得指定方向中與最近非零值像素的距離。
傳回稱為「距離」的浮點距離頻帶。
| 用量 | 傳回 |
|---|
Image.directionalDistanceTransform(angle, maxDistance, labelBand) | 圖片 |
| 引數 | 類型 | 詳細資料 |
|---|
這個：source | 圖片 | 來源圖片。 |
angle | 浮點值 | 以度為單位的角度，用於搜尋非零像素。 |
maxDistance | 整數 | 搜尋距離上限 (以像素為單位)。 |
labelBand | 字串，預設值為空值 | 如果提供多頻輸入，系統會允許並只使用這個頻段進行搜尋。系統會傳回所有其他波段，並填入標籤波段中搜尋到的非零像素值。 |
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eCalculates the distance from each zero-valued pixel to the nearest non-zero pixel in a specified direction.\u003c/p\u003e\n"],["\u003cp\u003eReturns a single-band image ("distance") containing these calculated distances as floating point values.\u003c/p\u003e\n"],["\u003cp\u003eAllows specifying the search angle, maximum search distance, and an optional label band for multi-band images.\u003c/p\u003e\n"]]],["The `directionalDistanceTransform` function calculates the distance from each zero-valued pixel in a source image to the nearest non-zero pixel along a specified angle. It returns an image containing these floating-point distances. The search is performed up to a maximum distance. Optionally, a specific band can be defined as the target for the search, while preserving the other bands with the values found at searched pixel locations.\n"],null,["# ee.Image.directionalDistanceTransform\n\nFor each zero-valued pixel in the source, get the distance to the nearest non-zero pixels in the given direction.\n\n\u003cbr /\u003e\n\nReturns a band of floating point distances called \"distance\".\n\n| Usage | Returns |\n|-------------------------------------------------------------------------|---------|\n| Image.directionalDistanceTransform`(angle, maxDistance, `*labelBand*`)` | Image |\n\n| Argument | Type | Details |\n|----------------|-----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `source` | Image | The source image. |\n| `angle` | Float | The angle, in degrees, at which to search for non-zero pixels. |\n| `maxDistance` | Integer | The maximum distance, in pixels, over which to search. |\n| `labelBand` | String, default: null | If provided, multi-band inputs are permitted and only this band is used for searching. All other bands are returned and populated with the per-band values found at the searched non-zero pixels in the label band. |"]]
