公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.ImageCollection.getMapId
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
強制性函式，會透過同步 AJAX 呼叫傳回地圖 ID。
這會將集合鑲嵌成單一圖片，並傳回適合用來建構 Google 地圖疊加層的地圖 ID。
傳回地圖 ID 和選用權杖，可傳遞至 ee.data.getTileUrl 或 ui.Map.addLayer。如果指定了回呼，則為未定義。
| 用量 | 傳回 |
|---|
ImageCollection.getMapId(visParams, callback) | MapId|Object |
| 引數 | 類型 | 詳細資料 |
|---|
這個：imagecollection | ImageCollection | ImageCollection 執行個體。 |
visParams | 物件 (選用) | 視覺化參數。 |
callback | 函式 (選用) | 非同步回呼。如未提供，系統會同步發出呼叫。 |
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eRetrieves a map ID for visualizing an ImageCollection as a single mosaicked image.\u003c/p\u003e\n"],["\u003cp\u003eThis ID can be used to create Google Maps overlays or retrieve tile URLs for the mosaic.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetMapId\u003c/code\u003e can be called synchronously or asynchronously by omitting or providing a callback function, respectively.\u003c/p\u003e\n"],["\u003cp\u003eVisualization parameters can be customized using the optional \u003ccode\u003evisParams\u003c/code\u003e argument.\u003c/p\u003e\n"]]],["This document details the `getMapId` function for ImageCollection, which returns a map ID for creating Google Maps overlays. It mosaics an ImageCollection into a single image. The function can be called synchronously or asynchronously using an optional callback. It accepts visualization parameters (`visParams`) and returns a MapId or an object containing the map ID and token, which can be used with `ee.data.getTileUrl` or `ui.Map.addLayer`. The return will be `undefined` if a callback is specified.\n"],null,["# ee.ImageCollection.getMapId\n\n\u003cbr /\u003e\n\nAn imperative function that returns a map ID via a synchronous AJAX call.\n\n\u003cbr /\u003e\n\nThis mosaics the collection to a single image and return a map ID suitable for building a Google Maps overlay.\n\nReturns returns a map ID and optional token, which may be passed to ee.data.getTileUrl or ui.Map.addLayer. Undefined if a callback was specified.\n\n| Usage | Returns |\n|----------------------------------------------------------|---------------|\n| ImageCollection.getMapId`(`*visParams* `, `*callback*`)` | MapId\\|Object |\n\n| Argument | Type | Details |\n|-------------------------|--------------------|---------------------------------------------------------------------|\n| this: `imagecollection` | ImageCollection | The ImageCollection instance. |\n| `visParams` | Object, optional | The visualization parameters. |\n| `callback` | Function, optional | An async callback. If not supplied, the call is made synchronously. |"]]
