Method: projects.image.computePixels

通过对图片数据执行任意计算来计算一块像素。

每个请求的未压缩数据量限制为 48MB，计算方式为请求尺寸（以像素为单位）、请求的图像波段数以及每个波段的每个像素字节数的乘积。请求的任一尺寸不得超过 32K 像素，且不得超过 1024 个波段。超出这些限制的请求将导致错误代码为 400 (BAD_REQUEST)。

如果成功，响应正文将包含请求的像素数据，采用请求的 fileFormat 字段中指定的编码。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
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。