Earth Engine은 공유 컴퓨팅 리소스를 보호하고 모든 사용자에게 안정적인 성능을 보장하기 위해
비상업적 할당량 등급을 도입했습니다. 비상업적 프로젝트는 기본적으로 커뮤니티 등급을 사용하지만 언제든지 프로젝트의 등급을 변경할 수 있습니다.
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
Export.map.toCloudStorage
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
웹 지도 뷰어에서 사용할 지도의 직사각형 피라미드로 이미지를 내보내는 일괄 작업을 만듭니다. 지도 타일에는 Google 지도 API를 사용하여 지도 타일을 표시하는 reference index.html 파일과 Google 어스에서 지도를 여는 earth.html 파일이 함께 제공됩니다.
| 사용 | 반환 값 |
|---|
Export.map.toCloudStorage(image, description, bucket, fileFormat, path, writePublicTiles, maxZoom, scale, minZoom, region, skipEmptyTiles, mapsApiKey, bucketCorsUris, priority) | |
| 인수 | 유형 | 세부정보 |
|---|
image | 이미지 | 타일로 내보낼 이미지입니다. |
description | 문자열, 선택사항 | 사람이 읽을 수 있는 작업 이름입니다. 기본값은 'myExportMapTask'입니다. |
bucket | 문자열, 선택사항 | 쓸 대상 버킷입니다. |
fileFormat | 문자열, 선택사항 | 지도 타일의 파일 형식입니다('auto', 'png', 'jpg' 중 하나). 기본값은 'auto'입니다. 즉, 불투명 타일은 'jpg'로 인코딩되고 투명도가 있는 타일은 'png'로 인코딩됩니다. |
path | 문자열, 선택사항 | 출력의 경로로 사용되는 문자열입니다. 후행 '/'는 선택사항입니다. 기본값은 작업의 설명입니다. |
writePublicTiles | 불리언, 선택사항 | 버킷의 기본 객체 ACL을 사용하는 대신 공개 타일을 쓸지 여부입니다. 기본값은 true이며 호출자가 버킷의 소유자여야 합니다. |
maxZoom | 숫자, 선택사항 | 내보낼 지도 타일의 최대 확대/축소 수준입니다. |
scale | 숫자, 선택사항 | 'maxZoom'의 대안으로, 픽셀당 최대 이미지 해상도(미터)입니다. 축척은 적도에서 가장 적절한 최대 확대/축소 수준으로 변환됩니다. |
minZoom | 숫자, 선택사항 | 내보낼 지도 타일의 선택적 최소 확대/축소 수준입니다. 기본값은 0입니다. |
region | Geometry.LinearRing|Geometry.Polygon|String(선택사항) | 내보낼 지역을 나타내는 LinearRing, Polygon 또는 좌표입니다. 이러한 값은 문자열로 직렬화된 Geometry 객체 또는 좌표로 지정될 수 있습니다. 지도 타일은 이 지오메트리를 포함하는 직사각형 영역에서 생성됩니다. |
skipEmptyTiles | 불리언, 선택사항 | true인 경우 비어 있는 (즉, 완전히 투명한) 지도 타일의 쓰기를 건너뜁니다. 기본값은 false입니다. GeoTIFF 내보내기에서만 지원됩니다. |
mapsApiKey | 문자열, 선택사항 | index.html에서 Google 지도 API를 초기화하는 데 사용됩니다. 이렇게 하면 지도에서 '개발 목적으로만 사용' 메시지가 삭제됩니다. |
bucketCorsUris | List[String], 선택사항 | JavaScript에서 내보낸 타일을 가져올 수 있는 도메인 목록 (예: https://code.earthengine.google.com)입니다. 타일을 공개로 설정하는 것만으로는 웹페이지에서 액세스할 수 없으므로 도메인에 버킷 액세스 권한을 명시적으로 부여해야 합니다. 이를 교차 출처 리소스 공유(CORS)라고 합니다. '*'를 사용하여 모든 도메인이 액세스하도록 허용할 수 있지만 일반적으로 권장되지 않습니다. 자세한 내용은 https://cloud.google.com/storage/docs/cross-origin을 참고하세요. |
priority | 숫자, 선택사항 | 프로젝트 내 작업의 우선순위입니다. 우선순위가 높은 작업은 더 빨리 예약됩니다. 0에서 9999 사이의 정수여야 합니다. 기본값은 100입니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2026-01-08(UTC)
[null,null,["최종 업데이트: 2026-01-08(UTC)"],[],["This content details how to export an image as a tiled map pyramid for web viewers. The core action is using `Export.map.toCloudStorage` to create a batch task, specifying parameters like the `image`, `bucket`, `fileFormat`, and zoom levels (`minZoom`, `maxZoom`, or `scale`). Optional settings include a task `description`, `region`, `writePublicTiles`, and skipping empty tiles. The function also generates `index.html` (Google Maps API) and `earth.html` (Google Earth) files. Other setting is to establish the `mapsApiKey`, `bucketCorsUris` and the `priority`.\n"]]