Method: projects.assets.getPixels

이미지 확장 소재에서 픽셀을 가져옵니다. 이 맞춤 메서드를 사용하면 호출자가 밴드와 지도 투영을 선택적으로 지정하여 이미지에서 임의의 픽셀 타일을 요청할 수 있습니다. 마스킹되거나 누락된 데이터는 0으로 인코딩됩니다.

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

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

HTTP 요청

POST https://earthengine.googleapis.com/v1alpha/{name=projects/*/assets/**}:getPixels

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
name

string

필수입니다. 픽셀을 가져올 이미지 확장 소재의 이름입니다. name는 'projects/*/assets/**' 형식입니다(예: "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). 모든 사용자 소유 애셋은 'earthengine-legacy' 프로젝트에 속합니다(예: "projects/earthengine-legacy/assets/users/foo/bar"). 그 밖의 모든 애셋은 'earthengine-public' 프로젝트에 속합니다(예: "projects/earthengine-public/assets/LANDSAT").

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • earthengine.assets.get

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "fileFormat": enum (ImageFileFormat),
  "grid": {
    object (PixelGrid)
  },
  "region": {
    object
  },
  "bandIds": [
    string
  ],
  "visualizationOptions": {
    object (VisualizationOptions)
  },
  "workloadTag": string
}
필드
fileFormat

enum (ImageFileFormat)

픽셀 값을 반환할 출력 파일 형식입니다.
grid

object (PixelGrid)

데이터를 가져올 픽셀 그리드를 설명하는 매개변수입니다. 기본값은 데이터의 기본 픽셀 그리드입니다.
region

object (Struct format)

있는 경우 반환할 데이터 영역으로, GeoJSON 도형 객체로 지정됩니다 (RFC 7946 참고). 반환된 이미지는 항상 직사각형이므로 출력 좌표계에서 지정된 도형의 경계 상자가 실제로 사용됩니다. grid.dimensions도 지정하면 그리드가 요청된 크기로 다시 조정됩니다.
bandIds[]

string

있는 경우 픽셀을 가져올 특정 밴드 세트를 지정합니다. 밴드는 ImageBand 프로토의 id 필드에 표시된 대로 ID로 식별됩니다.
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를 참고하세요.