Method: projects.assets.listImages

Elenca le immagini in un asset raccolta di immagini. Questo metodo consente all'utente chiamante di applicare filtri spaziotemporali e metadati a una raccolta di immagini.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il nome dell'asset raccolta di immagini da elencare. parent sia nel formato "projects/*/assets/**" (ad es. "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). Tutti gli asset di proprietà dell'utente si trovano nel progetto "earthengine-legacy" (ad es. "projects/earthengine-legacy/assets/users/foo/bar"). Tutti gli altri asset si trovano nel progetto "earthengine-public" (ad es. "projects/earthengine-public/assets/LANDSAT").

L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata parent:

  • earthengine.assets.get

Parametri di query

Parametri
pageSize

integer

Il numero massimo di risultati per pagina. Il server potrebbe restituire meno asset rispetto a quelli richiesti. Se non specificato, il valore predefinito per le dimensioni della pagina dipende da EarthEngineAssetView, con limiti più elevati per le visualizzazioni più restrittive.
pageToken

string

Un token che identifica una pagina di risultati che il server deve restituire. In genere, si tratta del valore di ListImagesResponse.next_page_token restituito dalla chiamata precedente al metodo assets.listImages.
startTime

string (Timestamp format)

Se presente, filtra i risultati in base a quelli il cui timestamp è almeno uguale a questo valore (incluso).

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Se presente, filtra i risultati in base a quelli il cui timestamp è inferiore a questo valore (esclusivo).

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
region

string

Se presente, una geometria che definisce una regione di query, specificata come stringa di geometria GeoJSON (vedi RFC 7946). L'intersezione spaziale è precisa al metro.
filter

string

Se presente, specifica altri filtri di proprietà semplici.
view

enum (EarthEngineAssetView)

Specifica quali parti della risorsa Image devono essere restituite nella risposta. Se non viene impostato, il valore predefinito è restituire tutte le proprietà.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per EarthEngineService.ListImages.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "images": [
    {
      object (Image)
    }
  ],
  "nextPageToken": string
}
Campi
images[]

object (Image)

L'elenco di immagini corrispondenti alla query.
nextPageToken

string

Un token per recuperare la pagina di risultati successiva. Passa questo valore nel campo ListImagesRequest.page_token nella chiamata successiva al metodo assets.listImages per recuperare la pagina di risultati successiva.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti 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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

Immagine

Informazioni su un'immagine Earth Engine.

Rappresentazione JSON 
{
  "name": string,
  "id": string,
  "updateTime": string,
  "title": string,
  "description": string,
  "properties": {
    object
  },
  "startTime": string,
  "endTime": string,
  "geometry": {
    object
  },
  "bands": [
    {
      object (ImageBand)
    }
  ],
  "sizeBytes": string
}
Campi
name

string

Il nome dell'immagine, se presente. name sia nel formato "projects/*/assets/**" (ad es. "projects/earthengine-legacy/assets/users//"). In genere, questo valore dovrebbe essere presente per le immagini archiviate, ma sarà una stringa vuota per quelle calcolate.
id

string

L'ID dell'immagine, se presente. Equivalente a name senza il prefisso "projects/*/assets/" (ad es. "users//"). In genere, questo valore dovrebbe essere presente per le immagini archiviate, ma sarà una stringa vuota per quelle calcolate.
updateTime

string (Timestamp format)

L'ora dell'ultima modifica dell'immagine.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
title

string

Il titolo della risorsa.
description

string

La descrizione della risorsa.
properties

object (Struct format)

Proprietà chiave/valore associate all'immagine.
startTime

string (Timestamp format)

Il timestamp associato all'immagine, se presente, ad esempio l'ora in cui è stata acquisita un'immagine satellitare. Per gli asset che corrispondono a un intervallo di tempo, ad esempio i valori medi di un mese o un anno, questo timestamp corrisponde all'inizio dell'intervallo.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Per gli asset che corrispondono a un intervallo di tempo, ad esempio i valori medi di un mese o un anno, questo timestamp corrisponde alla fine dell'intervallo (esclusivo).

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
geometry

object (Struct format)

L'impronta spaziale associata all'immagine, se presente, come oggetto geometrico GeoJSON (vedi RFC 7946).
bands[]

object (ImageBand)

Informazioni sulle bande di dati dell'immagine.
sizeBytes

string (int64 format)

Le dimensioni di un asset a livello inferiore (ad es. un'immagine) in byte. In genere, questo valore non deve essere pari a zero per le immagini memorizzate e a zero per quelle calcolate.