Method: projects.map.export

タイルマップで計算された結果を Google Cloud Storage に書き込むバッチ処理を開始します。

HTTP リクエスト

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/map:export

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

パスパラメータ

パラメータ
project

string

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

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

  • earthengine.exports.create

リクエストの本文

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

JSON 表現
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}
フィールド
expression

object (Expression)

計算してエクスポートするイメージに評価される式。画像の境界は、レンダリングする地図タイルセットを決定するために使用されます。エクスポートする領域を制御するには、エクスポートする前に画像をクリップします。

description

string

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

tileOptions

object (TileOptions)

生成する地図タイルを表すオプション。

tileExportOptions

object (ImageFileExportOptions)

地図タイルのエクスポート先と形式のオプション。現在、地図のエクスポートの宛先としてサポートされているのは Cloud Storage のみです。

requestId

string

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

workloadTag

string

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

priority

integer

省略可。プロジェクト内のエクスポート タスクの優先度。優先度の高いタスクはより早くスケジュールされます。0 ~ 9999 の整数を指定してください。設定しない場合、デフォルトは 100 です。

レスポンスの本文

成功した場合、レスポンスの本文には 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 をご覧ください。

TileOptions

エクスポートする画像または動画のマップタイルを表すオプション。

JSON 表現
{
  "startZoom": integer,
  "skipEmpty": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // Union field end_zoom_or_scale can be only one of the following:
  "endZoom": integer,
  "scale": number
  // End of list of possible types for union field end_zoom_or_scale.
}
フィールド
startZoom

integer

エクスポート用地図タイルの生成を開始するズームレベル。デフォルトは 0 です。

skipEmpty

boolean

true の場合、空の(完全に透明な)地図タイルの書き込みをスキップします。

mapsApiKey

string

生成された地図タイル ビューア用の Google Maps Platform API キー(省略可)。

dimensions

object (GridDimensions)

出力動画タイルの幅と高さ。タイルの動画ピラミッド(ExportVideoMap)のエクスポートにのみ使用されます。

stride

integer

タイルの行と列のストライド。(ExportVideoMap)スパース タイルの場合は 4(WebGL のみ)、最大限の互換性を確保する場合は 1(デフォルト)に設定します。

zoomSubset

object (ZoomSubset)

タイルを生成するズームレベルのサブセット。ExportVideoMap の呼び出しでのみ指定できます。

共用体フィールド end_zoom_or_scale。マップタイルの生成を停止するズームレベルまたは縮尺。どちらか一方を指定する必要があります。end_zoom_or_scale は次のいずれかになります。
endZoom

integer

マップタイルの生成を停止するズームレベル。

scale

number

最大画像解像度(ピクセルあたりのメートル)。スケールは、赤道で最も適切な最大ズームレベルに変換されます。

ZoomSubset

タイルを生成するズームレベルのサブセット(ExportVideoMap)。開始サブセットと終了サブセットは倍精度値で、ズームレベルを段階的にレンダリングできます。開始ズームが 12 のピラミッド全体をレンダリングするには(startZoom=0、endZoom=12)、このメッセージを設定しないでください。レベル 0 ~ 11 とレベル 12 の最初の 10% をレンダリングするには、startZoom=0、endZoom=12、subset = {min=0, max=12.1 } を使用します。レベル 12 の次の 10% をレンダリングするには、startZoom=0、endZoom=12、subset = {min=12.1, max=12.2 } を使用します。レベル 12 の残りの 80% をレンダリングするには、startZoom=0、endZoom=12、subset = {min=12.2, max=13 } を使用します。また、すべてのエクスポート シャードで、start/endZoom に同じ(完全な)ピラミッド サイズを指定する必要があります。

JSON 表現
{
  "start": number,
  "end": number
}
フィールド
start

number

タイルを生成する開始ズームレベルのサブセット(ExportVideoMap)ここで、サブセットは倍精度値であり、ズームレベルを段階的にレンダリングできます。たとえば、12.1 は、指定されていないが確定的な順序で、ズームレベル 12 の最初の 10% のタイルです。

end

number

タイルを生成する終了ズームレベルのサブセット(ExportVideoMap)。指定されていないが確定的な順序で、最大サブセット(指定されている場合)まで、ズームレベルを段階的にレンダリングできます。