Crea un ID che può essere utilizzato per visualizzare un'immagine "miniatura".
Questo attributo viene utilizzato in combinazione con GetThumbnailPixels. Una chiamata a thumbnails.create fornisce un'espressione e alcune opzioni di output. Il risultato di thumbnails.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 GetThumbnailPixels per ottenere i dati dell'immagine per l'intera immagine risultante. L'ID sarà valido per un periodo moderato (poche ore).
Il caso d'uso più comune per questa coppia di endpoint è fornire un'espressione complessa tramite una richiesta POST a thumbnails.create e poi recuperare l'immagine calcolata tramite una richiesta GET a GetThumbnailPixels. Questa procedura in due parti consente un utilizzo in più situazioni rispetto a ComputePixels. In particolare: - il risultato di ComputePixels deve essere simballato per ottenere i byte dell'immagine codificata. Il risultato di GetThumbnailPixels può essere visualizzato direttamente da un browser. - ComputePixels può essere chiamato solo da un utente autorizzato, utilizzando un token OAuth con ambito corretto. thumbnails.create ha la stessa limitazione, ma GetThumbnailPixels può essere richiamato con un URL contenente una chiave API, pertanto gli URL che lo richiamano possono essere utilizzati in modo più ampio.
Il risultato della valutazione dell'espressione deve soddisfare alcuni requisiti ragionevoli per il formato dell'immagine richiesto. In particolare, il formato JPEG o PNG richiede che siano presenti una o tre bande di output e che i valori vengano tagliati se sono al di fuori dell'intervallo 0-255.
La descrizione "miniatura" non implica una limitazione delle dimensioni dell'immagine calcolata: a thumbnails.create/GetThumbnailPixels si applicano le stesse limitazioni di ComputePixels. Le richieste sono limitate a 48 MB di dati non compressi per richiesta, calcolati come prodotto delle dimensioni della richiesta in pixel, del numero di bande di immagini richieste e del numero di byte per pixel per ogni banda. Le richieste sono inoltre limitate a un massimo di 32.000 pixel in entrambe le dimensioni e a un massimo di 1024 bande. 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/*}/thumbnails
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri | |
|---|---|
parent |
Obbligatorio. La raccolta di miniature principale (ad es. "projects/*"). L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata
|
Parametri di query
| Parametri | |
|---|---|
workloadTag |
Tag fornito dall'utente per monitorare questo calcolo. |
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di Thumbnail.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Thumbnail appena creata.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/earthenginehttps://www.googleapis.com/auth/earthengine.readonlyhttps://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/cloud-platform.read-only
Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.