Method: projects.image.export

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

HTTP 요청

POST https://earthengine.googleapis.com/v1alpha/{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,

  // Union field export_options can be only one of the following:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of list of possible types for union field export_options.
}
필드
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입니다.

통합 필드 export_options. 결과를 저장하는 위치와 방법을 설명하는 옵션입니다. export_options은 다음 중 하나여야 합니다.
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),
    ...
  },

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
필드
pyramidingPolicy

enum (PyramidingPolicy)

기본적으로 모든 대역에 적용되는 피라미딩 정책입니다.

pyramidingPolicyOverrides

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

특정 밴드별 피라미드 정책 재정의

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

통합 필드 destination. 결과를 작성할 위치입니다. destination은 다음 중 하나여야 합니다.
earthEngineDestination

object (EarthEngineDestination)

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