Method: projects.image.export

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

HTTP リクエスト

POST https://earthengine.googleapis.com/v1beta/{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 にエクスポートするように構成されます。
相互に排他的なフィールドの終わり。