Method: projects.map.export

タイル地図を計算して結果を Google Cloud Storage に書き込むバッチ処理を開始します。

HTTP リクエスト

POST https://earthengine.googleapis.com/v1alpha/{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,
  "minZoom": integer,
  "skipEmpty": boolean,
  "skipEmptyTiles": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "tileDimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "endZoom": integer,
  "maxZoom": integer,
  "scale": number
  // End of mutually exclusive fields.
}
フィールド
startZoom

integer

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

integer

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

boolean

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

boolean

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

string

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

object (GridDimensions)

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

object (GridDimensions)

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

integer

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

object (ZoomSubset)

タイルを生成するズームレベルのサブセット。ExportVideoMap の呼び出しでのみ指定できます。
地図タイルの生成を停止するズームレベルまたは縮尺。どちらか一方を指定する必要があります。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
endZoom

integer

地図タイルの生成を停止するズームレベル。
maxZoom
(deprecated)

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 } また、すべてのエクスポート シャードのピラミッド サイズ（startZoom と endZoom）は同じ（完全）である必要があります。

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

number

タイルを生成する開始ズームレベルのサブセット（ExportVideoMap）。ここで、サブセットは倍精度値です。これにより、ズームレベルを段階的にレンダリングできます。たとえば、12.1 は、ズーム 12 のタイルの最初の 10% を、未指定ですが決定論的な順序でレンダリングします。
end

number

タイルを生成する終了ズームレベルのサブセット（ExportVideoMap）。ズームレベルを最大サブセット（指定されている場合）まで増分的にレンダリングできますが、その順序は指定されていません。
min
(deprecated)

number

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

number

タイルを生成する終了ズームレベルのサブセット（ExportVideoMap）。ズームレベルを最大サブセット（指定されている場合）まで増分的にレンダリングできますが、その順序は指定されていません。