Method: projects.image.export

이미지를 계산하고 결과를 여러 대상 중 하나에 쓰는 일괄 프로세스를 시작합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
project

string

이 요청의 서비스 소비자로 처리해야 하는 Google Cloud Platform 프로젝트의 프로젝트 ID 또는 프로젝트 번호입니다. 형식은 projects/{project-id}입니다.

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

  • earthengine.exports.create

요청 본문

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

JSON 표현
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "maxPixels": string,
  "grid": {
    object (PixelGrid)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of mutually exclusive fields.
}
필드
expression

object (Expression)

계산하고 내보낼 이미지를 평가하는 표현식입니다.

description

string

작업의 사람이 읽을 수 있는 이름입니다.

maxPixels

string (Int64Value format)

계산하고 내보낼 최대 픽셀 수입니다. 이는 의도한 것보다 더 큰 내보내기를 실수로 시작하지 않도록 하는 안전 장치입니다. 기본값은 1e8픽셀이지만 값을 명시적으로 설정하여 이 한도를 높이거나 낮출 수 있습니다.

grid

object (PixelGrid)

expression으로 계산된 이미지를 재투영하고 클리핑하는 방법을 설명하는 매개변수입니다. 없는 경우 계산된 전체 이미지가 기본 투영으로 반환됩니다.

requestId

string

중복 요청을 감지하는 데 사용되는 고유한 문자열입니다. 동일한 사용자가 비어 있지 않은 동일한 requestId로 둘 이상의 요청을 하는 경우 이러한 요청 중 하나만 장기 실행 작업을 시작할 수 있습니다. requestId에는 문자 a~z, A~Z, 0~9 또는 '-'가 포함될 수 있습니다. requestId의 최대 길이는 60자입니다.

workloadTag

string

이 계산을 추적하기 위해 사용자가 제공한 라벨입니다.

priority

integer

선택사항입니다. 프로젝트 내에서 내보내기 작업의 우선순위입니다. 우선순위가 높은 작업이 더 빨리 예약됩니다. 0~9999 사이의 정수여야 합니다. 설정하지 않으면 기본값은 100입니다.

결과를 저장할 위치와 방법을 설명하는 옵션입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 필드가 최대 하나 설정됩니다.
fileExportOptions

object (ImageFileExportOptions)

지정된 경우 내보내기를 파일로 구성합니다.

assetExportOptions

object (ImageAssetExportOptions)

지정된 경우 내보내기를 Earth Engine 애셋으로 구성합니다.

상호 배타적인 필드의 끝입니다.

응답 본문

성공한 경우 응답 본문에 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를 참조하세요.

ImageAssetExportOptions

이미지를 Earth Engine 애셋으로 저장하는 옵션입니다.

JSON 표현
{
  "pyramidingPolicy": enum (PyramidingPolicy),
  "pyramidingPolicyOverrides": {
    string: enum (PyramidingPolicy),
    ...
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of mutually exclusive fields.
}
필드
pyramidingPolicy

enum (PyramidingPolicy)

기본적으로 모든 밴드에 적용할 피라미드 정책입니다.

pyramidingPolicyOverrides

map (key: string, value: enum (PyramidingPolicy))

밴드별 피라미드 정책 재정의입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

결과를 쓸 위치입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 필드가 최대 하나 설정됩니다.
earthEngineDestination

object (EarthEngineDestination)

지정된 경우 Earth Engine으로 내보내기를 구성합니다.

상호 배타적인 필드의 끝입니다.