Method: projects.image.export

Inicia um processo em lote que calcula uma imagem e grava o resultado em um dos vários destinos.

Solicitação HTTP

POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/image:export

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
project

string

O ID ou número do projeto do Google Cloud Platform que será tratado como o consumidor de serviço para essa solicitação. O formato é projects/{project-id}.

A autorização requer a seguinte permissão do IAM no recurso especificado project:

  • earthengine.exports.create

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "maxPixels": string,
  "grid": {
    object (PixelGrid)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer,

  // Union field export_options can be only one of the following:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of list of possible types for union field export_options.
}
Campos
expression

object (Expression)

Uma expressão que avalia a imagem a ser computada e exportada.

description

string

Um nome legível da tarefa.

maxPixels

string (Int64Value format)

O número máximo de pixels a serem computados e exportados. Essa é uma medida de segurança para evitar que você inicie acidentalmente uma exportação maior do que o esperado. O valor padrão é 1e8 pixels, mas você pode definir o valor explicitamente para aumentar ou diminuir esse limite.

grid

object (PixelGrid)

Parâmetros que descrevem como a imagem calculada por expression precisa ser reprojetada e cortada. Se não estiver presente, a imagem computada completa será retornada na projeção nativa.

requestId

string

Uma string exclusiva usada para detectar solicitações duplicadas. Se mais de uma solicitação for feita pelo mesmo usuário com o mesmo requestId não vazio, apenas uma dessas solicitações poderá iniciar uma operação de longa duração. requestId pode conter os caracteres a..z, A..Z, 0-9 ou '-'. requestId pode ter no máximo 60 caracteres.

workloadTag

string

Rótulo fornecido pelo usuário para acompanhar esse cálculo.

priority

integer

Opcional. A prioridade da tarefa de exportação no projeto. As tarefas de maior prioridade são programadas mais cedo. Precisa ser um número inteiro entre 0 e 9999. O padrão é 100, se não for definido.

Campo de união export_options. Opções que descrevem onde e como armazenar os resultados. export_options pode ser apenas de um dos tipos a seguir:
fileExportOptions

object (ImageFileExportOptions)

Se especificado, configura a exportação como um arquivo.

assetExportOptions

object (ImageAssetExportOptions)

Se especificado, configura a exportação como um recurso do Earth Engine.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/devstorage.full_control

Para mais informações, consulte OAuth 2.0 Overview.

ImageAssetExportOptions

Opções para salvar imagens como recursos do Earth Engine.

Representação JSON
{
  "pyramidingPolicy": enum (PyramidingPolicy),
  "pyramidingPolicyOverrides": {
    string: enum (PyramidingPolicy),
    ...
  },

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
Campos
pyramidingPolicy

enum (PyramidingPolicy)

A política de pirâmide a ser aplicada por padrão a todas as faixas.

pyramidingPolicyOverrides

map (key: string, value: enum (PyramidingPolicy))

Modificações específicas da política de pirâmide por faixa.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Campo de união destination. Onde gravar os resultados. destination pode ser apenas de um dos tipos a seguir:
earthEngineDestination

object (EarthEngineDestination)

Se especificado, configura a exportação para o Earth Engine.