Method: projects.assets.listImages

Wyświetla listę obrazów w komponencie kolekcji obrazów. Ta metoda umożliwia wywołującemu zastosowanie do zbioru obrazów filtrów czasoprzestrzennych i związanych z metadanymi.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagany. Nazwa zasobu kolekcji obrazów do wyświetlenia na liście. parent ma format „projekty/*/zasobniki/*” (np. "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). Wszystkie zasoby należące do użytkowników znajdują się w projekcie „earthengine-legacy” (np. "projects/earthengine-legacy/assets/users/foo/bar"). Wszystkie pozostałe zasoby znajdują się w projekcie „earthengine-public” (np. "projects/earthengine-public/assets/LANDSAT").

Autoryzacja wymaga tych uprawnień IAM w przypadku określonego zasobu: parent

  • earthengine.assets.get

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba wyników na stronie. Serwer może zwrócić mniej komponentów niż żądana liczba. Jeśli nie zostanie określony, domyślny rozmiar strony zależy od EarthEngineAssetView, przy czym w przypadku bardziej restrykcyjnych widoków limity są wyższe.
pageToken

string

Token identyfikujący stronę wyników, którą serwer powinien zwrócić. Zwykle jest to wartość ListImagesResponse.next_page_token zwrócona z poprzedniego wywołania metody assets.listImages.
startTime

string (Timestamp format)

Jeśli jest obecny, filtruje wyniki tak, aby zawierały tylko te, których sygnatura czasowa jest co najmniej równa podanej wartości (włącznie).

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Jeśli jest obecny, filtruje wyniki tak, aby zawierały tylko te, których sygnatura czasowa jest mniejsza od tej wartości (nie wliczając jej).

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
region

string

W razie wystąpienia geometria określająca region zapytania, podana jako ciąg znaków geometrii GeoJSON (patrz RFC 7946). Przecięcie przestrzenne jest dokładne do 1 metra.
filter

string

W razie potrzeby określa dodatkowe proste filtry właściwości.
view

enum (EarthEngineAssetView)

Określa, które części zasobu Image powinny być zwracane w odpowiedzi. Jeśli nie określisz tego ustawienia, domyślnie zwracane są wszystkie usługi.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź dla EarthEngineService.ListImages.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "images": [
    {
      object (Image)
    }
  ],
  "nextPageToken": string
}
Pola
images[]

object (Image)

Lista obrazów pasujących do zapytania.
nextPageToken

string

Token do pobierania następnej strony wyników. Aby pobrać kolejną stronę wyników, prześlij tę wartość w polu ListImagesRequest.page_token w kolejnych wywołaniach metody assets.listImages.

Zakresy autoryzacji

Wymaga jednego z tych zakresów 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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

Obraz

Informacje o obrazie Earth Engine.

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

string

nazwę obrazu (jeśli występuje). name ma format „projects/*/assets/**” (np. „projects/earthengine-legacy/assets/users//”). W przypadku zapisanych obrazów powinien on być obecny, ale w przypadku obrazów obliczanych będzie to pusty ciąg znaków.
id

string

Identyfikator obrazu (jeśli występuje). Odpowiednik name bez prefiksu „projects/*/assets/” (np. „users//”). W przypadku zapisanych obrazów powinien on być obecny, ale w przypadku obrazów obliczanych będzie to pusty ciąg znaków.
updateTime

string (Timestamp format)

Czas ostatniej modyfikacji obrazu.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
title

string

Tytuł zasobu.
description

string

Opis zasobu.
properties

object (Struct format)

Właściwości klucz-wartość powiązane z obrazem.
startTime

string (Timestamp format)

Sygnatura czasowa powiązana z obrazem (jeśli występuje), np. czas wykonania zdjęcia satelitarnego. W przypadku zasobów odpowiadających intervalom czasowym, np. średnich wartości w ciągu miesiąca lub roku, ten znacznik czasu odpowiada początkowi tego przedziału.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

W przypadku zasobów odpowiadających intervalom czasowym, np. średnich wartości z miesiąca lub roku, ta sygnatura czasowa odpowiada końcowi tego przedziału (nie licząc go).

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
geometry

object (Struct format)

Ślad przestrzenny powiązany z obrazem (jeśli występuje) jako obiekt geometrii GeoJSON (patrz RFC 7946).
bands[]

object (ImageBand)

Informacje o pasmach danych obrazu.
sizeBytes

string (int64 format)

Rozmiar zasobu typu liść (np. obrazu) w bajtach. W przypadku zapisanych obrazów wartość ta powinna być różna od 0, a w przypadku obliczonych – równa 0.