이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Method: projects.map.export

타일 맵을 계산하고 결과를 Google Cloud Storage에 쓰는 일괄 프로세스를 시작합니다.

HTTP 요청

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

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

경로 매개변수

매개변수

매개변수
`project`	`string` 이 요청의 서비스 소비자로 간주되어야 하는 Google Cloud Platform 프로젝트의 프로젝트 ID 또는 프로젝트 번호입니다. 형식은 `projects/{project-id}`입니다. 승인을 처리하려면 지정된 리소스 `project`에 대해 다음과 같은 IAM 권한이 필요합니다. `earthengine.exports.create`

project

string

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

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

earthengine.exports.create

요청 본문

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

JSON 표현

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)
  },
  "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 표현

JSON 표현
{ "startZoom": integer, "skipEmpty": boolean, "mapsApiKey": string, "dimensions": { object (`GridDimensions`) }, "stride": integer, "zoomSubset": { object (`ZoomSubset`) }, // Union field `end_zoom_or_scale` can be only one of the following: "endZoom": integer, "scale": number // End of list of possible types for union field `end_zoom_or_scale`. }

{
  "startZoom": integer,
  "skipEmpty": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // Union field end_zoom_or_scale can be only one of the following:
  "endZoom": integer,
  "scale": number
  // End of list of possible types for union field end_zoom_or_scale.
}

필드
`startZoom`	`integer` 내보내기용 지도 타일 생성을 시작하는 확대/축소 수준입니다. 기본값은 0입니다.
`skipEmpty`	`boolean` 이 값이 true이면 빈 (즉, 완전히 투명한) 지도 타일 쓰기를 건너뜁니다.
`mapsApiKey`	`string` 생성된 지도 타일 뷰어의 Google Maps Platform API 키(선택사항)
`dimensions`	`object (GridDimensions)` 타일링된 동영상 피라미드 (ExportVideoMap) 내보내기에만 사용되는 출력 동영상 타일의 너비와 높이입니다.
`stride`	`integer` 타일 행 및 열 스트라이드 (ExportVideoMap) 희소 타일의 경우 4 (WebGL 전용)로, 최대 호환성을 위해 1 (기본값)로 설정합니다.
`zoomSubset`	`object (ZoomSubset)` 타일을 생성할 확대/축소 수준의 하위 집합입니다. `ExportVideoMap` 호출에서만 지정할 수 있습니다.
통합 필드 `end_zoom_or_scale`. 지도 타일 생성을 중지할 확대/축소 수준 또는 축척입니다. 둘 중 하나를 지정해야 합니다. `end_zoom_or_scale`은 다음 중 하나여야 합니다.
`endZoom`	`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 }

필드

필드
`start`	`number` 타일을 생성할 시작 확대/축소 수준 하위 집합입니다 (ExportVideoMap). 여기서 하위 집합은 확대/축소 수준을 점진적으로 렌더링할 수 있는 부동 소수점 값이므로, 예를 들어 12.1은 지정되지 않았지만 결정론적 순서로 확대/축소 12의 타일 중 처음 10% 입니다.
`end`	`number` 타일을 생성할 확대/축소 수준 하위 집합의 끝 (ExportVideoMap)입니다. 이를 통해 지정되지 않았지만 결정론적 순서로 최대 하위 집합 (제공된 경우)까지 확대/축소 수준을 점진적으로 렌더링할 수 있습니다.

start

number

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

end