Method: projects.image.import

画像をインポートします。

HTTP リクエスト

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/image:import

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

パスパラメータ

パラメータ
project

string

このリクエストのサービス ユーザーとして扱う必要がある Google Cloud Platform プロジェクトのプロジェクト ID またはプロジェクト番号。形式は projects/{project-id} です。

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

  • earthengine.imports.create

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "imageManifest": {
    object (ImageManifest)
  },
  "description": string,
  "overwrite": boolean,
  "requestId": string
}
フィールド
imageManifest

object (ImageManifest)

イメージ マニフェスト。
description

string

タスクのわかりやすい名前。
overwrite

boolean

既存のアセットを上書きするかどうか。
requestId

string

重複したリクエストを検出するために使用される一意の文字列。同じユーザーが同じ空でない requestId を使用して複数のリクエストを送信した場合、長時間実行オペレーションが正常に開始されるのは、そのうちの 1 つのみです。requestId には、a ～ z、A ～ Z、0 ～ 9、- の文字を使用できます。requestId の最大長は 60 文字です。

レスポンスの本文

成功した場合、レスポンスの本文には Operation のインスタンスが含まれます。

認可スコープ

以下のいずれかの OAuth スコープが必要です。

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform

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

ImageManifest

EarthEngine サービスがファイルのセットから画像を合成する方法について説明します。

JSON 表現 
{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "tilesets": [
    {
      object (Tileset)
    }
  ],
  "bands": [
    {
      object (TilesetBand)
    }
  ],
  "maskBands": [
    {
      object (TilesetMaskBand)
    }
  ],
  "footprint": {
    object (PixelFootprint)
  },
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy),
  "startTime": string,
  "endTime": string,
  "skipMetadataRead": boolean,
  "memo": string
}
フィールド
name

string

作成するアセットの名前。name の形式は「projects/*/assets/**」です（例: 「projects/earthengine-legacy/assets/users//」）。ユーザー所有のアセットはすべて、プロジェクト「earthengine-legacy」に含まれます（例:「projects/earthengine-legacy/assets/users/foo/bar」）。その他のアセットはすべてプロジェクト「earthengine-public」にあります（例:「projects/earthengine-public/assets/LANDSAT」）。
properties

object (Struct format)

アセットの追加プロパティ。プロパティ名「system:time_start」と「system:time_end」は非推奨になりました。代わりに startTime フィールドと endTime フィールドを使用してください。
uriPrefix

string

このマニフェストで定義されているすべての uri に追加される省略可能な接頭辞。
tilesets[]

object (Tileset)

タイルのセット。各タイルマップには一意の ID が必要です。
bands[]

object (TilesetBand)

バンド。アセットのバンド順序は bands の順序と同じです。
maskBands[]

object (TilesetMaskBand)

マスクバンド。
footprint

object (PixelFootprint)

フットプリントのピクセル座標（緯度/経度の座標ではありません）。空の場合、デフォルトのフットプリントはイメージ全体です。ピクセル座標の詳細については、PixelGrid をご覧ください。
missingData

object (MissingData)

画像のすべてのバンドにデータがないことを表す値。独自の missingData を指定していないすべてのバンドに適用されます。
pyramidingPolicy

enum (PyramidingPolicy)

ピラミッド型販売に関するポリシー。指定しない場合、デフォルトでポリシー MEAN が適用されます。独自の pyramidingPolicy を指定していないすべてのバンドに適用されます。
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"。
skipMetadataRead

boolean

GDAL を使用してファイルからメタデータを読み取るかどうか。このフィールドが true の場合、タイルマップには、データ型、CRS、変換、ファイルのディメンション、データ値のない完全な GDAL メタデータが含まれている必要があります。
memo

string

ユーザーのメモを保存するための自由形式のフィールド。取り込みでは使用されません。

TilesetBand

タイルマップから取得された単一のバンドを表します。

JSON 表現 
{
  "id": string,
  "tilesetId": string,
  "tilesetBandIndex": integer,
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy)
}
フィールド
id

string

バンドの ID。
tilesetId

string

バンドに対応するタイルマップの ID。
tilesetBandIndex

integer

バンドに対応するタイルマップからのゼロベースのバンド インデックス。たとえば、1 の場合、バンドのピクセルは、ID が tilesetId の tileset（ImageManifest.tilesets 内）のインデックス 1 にあるバンドのピクセルです。
missingData

object (MissingData)

バンド内にデータがないことを表す値。values なしで MissingData が設定されている場合、この TilesetBand に対応するファイルに存在する nodata 値は無視されます。
pyramidingPolicy

enum (PyramidingPolicy)

ピラミッド型販売に関するポリシー。

TilesetMaskBand

タイルマップから取得された単一のマスクバンドを表します。

JSON 表現 
{
  "tilesetId": string,
  "bandIds": [
    string
  ]
}
フィールド
tilesetId

string

マスクバンドに対応するタイルシートの ID。タイルシートの最後のバンドは常にマスクバンドとして使用されます。
bandIds[]

string

マスクバンドが適用されるバンドの ID。空の場合、マスクバンドはアセット内のすべてのバンドに適用されます。各バンドに対応するマスクバンドは 1 つだけです。これらのバンドのいずれかに内部マスクがある場合、内部マスクは無視され、このマスクバンドが優先されます。

PixelFootprint

画像内のすべての有効なピクセルのフットプリント。

JSON 表現 
{
  "points": [
    {
      object (GridPoint)
    }
  ],
  "bandId": string
}
フィールド
points[]

object (GridPoint)

画像のすべての有効なピクセルの中心を含む単純なポリゴンの外側を形成するリング。線形リングである必要があります。つまり、最後のポイントが最初のポイントと等しくなければなりません。座標は、bandId で指定されたバンドのプロジェクションで指定します。

注: ピクセル（1x1 の長方形）がフットプリントと交差する場合にのみ、フットプリント内にピクセルを含めるため、各ピクセルの中心など、整数以外の座標を使用します。隣接するピクセルを誤って選択しないように、整数値の座標は使用しないでください。整数値の座標はピクセル間の境界です。ピクセル中心に沿ってフットプリントを描画すると、意図しないピクセルが含まれなくなります。意図したピクセルがアンチメリディアンや極点などの地図境界に接している場合にエラーが発生する可能性があります。

たとえば、4 つのピクセルがすべて有効な 2x2 の画像の場合、次のリングが考えられます。[{"x": 0.5, "y": 0.5}, {"x": 0.5, "y": 1.5}, {"x": 1.5, "y": 1.5}, {"x": 1.5, "y": 0.5}, {"x": 0.5, "y": 0.5}]
bandId

string

CRS がフットプリントの座標を定義するバンドの ID。空の場合は、最初のバンドが使用されます。

GridPoint

2 次元の点またはベクトル。

JSON 表現 
{
  "x": number,
  "y": number
}
フィールド
x

number

x 座標値。
y

number

y 座標値。