Method: projects.map.export

Inicia um processo em lote que calcula um mapa em blocos e grava o resultado no Google Cloud Storage.

Solicitação HTTP

POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/map: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 deve ser tratado como o consumidor de serviços 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,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}
Campos
expression

object (Expression)

Uma expressão que avalia a imagem a ser calculada e exportada. Os limites da imagem serão usados para determinar o conjunto de blocos de mapa a serem renderizados. Para controlar a região exportada, recorte a imagem antes da exportação.
description

string

Um nome legível da tarefa.
tileOptions

object (TileOptions)

Opções que descrevem os blocos de mapa a serem gerados.
tileExportOptions

object (ImageFileExportOptions)

Opções de onde e em que formato exportar os blocos de mapa. O Cloud Storage é o único destino aceito para exportações de mapas.
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.

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.

TileOptions

Opções que descrevem blocos de mapa de imagem ou vídeo a serem exportados.

Representação JSON 
{
  "startZoom": integer,
  "minZoom": integer,
  "skipEmpty": boolean,
  "skipEmptyTiles": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "tileDimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "endZoom": integer,
  "maxZoom": integer,
  "scale": number
  // End of mutually exclusive fields.
}
Campos
startZoom

integer

O nível de zoom para começar a gerar blocos de mapa para exportação. Assume zero como padrão.
minZoom
(deprecated)

integer

O nível de zoom para começar a gerar blocos de mapa para exportação. Assume zero como padrão.
skipEmpty

boolean

Se verdadeiro, pule a gravação de blocos de mapa vazios (ou seja, totalmente transparentes).
skipEmptyTiles
(deprecated)

boolean

Se verdadeiro, pule a gravação de blocos de mapa vazios (ou seja, totalmente transparentes).
mapsApiKey

string

Chave de API opcional da Plataforma Google Maps para o visualizador de blocos de mapa gerado.
dimensions

object (GridDimensions)

A largura e a altura dos blocos de vídeo de saída, usados apenas para exportar pirâmides de vídeo em blocos (ExportVideoMap).
tileDimensions
(deprecated)

object (GridDimensions)

A largura e a altura dos blocos de vídeo de saída, usados apenas para exportar pirâmides de vídeo em blocos (ExportVideoMap).
stride

integer

Linha de blocos e coluna. (ExportVideoMap) Defina como 4 para blocos esparsos (somente WebGL) ou 1 (padrão) para máxima compatibilidade.
zoomSubset

object (ZoomSubset)

Um subconjunto de níveis de zoom para gerar blocos. Só pode ser especificado em uma chamada para ExportVideoMap.
O nível de zoom ou a escala em que parar de gerar blocos de mapa para. Um ou outro deles precisa ser especificado. A seguir, uma lista de campos mutuamente exclusivos. No máximo, um dos campos será definido em uma resposta:
endZoom

integer

O nível de zoom para parar de gerar blocos de mapa.
maxZoom
(deprecated)

integer

O nível de zoom para parar de gerar blocos de mapa.
scale

number

A resolução máxima da imagem em metros por pixel. A escala será convertida para o nível de zoom máximo mais adequado no equador.
Fim dos campos mutuamente exclusivos.

ZoomSubset

Um subconjunto de níveis de zoom para gerar blocos (ExportVideoMap). Os subconjuntos de início e fim são valores de precisão dupla, permitindo renderizar um nível de zoom ou níveis de forma incremental. Para renderizar uma pirâmide inteira com um zoom inicial de 12: startZoom=0, endZoom=12, não defina essa mensagem. Para renderizar os níveis 0 a 11 e os primeiros 10% do nível 12: startZoom=0, endZoom=12, subset = {min=0, max=12.1 }. Para renderizar os próximos 10% do nível 12: startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 }. Para renderizar os 80% restantes do nível 12: startZoom=0, endZoom=12, subset = {min=12.2, max=13 }. Além disso, todos os fragmentos de exportação precisam ter o mesmo tamanho de pirâmide (completo) em start/endZoom.

Representação JSON 
{
  "start": number,
  "end": number,
  "min": number,
  "max": number
}
Campos
start

number

Subconjunto de nível de zoom inicial para gerar blocos (ExportVideoMap). Aqui, o subconjunto é um valor de precisão dupla, permitindo renderizar um nível de zoom de forma incremental. Por exemplo, 12,1 é os primeiros 10% dos blocos no zoom 12 em alguma ordem não especificada, mas determinística.
end

number

Subconjunto de nível de zoom final para gerar blocos (ExportVideoMap), permitindo renderizar um nível de zoom de forma incremental, até, mas não incluindo, o subconjunto máximo (se fornecido) em alguma ordem não especificada, mas determinística.
min
(deprecated)

number

Subconjunto de nível de zoom inicial para gerar blocos (ExportVideoMap). Aqui, o subconjunto é um valor de precisão dupla, permitindo renderizar um nível de zoom de forma incremental. Por exemplo, 12,1 é os primeiros 10% dos blocos no zoom 12 em alguma ordem não especificada, mas determinística.
max
(deprecated)

number

Subconjunto de nível de zoom final para gerar blocos (ExportVideoMap), permitindo renderizar um nível de zoom de forma incremental, até, mas não incluindo, o subconjunto máximo (se fornecido) em alguma ordem não especificada, mas determinística.