Cria um ID que pode ser usado para renderizar uma imagem de "miniatura".
Ele é usado com thumbnails.getPixels. Uma chamada para thumbnails.create fornece uma expressão e algumas opções de saída. O resultado de thumbnails.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 thumbnails.getPixels podem ser feitas para receber os dados da imagem de todo o resultado. O documento de identificação será válido por um período moderado (algumas horas).
O caso de uso mais comum para esse par de endpoints é fornecer uma expressão complexa por meio de um POST para thumbnails.create e, em seguida, buscar a imagem calculada por um GET para thumbnails.getPixels. Esse processo de duas partes permite o uso em mais situações do que ComputePixels. Em particular: o resultado de ComputePixels precisa ser desempacotado para receber os bytes de imagem codificados. O resultado de thumbnails.getPixels pode ser mostrado diretamente por um navegador. - ComputePixels só pode ser chamado por um usuário autorizado, usando um token OAuth com escopo adequado. thumbnails.create tem a mesma restrição, mas thumbnails.getPixels pode ser invocado com um URL que contém uma chave de API. Assim, os URLs que o invocam podem ser usados de forma mais ampla.
O resultado da avaliação da expressão precisa atender a alguns requisitos razoáveis para o formato de imagem solicitado. Especificamente, o formato JPEG ou PNG exige que haja uma ou três faixas de saída e valores de clipe fora do intervalo de 0 a 255.
A descrição "miniatura" não implica uma restrição no tamanho da imagem computada: as mesmas restrições de ComputePixels se aplicam a thumbnails.create/thumbnails.getPixels. As solicitações são limitadas a 48 MB de dados não compactados por solicitação, computados como o produto das dimensões da solicitação em pixels, o número de bandas de imagem solicitadas e o número de bytes por pixel para cada banda. As solicitações também são limitadas a no máximo 32K pixels em cada dimensão e no máximo 1.024 bandas. 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/v1/{parent=projects/*}/thumbnails
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros | |
|---|---|
parent |
Obrigatório. O pai da coleção de miniaturas (por exemplo, "projects/*"). A autorização requer a seguinte permissão do IAM no recurso especificado
|
Parâmetros de consulta
| Parâmetros | |
|---|---|
workloadTag |
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 Thumbnail.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Thumbnail.
Escopos de autorização
Requer um dos seguintes escopos do 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
Para mais informações, consulte OAuth 2.0 Overview.