Method: projects.image.computePixels

画像データに対して任意の計算を実行して、ピクセルのタイルを計算します。

リクエストは、リクエストのディメンション（ピクセル単位）、リクエストされた画像バンドの数、各バンドのピクセルあたりのバイト数の積として計算される、リクエストあたり 48 MB の非圧縮データに制限されます。リクエストは、いずれかのディメンションで最大 32,000 ピクセル、最大 1,024 バンドに制限されています。これらの上限を超えるリクエストは、エラーコード 400（BAD_REQUEST）になります。

成功した場合、レスポンスの本文には、リクエストの fileFormat フィールドで指定されたエンコードでリクエストされたピクセルデータが含まれます。

HTTP リクエスト

POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/image:computePixels

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

パスパラメータ

パラメータ
project

string

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

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

  • earthengine.computations.create

リクエストの本文

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

JSON 表現 
{
  "expression": {
    object (Expression)
  },
  "fileFormat": enum (ImageFileFormat),
  "grid": {
    object (PixelGrid)
  },
  "bandIds": [
    string
  ],
  "visualizationOptions": {
    object (VisualizationOptions)
  },
  "workloadTag": string
}
フィールド
expression

object (Expression)

計算する式。
fileFormat

enum (ImageFileFormat)

ピクセル値を返す出力ファイル形式。
grid

object (PixelGrid)

expression によって計算された画像を再投影してクリップする方法を表すパラメータ。指定しない場合、計算された画像全体がネイティブ投影で返されます。
bandIds[]

string

指定されている場合、expression の評価結果から選択される特定のバンドセットを指定します。指定しない場合、expression の結果として得られたすべてのバンドが選択されます。
visualizationOptions

object (VisualizationOptions)

存在する場合は、データの 8 ビット RGB 可視化を生成するために適用する一連の可視化オプション。
workloadTag

string

この計算をトラッキングするためにユーザーが指定したタグ。

レスポンスの本文

成功した場合、レスポンスはメソッドによって定義された形式の汎用 HTTP レスポンスになります。

認可スコープ

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

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

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