Anuncio: Todos los proyectos no comerciales registrados para usar Earth Engine antes del
15 de abril de 2025 deben
verificar su elegibilidad no comercial para mantener el acceso a Earth Engine.
REST Resource: projects.locations.videoThumbnails
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Recurso: VideoThumbnail
Información sobre la miniatura de un video.
| Campos |
name |
string
Es el nombre del recurso que representa la miniatura del video, con el formato "projects/*/videoThumbnails/**" (p.ej., "projects/earthengine-legacy/videoThumbnails/").
|
expression |
object (Expression)
La expresión que se debe calcular. Debe evaluarse como ImageCollection.
|
videoOptions |
object (VideoOptions)
Son las opciones de la animación.
|
fileFormat |
enum (VideoFileFormat)
Es la codificación de salida en la que se generará la miniatura del video resultante. Actualmente, solo se admite GIF.
|
grid |
object (PixelGrid)
Es una cuadrícula de píxeles opcional que describe cómo se vuelven a proyectar y recortan las imágenes que calcula expression.
|
VideoOptions
Opciones básicas para generar videos.
| Representación JSON |
{
"framesPerSecond": number,
"maxFrames": integer,
"maxPixelsPerFrame": string
} |
| Campos |
framesPerSecond |
number
Es la velocidad de fotogramas del video exportado. Debe ser un valor entre 0.1 y 120. El valor predeterminado es 5.0.
|
maxFrames |
integer
Es la cantidad máxima de fotogramas de video que se deben procesar y exportar. Esta es una medida de seguridad para evitar que inicies accidentalmente una exportación más grande de lo que deseas. El valor predeterminado es de 1,000 fotogramas, pero puedes establecer el valor de forma explícita para aumentar o disminuir este límite.
|
maxPixelsPerFrame |
string (Int64Value format)
Es la cantidad máxima de píxeles que se deben calcular y exportar por fotograma. Esta es una medida de seguridad para evitar que inicies accidentalmente una exportación más grande de lo que deseas. El valor predeterminado es de 1e8 píxeles, pero puedes establecer el valor de forma explícita para aumentar o disminuir este límite.
|
Métodos |
|
|
Crea un ID que se puede usar para renderizar una imagen que contiene una animación de varias imágenes de una colección. |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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. |"]]
