公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.Image.getThumbURL
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
取得這張圖片的縮圖網址。
傳回縮圖網址，或在指定回呼時傳回未定義。
| 用量 | 傳回 |
|---|
Image.getThumbURL(params, callback) | Object|String |
| 引數 | 類型 | 詳細資料 |
|---|
這個：image | 圖片 | Image 執行個體。 |
params | 物件 | 與 ee.data.getMapId 相同的參數，外加選用參數：
dimensions (數字或以「WIDTHxHEIGHT」格式表示的一組數字) 要算繪的縮圖尺寸上限 (以像素為單位)。如果只傳遞一個數字，系統會將其做為最大值，並透過比例縮放計算其他維度。 |
region 要算繪的圖片地理空間區域，可以是 ee.Geometry、GeoJSON 或緯度/經度點陣列 (E、S、W、N)。如果未設定，預設值為邊界圖片。 |
format (字串) 可以是「png」或「jpg」。 |
|
callback | 函式 (選用) | 選用回呼。如未提供，系統會同步發出呼叫。 |
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eThe \u003ccode\u003eImage.getThumbURL\u003c/code\u003e function retrieves a thumbnail URL for a given image, offering options to customize dimensions, region, and format.\u003c/p\u003e\n"],["\u003cp\u003eThis function accepts parameters similar to \u003ccode\u003eee.data.getMapId\u003c/code\u003e to specify the desired thumbnail characteristics.\u003c/p\u003e\n"],["\u003cp\u003eUsers can provide a callback function for asynchronous execution or receive the URL directly in a synchronous call.\u003c/p\u003e\n"],["\u003cp\u003eThe thumbnail size can be controlled by specifying dimensions, with proportional scaling applied if only one dimension is given.\u003c/p\u003e\n"],["\u003cp\u003eThe region of the image to be included in the thumbnail can be defined using various geometry formats, defaulting to the image bounds if not specified.\u003c/p\u003e\n"]]],[],null,["# ee.Image.getThumbURL\n\n\u003cbr /\u003e\n\nGet a thumbnail URL for this image.\n\n\u003cbr /\u003e\n\nReturns a thumbnail URL, or undefined if a callback was specified.\n\n| Usage | Returns |\n|-------------------------------------------|----------------|\n| Image.getThumbURL`(params, `*callback*`)` | Object\\|String |\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. | | ` format ` (string) Either 'png' or 'jpg'. | |\n| `callback` | Function, optional | An optional callback. If not supplied, the call is made synchronously. |"]]
