공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해
비상업용 자격 요건을 인증해야 합니다.
Export.video.toDrive
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
ImageCollection을 동영상으로 Drive에 내보내는 일괄 작업을 만듭니다. 컬렉션에는 RGB 이미지만 포함되어야 합니다. Tasks 탭에서 작업을 시작할 수 있습니다. 'crsTransform', 'scale', 'dimensions'는 상호 배타적입니다.
| 사용 | 반환 값 |
|---|
Export.video.toDrive(collection, description, folder, fileNamePrefix, framesPerSecond, dimensions, region, scale, crs, crsTransform, maxPixels, maxFrames, priority) | |
| 인수 | 유형 | 세부정보 |
|---|
collection | ImageCollection | 내보낼 이미지 컬렉션입니다. |
description | 문자열, 선택사항 | 사람이 읽을 수 있는 작업 이름입니다. 문자, 숫자, -, _를 포함할 수 있습니다(공백 없음). 기본값은 'myExportVideoTask'입니다. |
folder | 문자열, 선택사항 | 내보내기가 저장될 Google Drive 폴더입니다. 참고: (a) 폴더 이름이 어느 수준에든 있으면 출력이 해당 폴더에 작성됩니다. (b) 중복된 폴더 이름이 있으면 가장 최근에 수정된 폴더에 출력이 작성됩니다. (c) 폴더 이름이 없으면 루트에 새 폴더가 생성됩니다. (d) 구분자가 있는 폴더 이름 (예: 'path/to/file')은 시스템 경로가 아닌 리터럴 문자열로 해석됩니다. 기본값은 Drive 루트입니다. |
fileNamePrefix | 문자열, 선택사항 | 파일 이름 접두사입니다. 문자, 숫자, -, _를 포함할 수 있습니다(공백 없음). 기본값은 설명입니다. |
framesPerSecond | 숫자, 선택사항 | 내보낸 동영상의 프레임 속도입니다. 0.1에서 100 사이의 값이어야 합니다. 기본값은 1입니다. |
dimensions | Number|String, 선택사항 | 내보낸 이미지에 사용할 측정기준입니다. 최대 측정기준으로 단일 양의 정수를 사용하거나 'WIDTHxHEIGHT'를 사용합니다. 여기서 WIDTH와 HEIGHT는 각각 양의 정수입니다. |
region | Geometry.LinearRing|Geometry.Polygon|String(선택사항) | 내보낼 지역을 나타내는 LinearRing, Polygon 또는 좌표입니다. 이는 문자열로 직렬화된 Geometry 객체 또는 좌표로 지정될 수 있습니다. |
scale | 숫자, 선택사항 | 미터당 픽셀 해상도입니다. |
crs | 문자열, 선택사항 | 내보낸 이미지에 사용할 CRS입니다. 기본값은 Google 지도 메르카토르 투영(SR-ORG:6627)입니다. |
crsTransform | 문자열, 선택사항 | 내보낸 이미지에 사용할 어파인 변환입니다. 'crs'가 정의되어야 합니다. |
maxPixels | 숫자, 선택사항 | 내보내기에서 픽셀 수를 제한합니다. 기본적으로 내보내기가 1e8픽셀을 초과하면 오류가 표시됩니다. 이 값을 명시적으로 설정하면 이 한도를 높이거나 낮출 수 있습니다. |
maxFrames | 숫자, 선택사항 | 내보낼 최대 프레임 수를 설정합니다. 기본적으로 최대 1, 000개의 프레임을 내보낼 수 있습니다. 이 값을 명시적으로 설정하면 이 한도를 높이거나 낮출 수 있습니다. |
priority | 숫자, 선택사항 | 프로젝트 내 작업의 우선순위입니다. 우선순위가 높은 작업은 더 빨리 예약됩니다. 0에서 9999 사이의 정수여야 합니다. 기본값은 100입니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eExports an ImageCollection containing only RGB images as a video to Google Drive.\u003c/p\u003e\n"],["\u003cp\u003eAllows customization of video parameters such as frame rate, dimensions, region, and resolution.\u003c/p\u003e\n"],["\u003cp\u003eProvides options to specify the output filename, folder in Google Drive, and task priority.\u003c/p\u003e\n"],["\u003cp\u003eUsers can define the coordinate system and affine transformation for the exported video.\u003c/p\u003e\n"],["\u003cp\u003eLimits can be set on the maximum number of pixels and frames in the exported video to manage processing resources.\u003c/p\u003e\n"]]],[],null,["# Export.video.toDrive\n\n\u003cbr /\u003e\n\nCreates a batch task to export an ImageCollection as a video to Drive. The collection must only contain RGB images. Tasks can be started from the Tasks tab. \"crsTransform\", \"scale\", and \"dimensions\" are mutually exclusive.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------|\n| `Export.video.toDrive(collection, `*description* `, `*folder* `, `*fileNamePrefix* `, `*framesPerSecond* `, `*dimensions* `, `*region* `, `*scale* `, `*crs* `, `*crsTransform* `, `*maxPixels* `, `*maxFrames* `, `*priority*`)` | |\n\n| Argument | Type | Details |\n|-------------------|---------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `collection` | ImageCollection | The image collection to export. |\n| `description` | String, optional | A human-readable name of the task. May contain letters, numbers, -, _ (no spaces). Defaults to \"myExportVideoTask\". |\n| `folder` | String, optional | The Google Drive Folder that the export will reside in. Note: (a) if the folder name exists at any level, the output is written to it, (b) if duplicate folder names exist, output is written to the most recently modified folder, (c) if the folder name does not exist, a new folder will be created at the root, and (d) folder names with separators (e.g. 'path/to/file') are interpreted as literal strings, not system paths. Defaults to Drive root. |\n| `fileNamePrefix` | String, optional | The filename prefix. May contain letters, numbers, -, _ (no spaces). Defaults to the description. |\n| `framesPerSecond` | Number, optional | The framerate of the exported video. Must be a value between 0.1 and 100. Defaults to 1. |\n| `dimensions` | Number\\|String, optional | The dimensions to use for the exported image. Takes either a single positive integer as the maximum dimension or \"WIDTHxHEIGHT\" where WIDTH and HEIGHT are each positive integers. |\n| `region` | Geometry.LinearRing\\|Geometry.Polygon\\|String, optional | A LinearRing, Polygon, or coordinates representing region to export. These may be specified as the Geometry objects or coordinates serialized as a string. |\n| `scale` | Number, optional | Resolution in meters per pixel. |\n| `crs` | String, optional | CRS to use for the exported image. Defaults to the Google Maps Mercator projection, SR-ORG:6627. |\n| `crsTransform` | String, optional | Affine transform to use for the exported image. Requires \"crs\" to be defined. |\n| `maxPixels` | Number, optional | Restrict the number of pixels in the export. By default, you will see an error if the export exceeds 1e8 pixels. Setting this value explicitly allows one to raise or lower this limit. |\n| `maxFrames` | Number, optional | Set the maximum number of frames to export. By default, a maximum of 1000 frames may be exported. By setting this explicitly, you may raise or lower this limit. |\n| `priority` | Number, optional | The priority of the task within the project. Higher priority tasks are scheduled sooner. Must be an integer between 0 and 9999. Defaults to 100. |"]]
