Method: projects.assets.listImages

Lista as imagens em um recurso de coleção de imagens. Esse método permite que o autor da chamada aplique filtros espaciais e temporais e de metadados a uma coleção de imagens.

Solicitação HTTP

GET https://earthengine.googleapis.com/v1alpha/{parent=projects/*/assets/**}:listImages

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome do recurso da coleção de imagens a ser listado. parent 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 parent:

  • earthengine.assets.get

Parâmetros de consulta

Parâmetros
pageSize

integer

O número máximo de resultados por página. O servidor pode retornar menos recursos do que o solicitado. Se não for especificado, o tamanho padrão da página vai depender da EarthEngineAssetView, com limites mais altos para visualizações mais restritivas.
pageToken

string

Um token que identifica a página de resultados que o servidor retornará. Normalmente, esse é o valor de ListImagesResponse.next_page_token retornado da chamada anterior para o método assets.listImages.
startTime

string (Timestamp format)

Se presente, filtra os resultados para aqueles cujo carimbo de data/hora é pelo menos esse valor (inclusive).

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Se presente, filtra os resultados para aqueles cujo carimbo de data/hora é menor que esse valor (exclusivo).

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
region

string

Se presente, uma geometria que define uma região de consulta, especificada como uma string de geometria GeoJSON (consulte RFC 7946). A interseção espacial tem precisão de um metro.
filter

string

Se presente, especifica outros filtros de propriedade simples.
view

enum (EarthEngineAssetView)

Especifica quais partes do recurso Image precisam ser retornadas na resposta. Se não for definido, o padrão será retornar todas as propriedades.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Mensagem de resposta para EarthEngineService.ListImages.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "images": [
    {
      object (Image)
    }
  ],
  "nextPageToken": string
}
Campos
images[]

object (Image)

A lista de imagens que correspondem à consulta.
nextPageToken

string

Um token para recuperar a próxima página de resultados. Transmita esse valor no campo ListImagesRequest.page_token na chamada subsequente para o método assets.listImages para recuperar a próxima página de resultados.

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.

Imagem

Informações sobre uma imagem do Earth Engine.

Representação JSON 
{
  "name": string,
  "id": string,
  "updateTime": string,
  "title": string,
  "description": string,
  "properties": {
    object
  },
  "startTime": string,
  "endTime": string,
  "geometry": {
    object
  },
  "bands": [
    {
      object (ImageBand)
    }
  ],
  "sizeBytes": string
}
Campos
name

string

O nome da imagem, se houver. name tem o formato "projects/*/assets/**" (por exemplo, "projects/earthengine-legacy/assets/users//"). Normalmente, isso está presente em imagens armazenadas, mas será uma string vazia para imagens computadas.
id

string

O ID da imagem, se houver. Equivalente a name sem o prefixo "projects/*/assets/" (por exemplo, "users//"). Normalmente, isso está presente em imagens armazenadas, mas será uma string vazia para imagens computadas.
updateTime

string (Timestamp format)

O horário da última modificação da imagem.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
title

string

Título do recurso.
description

string

A descrição do recurso.
properties

object (Struct format)

Propriedades de chave/valor associadas à imagem.
startTime

string (Timestamp format)

O carimbo de data/hora associado à imagem, se houver, por exemplo, o horário em que uma imagem de satélite foi tirada. Para recursos que correspondem a um intervalo de tempo, como valores médios em um mês ou ano, esse carimbo de data/hora corresponde ao início desse intervalo.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Para recursos que correspondem a um intervalo de tempo, como valores médios em um mês ou ano, esse carimbo de data/hora corresponde ao fim desse intervalo (exclusivo).

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
geometry

object (Struct format)

A pegada espacial associada à imagem, se houver, como um objeto de geometria GeoJSON (consulte RFC 7946).
bands[]

object (ImageBand)

Informações sobre as faixas de dados da imagem.
sizeBytes

string (int64 format)

O tamanho de um recurso de folha (por exemplo, uma imagem) em bytes. Esse valor normalmente não é zero para imagens armazenadas e zero para imagens computadas.