Method: projects.assets.listImages

Hier werden die Bilder in einem Asset für eine Bildsammlung aufgelistet. Mit dieser Methode kann der Aufrufer raumzeitliche und Metadatenfilter auf eine Bildsammlung anwenden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der Name des Bildsammlungs-Assets, das aufgeführt werden soll. parent hat das Format „projects/*/assets/**“ (z.B. "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). Alle vom Nutzer erstellten Assets befinden sich im Projekt „earthengine-legacy“ (z.B. "projects/earthengine-legacy/assets/users/foo/bar"). Alle anderen Assets befinden sich im Projekt „earthengine-public“ (z.B. "projects/earthengine-public/assets/LANDSAT").

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • earthengine.assets.get

Suchparameter

Parameter
pageSize

integer

Die maximale Anzahl von Ergebnissen pro Seite. Der Server gibt möglicherweise weniger Assets zurück, als angefordert. Wenn keine Angabe gemacht wird, hängt die Standardseitengröße von der EarthEngineAssetView ab. Für eingeschränktere Ansichten gelten höhere Limits.
pageToken

string

Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll. Normalerweise ist dies der Wert von ListImagesResponse.next_page_token, der vom vorherigen Aufruf der assets.listImages-Methode zurückgegeben wurde.
startTime

string (Timestamp format)

Wenn vorhanden, werden nur Ergebnisse gefiltert, deren Zeitstempel mindestens diesem Wert entspricht (einschließlich).

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Wenn vorhanden, werden Ergebnisse gefiltert, deren Zeitstempel kleiner als dieser Wert ist (exklusiv).

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
region

string

Falls vorhanden, eine Geometrie, die eine Abfrageregion definiert, angegeben als GeoJSON-Geometriestring (siehe RFC 7946). Die räumliche Überschneidung ist auf einen Meter genau.
filter

string

Gibt gegebenenfalls zusätzliche einfache Property-Filter an.
view

enum (EarthEngineAssetView)

Gibt an, welche Teile der Image-Ressource in der Antwort zurückgegeben werden sollen. Wenn dieser Parameter nicht festgelegt ist, werden standardmäßig alle Properties zurückgegeben.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für EarthEngineService.ListImages

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "images": [
    {
      object (Image)
    }
  ],
  "nextPageToken": string
}
Felder
images[]

object (Image)

Die Liste der Bilder, die mit der Suchanfrage übereinstimmen.
nextPageToken

string

Ein Token, mit dem die nächste Ergebnisseite abgerufen werden kann. Übergeben Sie diesen Wert im Feld ListImagesRequest.page_token im nachfolgenden Aufruf der Methode assets.listImages, um die nächste Ergebnisseite abzurufen.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • 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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

Bild

Informationen zu einem Earth Engine-Bild.

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

string

Der Name des Bildes, falls vorhanden. name hat das Format „projects/*/assets/**“ (z.B. „projects/earthengine-legacy/assets/users//“). Dieser Wert sollte normalerweise für gespeicherte Bilder vorhanden sein, für berechnete Bilder ist er jedoch leer.
id

string

Die ID des Bildes, falls vorhanden. Entspricht name ohne das Präfix „projects/*/assets/“ (z.B. „users//“). Dieser Wert sollte normalerweise für gespeicherte Bilder vorhanden sein, für berechnete Bilder ist er jedoch leer.
updateTime

string (Timestamp format)

Der Zeitpunkt der letzten Änderung des Bilds.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
title

string

Der Titel des Assets.
description

string

Die Beschreibung des Assets.
properties

object (Struct format)

Schlüssel/Wert-Eigenschaften, die mit dem Bild verknüpft sind.
startTime

string (Timestamp format)

Der Zeitstempel, der dem Bild zugeordnet ist, falls vorhanden, z.B. die Uhrzeit, zu der ein Satellitenbild aufgenommen wurde. Bei Assets, die einem bestimmten Zeitraum entsprechen, z. B. Durchschnittswerten über einen Monat oder ein Jahr, entspricht dieser Zeitstempel dem Beginn dieses Zeitraums.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Bei Assets, die einem bestimmten Zeitraum entsprechen, z. B. Durchschnittswerte über einen Monat oder ein Jahr, entspricht dieser Zeitstempel dem Ende dieses Zeitraums (exklusiv).

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
geometry

object (Struct format)

Der räumliche Fußabdruck, der dem Bild zugeordnet ist, falls vorhanden, als GeoJSON-Geometrieobjekt (siehe RFC 7946).
bands[]

object (ImageBand)

Informationen zu den Datenbändern des Bilds.
sizeBytes

string (int64 format)

Die Größe eines untergeordneten Assets (z.B. eines Bilds) in Byte. Für gespeicherte Bilder sollte dieser Wert in der Regel ungleich Null sein, für berechnete Bilder dagegen Null.