Method: projects.assets.listImages

画像コレクション アセット内の画像を一覧表示します。このメソッドを使用すると、呼び出し元は画像コレクションに時空間フィルタとメタデータ フィルタを適用できます。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。一覧表示する画像コレクション アセットの名前。parent の形式は「projects/*/assets/**」です（例: 「projects/earthengine-legacy/assets/users/[USER]/[ASSET]」）。ユーザー所有のアセットはすべて、プロジェクト「earthengine-legacy」に含まれています（例: 「projects/earthengine-legacy/assets/users/foo/bar」）。その他のアセットはすべてプロジェクト「earthengine-public」に含まれています（例: "projects/earthengine-public/assets/LANDSAT").

認可には、指定されたリソース parent に対する次の IAM の権限が必要です。

  • earthengine.assets.get

クエリ パラメータ

パラメータ
pageSize

integer

ページあたりの結果の最大数。サーバーはリクエストされた数よりも少ないアセットを返すことがあります。指定しない場合、ページサイズのデフォルトは EarthEngineAssetView に依存し、制限の厳しいビューでは上限が高くなります。
pageToken

string

サーバーが返す必要がある結果のページを特定するトークンです。 通常、これは assets.listImages メソッドの前の呼び出しから返された ListImagesResponse.next_page_token の値です。
startTime

string (Timestamp format)

指定されている場合、タイムスタンプがこの値以上（含む）の結果をフィルタします。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

指定されている場合、タイムスタンプがこの値未満の結果のみをフィルタします（除外）。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
region

string

指定されている場合、クエリ領域を定義するジオメトリ。GeoJSON ジオメトリ文字列として指定します（RFC 7946 を参照）。空間の交差は 1 メートルの精度です。
filter

string

指定されている場合は、追加のシンプルなプロパティ フィルタを指定します。
view

enum (EarthEngineAssetView)

レスポンスで返される Image リソースの部分を指定します。未設定の場合、デフォルトはすべてのプロパティを返します。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

EarthEngineService.ListImages に対するレスポンス メッセージ。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "images": [
    {
      object (Image)
    }
  ],
  "nextPageToken": string
}
フィールド
images[]

object (Image)

クエリに一致する画像のリスト。
nextPageToken

string

結果の次のページを取得するためのトークン。 この値を次の assets.listImages メソッド呼び出しの ListImagesRequest.page_token フィールドで渡して、結果の次ページを取得します。

認可スコープ

以下のいずれかの 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

詳細については、OAuth 2.0 Overview をご覧ください。

画像

Earth Engine イメージに関する情報。

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

画像の名前（存在する場合）。name の形式は「projects/*/assets/**」です（例: 「projects/earthengine-legacy/assets/users//」）。これは通常、保存された画像に存在しますが、計算された画像の場合は空の文字列になります。
id

string

画像の ID（存在する場合）。「projects/*/assets/」接頭辞のない name と同等です（例: 「users//」）。これは通常、保存された画像に存在しますが、計算された画像の場合は空の文字列になります。
updateTime

string (Timestamp format)

画像の最終更新日時。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
title

string

アセットのタイトル。
description

string

アセットの説明。
properties

object (Struct format)

画像に関連付けられた Key-Value プロパティ。
startTime

string (Timestamp format)

画像に関連付けられたタイムスタンプ（ある場合）。たとえば、衛星画像が撮影された時刻などです。1 か月または 1 年間の平均値など、期間に対応するアセットの場合、このタイムスタンプはその期間の開始に対応します。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

期間に対応するアセット（1 か月または 1 年間の平均値など）の場合、このタイムスタンプは期間の終了時刻（除く）に対応します。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
geometry

object (Struct format)

画像に関連付けられた空間フットプリント（GeoJSON ジオメトリ オブジェクトとして指定可能）（RFC 7946 を参照）。
bands[]

object (ImageBand)

画像のデータバンドに関する情報。
sizeBytes

string (int64 format)

リーフ アセット（画像など）のサイズ（バイト単位）。通常、保存済み画像の場合はゼロ以外、計算済み画像の場合はゼロにする必要があります。