Method: projects.image.export

イメージを計算し、結果を複数の宛先のいずれかに書き込むバッチ処理を開始します。

HTTP リクエスト

POST https://earthengine.googleapis.com/v1/{project=projects/*}/image:export

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

パスパラメータ

パラメータ
project

string

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

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

  • earthengine.exports.create

リクエストの本文

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

JSON 表現 
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "maxPixels": string,
  "grid": {
    object (PixelGrid)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of mutually exclusive fields.
}
フィールド
expression

object (Expression)

計算してエクスポートするイメージに評価される式。
description

string

人が読める形式のタスク名。
maxPixels

string (Int64Value format)

計算してエクスポートするピクセル数の上限。これは、意図したよりも大きなエクスポートを誤って開始するのを防ぐための安全ガードです。デフォルト値は 1e8 ピクセルですが、この上限を増減するように値を明示的に設定できます。
grid

object (PixelGrid)

expression によって計算された画像を再投影してクリップする方法を記述するパラメータ。存在しない場合は、計算された画像全体がネイティブの投影で返されます。
requestId

string

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

string

この計算を追跡するためにユーザーが指定したラベル。
priority

integer

省略可。プロジェクト内のエクスポート タスクの優先度。優先度の高いタスクは、より早くスケジュールされます。0 ～ 9999 の整数を指定してください。設定しない場合、デフォルトは 100 です。
結果の保存場所と保存方法を指定するオプション。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
fileExportOptions

object (ImageFileExportOptions)

指定すると、ファイルとしてエクスポートするように構成されます。
assetExportOptions

object (ImageAssetExportOptions)

指定すると、エクスポートを Earth Engine アセットとして構成します。
相互に排他的なフィールドの終了。

レスポンスの本文

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

認可スコープ

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

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

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

ImageAssetExportOptions

画像を Earth Engine アセットとして保存するためのオプション。

JSON 表現 
{
  "pyramidingPolicy": enum (PyramidingPolicy),
  "pyramidingPolicyOverrides": {
    string: enum (PyramidingPolicy),
    ...
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of mutually exclusive fields.
}
フィールド
pyramidingPolicy

enum (PyramidingPolicy)

すべてのバンドにデフォルトで適用されるピラミッド ポリシー。
pyramidingPolicyOverrides

map (key: string, value: enum (PyramidingPolicy))

バンドごとの特定のピラミッド ポリシーのオーバーライド。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
結果を書き込む場所。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
earthEngineDestination

object (EarthEngineDestination)

指定すると、Earth Engine へのエクスポートが構成されます。
相互に排他的なフィールドの終了。