Method: projects.assets.getPixels

Busca pixels de um recurso de imagem. Esse método personalizado permite que o autor da chamada solicite um bloco arbitrário de pixels de uma imagem, especificando opcionalmente as bandas e a projeção do mapa. Os dados mascarados ou ausentes serão codificados como zeros.

As solicitações são limitadas a 48 MB de dados descompactados por solicitação, calculados 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).

Se bem-sucedido, o corpo da resposta conterá os dados de pixel solicitados na codificação especificada no campo fileFormat da solicitação.

Solicitação HTTP

POST https://earthengine.googleapis.com/v1/{name=projects/*/assets/**}:getPixels

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

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. O nome do recurso de imagem de onde os pixels serão extraídos. name tem o formato "projects/*/assets/**" (por exemplo, "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). Todos os recursos de propriedade do usuário estão no projeto "earthengine-legacy" (por exemplo, "projects/earthengine-legacy/assets/users/foo/bar"). Todos os outros recursos estão no projeto "earthengine-public" (por exemplo, "projects/earthengine-public/assets/LANDSAT").

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

  • earthengine.assets.get

Corpo da solicitação

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

Representação JSON 
{
  "fileFormat": enum (ImageFileFormat),
  "grid": {
    object (PixelGrid)
  },
  "region": {
    object
  },
  "bandIds": [
    string
  ],
  "visualizationOptions": {
    object (VisualizationOptions)
  },
  "workloadTag": string
}
Campos
fileFormat

enum (ImageFileFormat)

O formato do arquivo de saída em que os valores de pixel serão retornados.
grid

object (PixelGrid)

Parâmetros que descrevem a grade de pixels em que os dados serão buscados. O padrão é a grade de pixels nativa dos dados.
region

object (Struct format)

Se presente, a região dos dados a serem retornados, especificada como um objeto de geometria GeoJSON (consulte RFC 7946). Como a imagem retornada é sempre retangular, a caixa delimitadora da geometria especificada no sistema de coordenadas de saída será usada. Se grid.dimensions também for especificado, a grade será redimensionada para o tamanho solicitado.
bandIds[]

string

Se presente, especifica um conjunto específico de bandas para extrair pixels. As bandas são identificadas por ID, conforme indicado pelo campo id de um proto de ImageBand.
visualizationOptions

object (VisualizationOptions)

Se presente, um conjunto de opções de visualização a serem aplicadas para produzir uma visualização RGB de 8 bits dos dados, em vez de retornar os dados brutos.
workloadTag

string

Tag fornecida pelo usuário para acompanhar esse cálculo.

Corpo da resposta

Se for bem-sucedida, a resposta será uma resposta HTTP genérica que tem o formato definido pelo método.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/earthengine.readonly
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only

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