Method: projects.image.export

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

Solicitação HTTP

POST https://earthengine.googleapis.com/v1/{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 precisa 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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of mutually exclusive fields.
}
Campos
expression

object (Expression)

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

string

Um nome legível da tarefa.
maxPixels

string (Int64Value format)

O número máximo de pixels a serem calculados e exportados. Essa é uma proteção de segurança para evitar que você inicie acidentalmente uma exportação maior do que pretendia. O valor padrão é de 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 calculada 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, caso não esteja definido.
Opções que descrevem onde e como armazenar os resultados. A seguir, uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
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.
Fim dos campos mutuamente exclusivos.

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),
    ...
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of mutually exclusive fields.
}
Campos
pyramidingPolicy

enum (PyramidingPolicy)

A política de piramidação a ser aplicada por padrão a todas as bandas.
pyramidingPolicyOverrides

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

Substituições específicas da política de pirâmide por banda.

Um objeto com uma lista de "key": value pares. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Onde gravar os resultados. A seguir, uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
earthEngineDestination

object (EarthEngineDestination)

Se especificado, configura a exportação para o Earth Engine.
Fim dos campos mutuamente exclusivos.