REST Resource: projects.locations.videoThumbnails
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ressource: VideoThumbnail
Informations sur une miniature de vidéo
Champs |
name |
string
Nom de la ressource représentant la vignette vidéo, au format "projects/*/videoThumbnails/**" (par exemple, "projects/earthengine-legacy/videoThumbnails/").
|
expression |
object (Expression )
Expression à calculer. Doit renvoyer une ImageCollection.
|
videoOptions |
object (VideoOptions )
Options pour l'animation.
|
fileFormat |
enum (VideoFileFormat )
Encodage de sortie dans lequel générer la vignette vidéo générée. Actuellement, seul le format GIF est accepté.
|
grid |
object (PixelGrid )
Grille de pixels facultative décrivant comment les images calculées par expression sont reprojetées et rognées.
|
VideoOptions
Options de base pour générer des vidéos.
Représentation JSON |
{
"framesPerSecond": number,
"maxFrames": integer,
"maxPixelsPerFrame": string
} |
Champs |
framesPerSecond |
number
Fréquence d'images de la vidéo exportée. La valeur doit être comprise entre 0,1 et 120. La valeur par défaut est 5,0.
|
maxFrames |
integer
Nombre maximal de frames vidéo à calculer et à exporter. Il s'agit d'une mesure de sécurité qui vous empêche de lancer accidentellement une exportation plus importante que celle que vous aviez prévue. La valeur par défaut est de 1 000 frames, mais vous pouvez définir la valeur explicitement pour augmenter ou réduire cette limite.
|
maxPixelsPerFrame |
string (Int64Value format)
Nombre maximal de pixels à calculer et à exporter par image. Il s'agit d'une mesure de sécurité qui vous empêche de lancer accidentellement une exportation plus importante que celle que vous aviez prévue. La valeur par défaut est de 1 e8 pixels, mais vous pouvez définir la valeur explicitement pour augmenter ou réduire cette limite.
|
Méthodes |
|
Crée un ID permettant d'afficher une image contenant une animation de plusieurs images d'une collection. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\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. |"]]