Method: projects.locations.filmstripThumbnails.create

Creates an ID that can be used to render an image containing multiple images from a collection.

This is used in conjunction with filmstripThumbnails.getPixels. A call to filmstripThumbnails.create provides an expression and some output options. The result of filmstripThumbnails.create is an ID that represents an image that is the result of evaluating that expression and applying those options. Subsequently, calls to filmstripThumbnails.getPixels can be made to get an image showing all of the elements of an ImageCollection, concatenated top-to-bottom or side-to-side. The ID will be valid for a moderate period (a few hours).

The request is limited to 512*512*100 pixels in total, across all Images in the ImageCollection. Requests exceeding these limits will result in an error code of 400 (BAD_REQUEST).

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The parent of the location where the filmstrip thumbnail will be created (e.g., "projects/*").

Authorization requires the following IAM permission on the specified resource parent:

  • earthengine.filmstripthumbnails.create

Query parameters



User supplied tag to track this computation.

Request body

The request body contains an instance of FilmstripThumbnail.

Response body

If successful, the response body contains a newly created instance of FilmstripThumbnail.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.