Anúncio: todos os projetos não comerciais registrados para usar o Earth Engine antes de
15 de abril de 2025 precisam
verificar a qualificação não comercial para manter o acesso ao Earth Engine.
Method: projects.locations.videoThumbnails.create
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Cria um ID que pode ser usado para renderizar uma imagem que contém uma animação de várias imagens de uma coleção.
Ele é usado com GetVideoThumbnailPixels. Uma chamada para videoThumbnails.create fornece uma expressão e algumas opções de saída. O resultado de videoThumbnails.create é um ID que representa uma imagem que é o resultado da avaliação dessa expressão e da aplicação dessas opções. Em seguida, as chamadas para GetVideoThumbnailPixels podem ser feitas para receber uma imagem mostrando todos os elementos de uma ImageCollection, animados do primeiro ao último. O documento de identificação será válido por um período moderado (algumas horas).
A solicitação é limitada a 512 x 512 x 100 pixels no total, em todas as imagens da ImageCollection. As solicitações que excederem esses limites resultarão em um código de erro 400 (BAD_REQUEST).
Solicitação HTTP
POST https://earthengine.googleapis.com/v1alpha/{parent=projects/*/locations/*}/videoThumbnails
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros |
parent |
string
Obrigatório. O pai do local em que a miniatura do vídeo será criada (por exemplo, "projects/*").
A autorização requer a seguinte permissão do IAM no recurso especificado parent:
earthengine.videothumbnails.create
|
Parâmetros de consulta
| Parâmetros |
workloadTag |
string
Tag fornecida pelo usuário para acompanhar esse cálculo.
|
Corpo da solicitação
O corpo da solicitação contém uma instância de VideoThumbnail.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de VideoThumbnail.
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/earthengine.readonly
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/cloud-platform.read-only
Para mais informações, consulte OAuth 2.0 Overview.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eGenerates an ID, usable with \u003ccode\u003eGetVideoThumbnailPixels\u003c/code\u003e, to render an animation of images from an ImageCollection.\u003c/p\u003e\n"],["\u003cp\u003eThe created ID represents an image formed by evaluating an expression and applying specified options, animating the ImageCollection's elements.\u003c/p\u003e\n"],["\u003cp\u003eThe total pixel limit for the request is 512*512*100, exceeding which results in a 400 error code.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific IAM permission (\u003ccode\u003eearthengine.videothumbnails.create\u003c/code\u003e) on the parent resource for authorization.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes a POST request to a specified endpoint with path and query parameters to create the video thumbnail.\u003c/p\u003e\n"]]],["`videoThumbnails.create` generates an ID for an animated image from an ImageCollection, using a provided expression and output options. `GetVideoThumbnailPixels` then retrieves the animated image. The ID remains valid for a few hours. The request has a size limit of 512\\*512\\*100 pixels, exceeding this results in a 400 error. A tag is used to track the computation. Authentication requires specific OAuth scopes or IAM permissions on the parent resource.\n"],null,["# Method: projects.locations.videoThumbnails.create\n\nCreates an ID that can be used to render an image containing an animation of multiple images from a collection.\n\nThis is used in conjunction with `GetVideoThumbnailPixels`. A call to `videoThumbnails.create` provides an expression and some output options. The result of `videoThumbnails.create` is an ID that represents an image that is the result of evaluating that expression and applying those options. Subsequently, calls to `GetVideoThumbnailPixels` can be made to get an image showing all of the elements of an ImageCollection, animated from first to last. The ID will be valid for a moderate period (a few hours).\n\nThe 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).\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1alpha/{parent=projects/*/locations/*}/videoThumbnails`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent of the location where the video thumbnail will be created (e.g., \"projects/\\*\"). Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `parent`: - `earthengine.videothumbnails.create` |\n\n### Query parameters\n\n| Parameters ||\n|---------------|-------------------------------------------------------|\n| `workloadTag` | `string` User supplied tag to track this computation. |\n\n### Request body\n\nThe request body contains an instance of [VideoThumbnail](/earth-engine/reference/rest/v1alpha/projects.locations.videoThumbnails#VideoThumbnail).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [VideoThumbnail](/earth-engine/reference/rest/v1alpha/projects.locations.videoThumbnails#VideoThumbnail).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/earthengine.readonly`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/cloud-platform.read-only`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
