公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ui.Map.onIdle
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
註冊地圖停止移動時觸發的回呼。
傳回可傳遞至 unlisten() 的 ID，用於取消註冊回呼。
| 用量 | 傳回 |
|---|
Map.onIdle(callback) | 字串 |
| 引數 | 類型 | 詳細資料 |
|---|
這個：ui.map | ui.Map | ui.Map 執行個體。 |
callback | 函式 | 地圖閒置時要觸發的回呼。回呼會傳遞兩個參數：包含地圖中心座標的物件 (含有經度、緯度和縮放等級的鍵)，以及地圖小工具本身。 |
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eRegisters a function to be executed when the map stops moving.\u003c/p\u003e\n"],["\u003cp\u003eProvides an ID to remove the registered function later using \u003ccode\u003eunlisten()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe registered function receives the map's center coordinates and the map object itself.\u003c/p\u003e\n"],["\u003cp\u003eThis functionality is accessed through the \u003ccode\u003eonIdle()\u003c/code\u003e method of the \u003ccode\u003eui.Map\u003c/code\u003e instance.\u003c/p\u003e\n"]]],[],null,["# ui.Map.onIdle\n\n\u003cbr /\u003e\n\nRegisters a callback that's fired when the map stops moving.\n\n\u003cbr /\u003e\n\nReturns an ID which can be passed to unlisten() to unregister the callback.\n\n| Usage | Returns |\n|------------------------|---------|\n| Map.onIdle`(callback)` | String |\n\n| Argument | Type | Details |\n|----------------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `ui.map` | ui.Map | The ui.Map instance. |\n| `callback` | Function | The callback to fire when the map becomes idle. The callback is passed two parameters: an object containing the coordinates of the map center (with keys lon, lat, and zoom) and the map widget itself. |"]]
