Method: projects.image.computePixels

이미지 데이터에 임의의 계산을 실행하여 픽셀 타일을 계산합니다.

요청은 요청당 압축되지 않은 데이터 48MB로 제한되며, 이는 요청 크기(픽셀), 요청된 이미지 밴드 수, 각 밴드의 픽셀당 바이트 수를 곱하여 계산됩니다. 요청은 둘 중 하나의 크기가 최대 32,000픽셀, 최대 1,024개 밴드로 제한됩니다. 이 한도를 초과하는 요청은 400 (BAD_REQUEST) 오류 코드를 발생시킵니다.

성공하면 응답 본문에 요청의 fileFormat 필드에 지정된 인코딩으로 요청된 픽셀 데이터가 포함됩니다.

HTTP 요청

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

URL은 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를 참고하세요.