Annuncio: tutti i progetti non commerciali registrati per l'utilizzo di Earth Engine prima del
15 aprile 2025 devono
verificare l'idoneità non commerciale per mantenere l'accesso a Earth Engine.
Method: projects.locations.videoThumbnails.create
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Crea un ID che può essere utilizzato per eseguire il rendering di un'immagine contenente un'animazione di più immagini di una raccolta.
Questo attributo viene utilizzato in combinazione con GetVideoThumbnailPixels. Una chiamata a videoThumbnails.create fornisce un'espressione e alcune opzioni di output. Il risultato di videoThumbnails.create è un ID che rappresenta un'immagine che è il risultato della valutazione dell'espressione e dell'applicazione di queste opzioni. Successivamente, è possibile effettuare chiamate a GetVideoThumbnailPixels per ottenere un'immagine che mostri tutti gli elementi di una raccolta di immagini, animati dal primo all'ultimo. L'ID sarà valido per un periodo moderato (poche ore).
La richiesta è limitata a 512 x 512 x 100 pixel in totale, per tutte le immagini della raccolta di immagini. Le richieste che superano questi limiti restituiranno un codice di errore 400 (BAD_REQUEST).
Richiesta HTTP
POST https://earthengine.googleapis.com/v1alpha/{parent=projects/*/locations/*}/videoThumbnails
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
parent |
string
Obbligatorio. La posizione principale in cui verrà creata la miniatura del video (ad es. "projects/*").
L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata parent:
earthengine.videothumbnails.create
|
Parametri di query
| Parametri |
workloadTag |
string
Tag fornito dall'utente per monitorare questo calcolo.
|
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di VideoThumbnail.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di VideoThumbnail appena creata.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti 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
Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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)."]]
