공지사항:
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
계산 및 내보낼 최대 동영상 프레임 수입니다. 이는 의도한 것보다 더 큰 내보내기를 실수로 시작하지 못하도록 하는 안전 장치입니다. 기본값은 1, 000프레임이지만 이 한도를 높이거나 낮추도록 값을 명시적으로 설정할 수 있습니다.
|
maxPixelsPerFrame |
string (Int64Value format)
프레임당 계산하고 내보낼 최대 픽셀 수입니다. 이는 의도한 것보다 더 큰 내보내기를 실수로 시작하지 못하도록 하는 안전 장치입니다. 기본값은 1e8픽셀이지만 이 한도를 높이거나 낮추려면 값을 명시적으로 설정하면 됩니다.
|
메서드 |
|
컬렉션의 여러 이미지 애니메이션이 포함된 이미지를 렌더링하는 데 사용할 수 있는 ID를 만듭니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 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. |"]]