REST Resource: projects.locations.videoThumbnails
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zasób: VideoThumbnail
Informacje o miniaturze filmu.
| Pola |
name |
string
Nazwa zasobu reprezentująca miniaturę filmu w formacie „projects/*/videoThumbnails/**” (np. „projects/earthengine-legacy/videoThumbnails/”).
|
expression |
object (Expression)
Wyrażenie do obliczenia. Musi być oceniany jako ImageCollection.
|
videoOptions |
object (VideoOptions)
Opcje animacji.
|
fileFormat |
enum (VideoFileFormat)
Kodowanie wyjściowe, w którym ma zostać wygenerowana miniatura filmu. Obecnie obsługiwany jest tylko format GIF.
|
grid |
object (PixelGrid)
Opcjonalna siatka pikseli określająca, jak obrazy obliczone przez funkcję expression są przeprojektowane i przycięte.
|
VideoOptions
Podstawowe opcje generowania filmów.
| Zapis JSON |
{
"framesPerSecond": number,
"maxFrames": integer,
"maxPixelsPerFrame": string
} |
| Pola |
framesPerSecond |
number
Liczba klatek wyeksportowanego filmu. Musisz podać wartość z zakresu od 0,1 do 120. Domyślna wartość to 5,0.
|
maxFrames |
integer
Maksymalna liczba klatek wideo do obliczenia i wyeksportowania. To zabezpieczenie zapobiega przypadkowemu rozpoczęciu eksportu większego niż zamierzonego. Wartość domyślna to 1000 ramek, ale możesz ją zwiększyć lub zmniejszyć.
|
maxPixelsPerFrame |
string (Int64Value format)
Maksymalna liczba pikseli do obliczenia i wyeksportowania na klatkę. To zabezpieczenie zapobiega przypadkowemu rozpoczęciu eksportu większego niż zamierzonego. Wartość domyślna to 1 × 108 pixeli, ale możesz ją zwiększyć lub zmniejszyć.
|
Metody |
|
|
Tworzy identyfikator, który można wykorzystać do wyrenderowania obrazu zawierającego animację złożoną z kilku obrazów z kolekcji. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]
