공지사항:
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 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. |"]]