Method: projects.map.export

타일식 지도를 계산하고 결과를 Google Cloud Storage에 쓰는 일괄 처리를 시작합니다.

HTTP 요청

POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/map:export

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

경로 매개변수

매개변수
project

string

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

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

  • earthengine.exports.create

요청 본문

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

JSON 표현 
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}
필드
expression

object (Expression)

계산하고 내보낼 이미지를 평가하는 표현식입니다. 이미지의 경계는 렌더링할 지도 타일 집합을 결정하는 데 사용됩니다. 내보낸 영역을 제어하려면 내보내기 전에 이미지를 클리핑하세요.
description

string

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

object (TileOptions)

생성할 지도 타일을 설명하는 옵션입니다.
tileExportOptions

object (ImageFileExportOptions)

지도 타일을 내보낼 위치와 형식에 관한 옵션입니다. 현재 Cloud Storage는 지도 내보내기를 위한 유일하게 지원되는 대상입니다.
requestId

string

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

string

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

integer

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

응답 본문

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

TileOptions

내보낼 이미지 또는 동영상 지도 타일을 설명하는 옵션입니다.

JSON 표현 
{
  "startZoom": integer,
  "minZoom": integer,
  "skipEmpty": boolean,
  "skipEmptyTiles": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "tileDimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "endZoom": integer,
  "maxZoom": integer,
  "scale": number
  // End of mutually exclusive fields.
}
필드
startZoom

integer

내보내기를 위해 지도 타일 생성을 시작할 확대/축소 수준입니다. 기본값은 0입니다.
minZoom
(deprecated)

integer

내보내기를 위해 지도 타일 생성을 시작할 확대/축소 수준입니다. 기본값은 0입니다.
skipEmpty

boolean

true인 경우 빈 (즉, 완전히 투명한) 지도 타일 작성을 건너뜁니다.
skipEmptyTiles
(deprecated)

boolean

true인 경우 빈 (즉, 완전히 투명한) 지도 타일 작성을 건너뜁니다.
mapsApiKey

string

생성된 지도 타일 뷰어의 선택적 Google Maps Platform API 키입니다.
dimensions

object (GridDimensions)

출력 동영상 타일의 너비와 높이로, 타일식 동영상 피라미드 (ExportVideoMap)를 내보내는 데만 사용됩니다.
tileDimensions
(deprecated)

object (GridDimensions)

출력 동영상 타일의 너비와 높이로, 타일식 동영상 피라미드 (ExportVideoMap)를 내보내는 데만 사용됩니다.
stride

integer

타일 행 및 열 스트라이드입니다. (ExportVideoMap) 스파스 타일 (WebGL 전용)의 경우 4로 설정하고 최대 호환성을 위해 1 (기본값)로 설정합니다.
zoomSubset

object (ZoomSubset)

타일을 생성할 확대/축소 수준의 하위 집합입니다. ExportVideoMap 호출에서만 지정할 수 있습니다.
지도 타일 생성을 중지할 확대/축소 수준 또는 축척입니다. 둘 중 하나를 지정해야 합니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 필드가 최대 하나만 설정됩니다.
endZoom

integer

지도 타일 생성을 중지할 확대/축소 수준입니다.
maxZoom
(deprecated)

integer

지도 타일 생성을 중지할 확대/축소 수준입니다.
scale

number

픽셀당 미터 단위의 최대 이미지 해상도입니다. 축척은 적도에서 가장 적절한 최대 확대/축소 수준으로 변환됩니다.
상호 배타적인 필드의 끝입니다.

ZoomSubset

타일을 생성할 확대/축소 수준의 하위 집합입니다 (ExportVideoMap). 시작 및 종료 하위 집합은 배정밀도 값이므로 확대/축소 수준을 점진적으로 렌더링할 수 있습니다. 시작 확대/축소 수준이 12인 전체 피라미드를 렌더링하려면 startZoom=0, endZoom=12로 설정하고 이 메시지를 설정하지 마세요. 수준 0~11과 수준 12의 처음 10% 를 렌더링하려면 startZoom=0, endZoom=12, subset = {min=0, max=12.1 } 수준 12의 다음 10% 를 렌더링하려면 startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 } 수준 12의 나머지 80% 를 렌더링하려면 startZoom=0, endZoom=12, subset = {min=12.2, max=13 } 또한 모든 내보내기 샤드는 start/endZoom에서 동일한 (전체) 피라미드 크기를 가져야 합니다.

JSON 표현 
{
  "start": number,
  "end": number,
  "min": number,
  "max": number
}
필드
start

number

타일을 생성할 시작 확대/축소 수준 하위 집합입니다 (ExportVideoMap). 여기서 하위 집합은 배정밀도 값이므로 확대/축소 수준을 점진적으로 렌더링할 수 있습니다. 예를 들어 12.1은 지정되지 않았지만 결정적인 순서로 확대/축소 12의 타일 중 처음 10% 입니다.
end

number

타일을 생성할 종료 확대/축소 수준 하위 집합입니다 (ExportVideoMap). 이를 통해 지정되지 않았지만 결정적인 순서로 최대 하위 집합 (제공된 경우)을 포함하지 않고 확대/축소 수준을 점진적으로 렌더링할 수 있습니다.
min
(deprecated)

number

타일을 생성할 시작 확대/축소 수준 하위 집합입니다 (ExportVideoMap). 여기서 하위 집합은 배정밀도 값이므로 확대/축소 수준을 점진적으로 렌더링할 수 있습니다. 예를 들어 12.1은 지정되지 않았지만 결정적인 순서로 확대/축소 12의 타일 중 처음 10% 입니다.
max
(deprecated)

number

타일을 생성할 종료 확대/축소 수준 하위 집합입니다 (ExportVideoMap). 이를 통해 지정되지 않았지만 결정적인 순서로 최대 하위 집합 (제공된 경우)을 포함하지 않고 확대/축소 수준을 점진적으로 렌더링할 수 있습니다.