REST Resource: projects.locations.videoThumbnails
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: VideoThumbnail
Thông tin về hình thu nhỏ của video.
Trường |
name |
string
Tên tài nguyên đại diện cho hình thu nhỏ của video, có dạng "projects/*/videoThumbnails/**" (ví dụ: "projects/earthengine-legacy/videoThumbnails/").
|
expression |
object (Expression )
Biểu thức cần tính toán. Phải đánh giá thành ImageCollection.
|
videoOptions |
object (VideoOptions )
Các tuỳ chọn cho ảnh động.
|
fileFormat |
enum (VideoFileFormat )
Mã hoá đầu ra để tạo hình thu nhỏ video. Hiện tại, chúng tôi chỉ hỗ trợ định dạng GIF.
|
grid |
object (PixelGrid )
Lưới pixel không bắt buộc mô tả cách hình ảnh do expression tính toán được chiếu lại và cắt.
|
VideoOptions
Các lựa chọn cơ bản để tạo video.
Biểu diễn dưới dạng JSON |
{
"framesPerSecond": number,
"maxFrames": integer,
"maxPixelsPerFrame": string
} |
Trường |
framesPerSecond |
number
Tốc độ khung hình của video đã xuất. Phải là một giá trị nằm trong khoảng từ 0,1 đến 120. Giá trị mặc định là 5.0.
|
maxFrames |
integer
Số lượng khung hình video tối đa để tính toán và xuất. Đây là biện pháp bảo vệ an toàn để ngăn bạn vô tình bắt đầu một quá trình xuất lớn hơn dự kiến. Giá trị mặc định là 1000 khung hình, nhưng bạn có thể đặt giá trị một cách rõ ràng để tăng hoặc giảm giới hạn này.
|
maxPixelsPerFrame |
string (Int64Value format)
Số pixel tối đa để tính toán và xuất cho mỗi khung hình. Đây là biện pháp bảo vệ an toàn để ngăn bạn vô tình bắt đầu một quá trình xuất lớn hơn dự kiến. Giá trị mặc định là 1e8 pixel, nhưng bạn có thể đặt giá trị một cách rõ ràng để tăng hoặc giảm giới hạn này.
|
Phương thức |
|
Tạo một mã nhận dạng có thể dùng để hiển thị một hình ảnh chứa ảnh động của nhiều hình ảnh trong một bộ sưu tập. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eVideoThumbnail is a resource that allows you to create an animation from an ImageCollection in Earth Engine.\u003c/p\u003e\n"],["\u003cp\u003eIt uses an \u003ccode\u003eexpression\u003c/code\u003e to define the ImageCollection, \u003ccode\u003evideoOptions\u003c/code\u003e for animation settings like frame rate and maximum frames, and \u003ccode\u003efileFormat\u003c/code\u003e to specify the output format (GIF, MP4, or VP9).\u003c/p\u003e\n"],["\u003cp\u003eYou can optionally define a \u003ccode\u003egrid\u003c/code\u003e for reprojection and clipping of the images within the animation.\u003c/p\u003e\n"],["\u003cp\u003eSafety guards like \u003ccode\u003emaxFrames\u003c/code\u003e and \u003ccode\u003emaxPixelsPerFrame\u003c/code\u003e prevent unintentionally large exports by limiting the number of frames and pixels.\u003c/p\u003e\n"]]],["This documentation details creating video thumbnails from image collections. Key information includes: `name` (resource identifier), `expression` (image collection source), `videoOptions` (animation settings), `fileFormat` (output format, GIF currently supported), and `grid` (image reprojection/clipping). `VideoOptions` specify `framesPerSecond`, `maxFrames`, and `maxPixelsPerFrame` to control animation quality and size. Supported video formats are MP4, GIF, and VP9. The `create` method generates an ID to render the video.\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/v1/Expression) }, \"videoOptions\": { object (/earth-engine/reference/rest/v1/projects.locations.videoThumbnails#VideoThumbnail.VideoOptions) }, \"fileFormat\": enum (/earth-engine/reference/rest/v1/projects.locations.videoThumbnails#VideoThumbnail.VideoFileFormat), \"grid\": { object (/earth-engine/reference/rest/v1/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/v1/Expression)`)` The expression to compute. Must evaluate to an ImageCollection. |\n| `videoOptions` | `object (`[VideoOptions](/earth-engine/reference/rest/v1/projects.locations.videoThumbnails#VideoThumbnail.VideoOptions)`)` Options for the animation. |\n| `fileFormat` | `enum (`[VideoFileFormat](/earth-engine/reference/rest/v1/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/v1/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/v1/projects.locations.videoThumbnails/create) | Creates an ID that can be used to render an image containing an animation of multiple images from a collection. |"]]