公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.Image.getThumbId
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
套用轉換並傳回 thumbId。
傳回縮圖 ID 和選用權杖，如指定回呼則傳回空值。
| 用量 | 傳回 |
|---|
Image.getThumbId(params, callback) | ThumbnailId |
| 引數 | 類型 | 詳細資料 |
|---|
這個：image | 圖片 | Image 執行個體。 |
params | 物件 | 與 ee.data.getMapId 相同的參數，外加選用參數：
dimensions (數字或以「WIDTHxHEIGHT」格式表示的一組數字) 要算繪的縮圖尺寸上限 (以像素為單位)。如果只傳遞一個數字，系統會將其做為最大值，並透過比例縮放計算其他維度。 |
region 要算繪的圖片地理空間區域，可以是 ee.Geometry、GeoJSON 或緯度/經度點陣列 (E、S、W、N)。如果未設定，預設值為邊界圖片。 |
|
callback | 函式 (選用) | 選用回呼。如未提供，系統會同步發出呼叫。 |
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003e\u003ccode\u003eImage.getThumbId\u003c/code\u003e applies transformations to an image and returns a thumbnail ID.\u003c/p\u003e\n"],["\u003cp\u003eIt can return the thumbnail ID synchronously or asynchronously via an optional callback function.\u003c/p\u003e\n"],["\u003cp\u003eUsers can specify dimensions and region to customize the thumbnail generation using the \u003ccode\u003eparams\u003c/code\u003e argument.\u003c/p\u003e\n"]]],["The `Image.getThumbId` function retrieves a thumbnail ID. It accepts `params`, an object that defines thumbnail properties like `dimensions` (specifying maximum pixel width and height) and `region` (a geospatial area to render). The function can optionally take a `callback` for asynchronous operation. It returns a `ThumbnailId`, and if a callback is provided, it returns null. If no callback is passed the function executes synchronously. The function operates on an `Image` instance.\n"],null,["# ee.Image.getThumbId\n\n\u003cbr /\u003e\n\nApplies transformations and returns the thumbId.\n\n\u003cbr /\u003e\n\nReturns the thumb ID and optional token, or null if a callback is specified.\n\n| Usage | Returns |\n|------------------------------------------|-------------|\n| Image.getThumbId`(params, `*callback*`)` | ThumbnailId |\n\n| Argument | Type | Details |\n|---------------|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `image` | Image | The Image instance. |\n| `params` | Object | Parameters identical to ee.data.getMapId, plus, optionally: |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` dimensions ` (a number or pair of numbers in format WIDTHxHEIGHT) Maximum dimensions of the thumbnail to render, in pixels. If only one number is passed, it is used as the maximum, and the other dimension is computed by proportional scaling. | | ` region ` Geospatial region of the image to render, it may be an ee.Geometry, GeoJSON, or an array of lat/lon points (E,S,W,N). If not set the default is the bounds image. | |\n| `callback` | Function, optional | An optional callback. If not supplied, the call is made synchronously. |"]]
