公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
Method: projects.locations.filmstripThumbnails.create
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
建立可用於算繪包含多個圖片集的圖片的 ID。
此選項會與 GetFilmstripThumbnailPixels 搭配使用。呼叫 filmstripThumbnails.create 會提供運算式和一些輸出選項。filmstripThumbnails.create 的結果是代表圖片的 ID，該 ID 是評估該運算式並套用這些選項的結果。接著，您可以呼叫 GetFilmstripThumbnailPixels，取得顯示 ImageCollection 所有元素的圖片，並以從上到下或從左到右的方式串連。ID 的有效時間為數小時。
在 ImageCollection 中，所有圖片的總像素數量上限為 512 x 512 x 100。如果要求超出這些限制，就會傳回 400 (BAD_REQUEST) 錯誤代碼。
HTTP 要求
POST https://earthengine.googleapis.com/v1beta/{parent=projects/*/locations/*}/filmstripThumbnails
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 |
parent |
string
必要欄位。要建立幻燈片縮圖的位置的父項 (例如「projects/*」)。
授權需要指定資源 parent 的下列 IAM 權限：
earthengine.filmstripthumbnails.create
|
查詢參數
| 參數 |
workloadTag |
string
使用者提供的用於追蹤這項運算的代碼。
|
回應主體
如果成功，回應主體會包含新建立的 FilmstripThumbnail 例項。
授權範圍
需要下列其中一種 OAuth 範圍：
https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/earthengine.readonly
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/cloud-platform.read-only
詳情請參閱 OAuth 2.0 Overview。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eCreates a unique ID for rendering a single image composed of multiple images from an ImageCollection, stitched together.\u003c/p\u003e\n"],["\u003cp\u003eThis ID, generated using an expression and output options, can be used with \u003ccode\u003eGetFilmstripThumbnailPixels\u003c/code\u003e to retrieve the composite image.\u003c/p\u003e\n"],["\u003cp\u003eThe generated image is limited to a total size of 512x512x100 pixels across all images in the collection, exceeding which results in an error.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specific IAM permission (\u003ccode\u003eearthengine.filmstripthumbnails.create\u003c/code\u003e) on the parent resource for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.filmstripThumbnails.create\n\nCreates an ID that can be used to render an image containing multiple images from a collection.\n\nThis is used in conjunction with `GetFilmstripThumbnailPixels`. A call to `filmstripThumbnails.create` provides an expression and some output options. The result of `filmstripThumbnails.create` is an ID that represents an image that is the result of evaluating that expression and applying those options. Subsequently, calls to `GetFilmstripThumbnailPixels` can be made to get an image showing all of the elements of an ImageCollection, concatenated top-to-bottom or side-to-side. The ID will be valid for a moderate period (a few hours).\n\nThe request is limited to 512\\*512\\*100 pixels in total, across all Images in the ImageCollection. Requests exceeding these limits will result in an error code of 400 (BAD_REQUEST).\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1beta/{parent=projects/*/locations/*}/filmstripThumbnails`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent of the location where the filmstrip thumbnail will be created (e.g., \"projects/\\*\"). Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `parent`: - `earthengine.filmstripthumbnails.create` |\n\n### Query parameters\n\n| Parameters ||\n|---------------|-------------------------------------------------------|\n| `workloadTag` | `string` User supplied tag to track this computation. |\n\n### Request body\n\nThe request body contains an instance of [FilmstripThumbnail](/earth-engine/reference/rest/v1beta/projects.filmstripThumbnails#FilmstripThumbnail).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [FilmstripThumbnail](/earth-engine/reference/rest/v1beta/projects.filmstripThumbnails#FilmstripThumbnail).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/earthengine.readonly`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/cloud-platform.read-only`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
