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 פיקסלים, אבל אפשר להגדיר את הערך באופן מפורש כדי להגדיל או להקטין את המגבלה הזו.
|
Methods |
|
|
יצירת מזהה שאפשר להשתמש בו כדי ליצור תמונה שמכילה אנימציה של כמה תמונות מאוסף. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת 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. |"]]
