공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해
비상업용 자격 요건을 인증해야 합니다.
Export.map.toCloudStorage
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
웹 지도 뷰어에서 사용할 지도의 직사각형 피라미드 타일로 이미지를 내보내는 일괄 작업을 만듭니다. 지도 타일에는 Google Maps 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 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eExports an image as map tiles for web map viewers, including an index.html for Google Maps API and earth.html for Google Earth.\u003c/p\u003e\n"],["\u003cp\u003eAllows customization of file format, zoom levels, region, and tile visibility (public or private).\u003c/p\u003e\n"],["\u003cp\u003eOptionally skips empty tiles, provides a Google Maps API key, and sets bucket access for web domains.\u003c/p\u003e\n"],["\u003cp\u003eUses \u003ccode\u003eExport.map.toCloudStorage()\u003c/code\u003e function with parameters for image, destination, format, and various optional configurations.\u003c/p\u003e\n"]]],["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"],null,[]]