公告:凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案,都必須
驗證非商業用途資格,才能繼續存取 Earth Engine。
REST Resource: projects.locations.videoThumbnails
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
資源:VideoThumbnail
欄位 |
name |
string
代表影片縮圖的資源名稱,格式為「projects/*/videoThumbnails/**」(例如「projects/earthengine-legacy/videoThumbnails/)。
|
expression |
object (Expression )
要計算的運算式。必須評估為 ImageCollection。
|
videoOptions |
object (VideoOptions )
動畫選項。
|
fileFormat |
enum (VideoFileFormat )
用於產生最終影片縮圖的輸出編碼。目前僅支援 GIF。
|
grid |
object (PixelGrid )
選用的像素格線,說明 expression 計算的圖片如何重新投影及裁剪。
|
VideoOptions
JSON 表示法 |
{
"framesPerSecond": number,
"maxFrames": integer,
"maxPixelsPerFrame": string
} |
欄位 |
framesPerSecond |
number
匯出影片的畫面更新率。必須介於 0.1 到 120 之間的值。預設值為 5.0。
|
maxFrames |
integer
要運算及匯出的影片影格數量上限。這項安全防護措施可避免你不小心啟動比預期更大的匯出作業。預設值為 1000 個影格,但您可以明確設定值,提高或降低此限制。
|
maxPixelsPerFrame |
string (Int64Value format)
每個影格可計算及匯出的像素數量上限。這項安全防護措施可避免你不小心啟動比預期更大的匯出作業。預設值為 1e8 像素,但您可以明確設定值,提高或降低此限制。
|
方法 |
|
建立可用於算繪圖片的 ID,其中包含來自集合的多張圖片動畫。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eVideoThumbnail resources represent animated thumbnails generated from Earth Engine image collections.\u003c/p\u003e\n"],["\u003cp\u003eThese thumbnails are customizable with options like frame rate, maximum frames, and output format (GIF is currently supported).\u003c/p\u003e\n"],["\u003cp\u003eVideoThumbnail creation involves specifying an image collection expression, animation options, and an optional pixel grid for reprojection and clipping.\u003c/p\u003e\n"],["\u003cp\u003eUsers can define the expression to compute the image collection, set the video options such as frames per second and maximum frames, and specify the output video format like GIF or MP4.\u003c/p\u003e\n"]]],["This describes video thumbnail creation using a JSON-based configuration. Key actions include defining a `name`, an `expression` that evaluates to an ImageCollection, and `VideoOptions` such as `framesPerSecond`, `maxFrames`, and `maxPixelsPerFrame`. The `fileFormat` (GIF, MP4, VP9) for output and an optional `grid` for image adjustments can also be set. Methods allow creation of an ID to render animated image sequences from image collection, with GIF currently the only supported output.\n"],null,["# REST Resource: projects.locations.videoThumbnails\n\nResource: VideoThumbnail\n------------------------\n\nInformation about a video thumbnail.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"expression\": { object (/earth-engine/reference/rest/v1alpha/Expression) }, \"videoOptions\": { object (/earth-engine/reference/rest/v1alpha/projects.locations.videoThumbnails#VideoThumbnail.VideoOptions) }, \"fileFormat\": enum (/earth-engine/reference/rest/v1alpha/projects.locations.videoThumbnails#VideoThumbnail.VideoFileFormat), \"grid\": { object (/earth-engine/reference/rest/v1alpha/PixelGrid) } } ``` |\n\n| Fields ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The resource name representing the video thumbnail, of the form \"projects/\\*/videoThumbnails/\\*\\*\" (e.g. \"projects/earthengine-legacy/videoThumbnails/\"). |\n| `expression` | `object (`[Expression](/earth-engine/reference/rest/v1alpha/Expression)`)` The expression to compute. Must evaluate to an ImageCollection. |\n| `videoOptions` | `object (`[VideoOptions](/earth-engine/reference/rest/v1alpha/projects.locations.videoThumbnails#VideoThumbnail.VideoOptions)`)` Options for the animation. |\n| `fileFormat` | `enum (`[VideoFileFormat](/earth-engine/reference/rest/v1alpha/projects.locations.videoThumbnails#VideoThumbnail.VideoFileFormat)`)` The output encoding in which to generate the resulting video thumbnail. Currently only GIF is supported. |\n| `grid` | `object (`[PixelGrid](/earth-engine/reference/rest/v1alpha/PixelGrid)`)` An optional pixel grid describing how the images computed by `expression` are reprojected and clipped. |\n\n### VideoOptions\n\nBasic options for generating videos.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------|\n| ``` { \"framesPerSecond\": number, \"maxFrames\": integer, \"maxPixelsPerFrame\": string } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `framesPerSecond` | `number` The frame rate of the exported video. Must be a value between 0.1 and 120. Defaults to 5.0. |\n| `maxFrames` | `integer` The maximum number of video frames to compute and export. This is a safety guard to prevent you from accidentally starting a larger export than you had intended. The default value is 1000 frames, but you can set the value explicitly to raise or lower this limit. |\n| `maxPixelsPerFrame` | `string (`[Int64Value](https://developers.google.com/discovery/v1/type-format)` format)` The maximum number of pixels to compute and export per frame. This is a safety guard to prevent you from accidentally starting a larger export than you had intended. The default value is 1e8 pixels, but you can set the value explicitly to raise or lower this limit. |\n\n### VideoFileFormat\n\nSelects a video file format in which to encode a sequence of images.\n\n| Enums ||\n|---------------------------------|------------------------|\n| `VIDEO_FILE_FORMAT_UNSPECIFIED` | Unspecified. |\n| `MP4` | MPEG-4 Part 14 format. |\n| `GIF` | Animated GIF. |\n| `VP9` | WEBM/VP9 |\n\n| Methods ------- ||\n|----------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------|\n| ### [create](/earth-engine/reference/rest/v1alpha/projects.locations.videoThumbnails/create) | Creates an ID that can be used to render an image containing an animation of multiple images from a collection. |"]]