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.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

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`

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

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.

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

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 }

{
  "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.

Method: projects.assets.listImages Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.