Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
REST Resource: projects.thumbnails
Stay organized with collections
Save and categorize content based on your preferences.
Resource: Thumbnail
Information about a thumbnail.
| Fields |
name |
string
The resource name representing the thumbnail, of the form "projects/*/thumbnails/**" (e.g. "projects/earthengine-legacy/thumbnails/").
|
expression |
object (Expression)
The expression to compute. Must evaluate to an Image.
|
fileFormat |
enum (ImageFileFormat)
The output encoding in which to generate the resulting image.
|
bandIds[] |
string
If present, specifies a specific set of bands that will be selected from the result of evaluating expression. If not present, all bands resulting from expression will be selected.
|
visualizationOptions |
object (VisualizationOptions)
If present, a set of visualization options to apply to produce an 8-bit RGB visualization of the data.
|
grid |
object (PixelGrid)
An optional pixel grid describing how the image computed by expression is reprojected and clipped.
|
filenamePrefix |
string
Only used when fileFormat is ZIPPED_GEO_TIFF or ZIPPED_GEO_TIFF_PER_BAND.
|
Methods |
|
|
Creates an ID that can be used to render a "thumbnail" image. |
|
|
Computes an image showing the result of a computation. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-06 UTC.
[null,null,["Last updated 2025-03-06 UTC."],[[["\u003cp\u003eThumbnails are generated from an expression that evaluates to an Earth Engine Image.\u003c/p\u003e\n"],["\u003cp\u003eUsers can specify the output format, band selection, visualization options, and pixel grid.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ecreate\u003c/code\u003e method generates a unique ID, while \u003ccode\u003egetPixels\u003c/code\u003e computes and renders the thumbnail image.\u003c/p\u003e\n"],["\u003cp\u003eA thumbnail can be downloaded in various formats including \u003ccode\u003eGEO_TIFF\u003c/code\u003e, \u003ccode\u003eJPEG\u003c/code\u003e, and \u003ccode\u003ePNG\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThumbnails have a resource name format of "projects/*/thumbnails/**".\u003c/p\u003e\n"]]],[],null,["# REST Resource: projects.thumbnails\n\nResource: Thumbnail\n-------------------\n\nInformation about a thumbnail.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"expression\": { object (/earth-engine/reference/rest/v1beta/Expression) }, \"fileFormat\": enum (/earth-engine/reference/rest/v1beta/ImageFileFormat), \"bandIds\": [ string ], \"visualizationOptions\": { object (/earth-engine/reference/rest/v1beta/VisualizationOptions) }, \"grid\": { object (/earth-engine/reference/rest/v1beta/PixelGrid) }, \"filenamePrefix\": string } ``` |\n\n| Fields ||\n|------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The resource name representing the thumbnail, of the form \"projects/\\*/thumbnails/\\*\\*\" (e.g. \"projects/earthengine-legacy/thumbnails/\"). |\n| `expression` | `object (`[Expression](/earth-engine/reference/rest/v1beta/Expression)`)` The expression to compute. Must evaluate to an Image. |\n| `fileFormat` | `enum (`[ImageFileFormat](/earth-engine/reference/rest/v1beta/ImageFileFormat)`)` The output encoding in which to generate the resulting image. |\n| `bandIds[]` | `string` If present, specifies a specific set of bands that will be selected from the result of evaluating `expression`. If not present, all bands resulting from `expression` will be selected. |\n| `visualizationOptions` | `object (`[VisualizationOptions](/earth-engine/reference/rest/v1beta/VisualizationOptions)`)` If present, a set of visualization options to apply to produce an 8-bit RGB visualization of the data. |\n| `grid` | `object (`[PixelGrid](/earth-engine/reference/rest/v1beta/PixelGrid)`)` An optional pixel grid describing how the image computed by `expression` is reprojected and clipped. |\n| `filenamePrefix` | `string` Only used when fileFormat is ZIPPED_GEO_TIFF or ZIPPED_GEO_TIFF_PER_BAND. |\n\n| Methods ------- ||\n|------------------------------------------------------------------------------------|---------------------------------------------------------------|\n| ### [create](/earth-engine/reference/rest/v1beta/projects.thumbnails/create) | Creates an ID that can be used to render a \"thumbnail\" image. |\n| ### [getPixels](/earth-engine/reference/rest/v1beta/projects.thumbnails/getPixels) | Computes an image showing the result of a computation. |"]]