Anúncio: todos os projetos não comerciais registrados para usar o Earth Engine antes de 15 de abril de 2025 precisam verificar a qualificação não comercial para manter o acesso ao Earth Engine.

Esta página foi traduzida pela API Cloud Translation.

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/v1beta/{project=projects/*}/map:export

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

Parâmetros de caminho

Parâmetros

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`

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

Representação JSON
{ "expression": { object (`Expression`) }, "description": string, "tileOptions": { object (`TileOptions`) }, "tileExportOptions": { object (`ImageFileExportOptions`) }, "requestId": string, "workloadTag": string, "priority": integer }

{
  "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 computada 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 do mapa a serem gerados.
`tileExportOptions`	`object (ImageFileExportOptions)` Opções de onde e de que forma exportar os blocos de mapa. No momento, 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, se não for 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 os blocos de mapa de imagem ou vídeo a serem exportados.

Representação JSON

Representação JSON
{ "startZoom": integer, "skipEmpty": boolean, "mapsApiKey": string, "dimensions": { object (`GridDimensions`) }, "stride": integer, "zoomSubset": { object (`ZoomSubset`) }, // Union field `end_zoom_or_scale` can be only one of the following: "endZoom": integer, "scale": number // End of list of possible types for union field `end_zoom_or_scale`. }

{
  "startZoom": integer,
  "skipEmpty": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // Union field end_zoom_or_scale can be only one of the following:
  "endZoom": integer,
  "scale": number
  // End of list of possible types for union field end_zoom_or_scale.
}

Campos
`startZoom`	`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).
`mapsApiKey`	`string` Chave de API opcional da Plataforma Google Maps para o visualizador de blocos de mapa gerados.
`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).
`stride`	`integer` Passo de linha e coluna do bloco. (ExportVideoMap) Define 4 para blocos esparsos (somente WebGL) ou 1 (padrão) para compatibilidade máxima.
`zoomSubset`	`object (ZoomSubset)` Um subconjunto de níveis de zoom para gerar blocos. Só pode ser especificado em uma chamada para `ExportVideoMap`.
Campo de união `end_zoom_or_scale`. O nível de zoom ou escala em que a geração de blocos do mapa vai ser interrompida. É preciso especificar uma das opções. `end_zoom_or_scale` pode ser apenas de um dos tipos a seguir:
`endZoom`	`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 máximo de zoom mais adequado no equador.

ZoomSubset

Um subconjunto de níveis de zoom para gerar blocos (ExportVideoMap). Os subconjuntos de início e de término são valores de precisão dupla, permitindo renderizar um ou mais níveis de zoom 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 (completo) da pirâmide em startZoom/endZoom.

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

Campos

Campos
`start`	`number` Subconjunto inicial do nível de zoom 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 são 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é o subconjunto máximo (se fornecido), mas sem incluí-lo, em uma ordem não especificada, mas determinística.

start

number

Subconjunto inicial do nível de zoom 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 são os primeiros 10% dos blocos no zoom 12 em alguma ordem não especificada, mas determinística.

end