이미지, 동영상, 테이블(벡터 데이터)을 포함한 다른 형식으로 내보내는 방법에 대한 자세한 내용은 데이터 내보내기를 참조하세요.
개요
온라인 지도에 이미지 데이터(래스터 데이터)를 표시하려면 Export.map.toCloudStorage()를 사용하여 지도 타일을 내보내면 됩니다. 이 함수는 지도 타일 피라미드를 Cloud Storage 버킷으로 내보내며, 여기에서 공개 또는 비공개로 제공할 수 있습니다. 이미지 데이터가 너무 커서 단일 이미지로 오버레이할 수 없는 경우에 유용합니다. 이러한 타일은 Google 지도 타일 좌표를 사용하며 Google Maps Platform(지도 API), 웹용 Google 어스, 기타 매핑 플랫폼을 사용하여 표시하는 데 적합합니다. 내보내기의 일부로 제공되는 HTML 파일을 사용하여 Google 지도 또는 어스에서 타일을 쉽게 미리 볼 수 있습니다.
내보내기에는 여러 설정과 단계가 있으며, 타일을 사용하거나 게시하는 방법에 따라 필요할 수도 있고 필요하지 않을 수도 있습니다. 일부 매핑 플랫폼에서는 타일에 공개적으로 액세스할 수 있어야 하지만, 일부 플랫폼에서는 비공개 타일로도 작동합니다. Google 지도 API 중 하나를 사용하는 경우 Google Maps Platform API 키가 필요할 수 있습니다. Google 어스 또는 다른 매핑 플랫폼에 타일을 제공하는 경우 타일 사용 방식에 따라 적절한 액세스 수준 및 JS 액세스(CORS) 옵션을 설정해야 할 수 있습니다. 필수 설정은 아래의 플랫폼별 가이드라인 섹션을 참고하세요.
Cloud Storage로 지도 타일 내보내기
다음 예시에서는 캘리포니아 지역의 Landsat 이미지에서 타일을 내보냅니다.
코드 편집기(JavaScript)
// --- Example Export Map Tiles - basic --- // Specify area to clip/export, setup image and preview on map. var exportRegion = ee.Geometry.BBox(-122.9, 37.1, -121.2, 38.2); var landsatImage = ee.Image('LANDSAT/LC09/C02/T1_TOA/LC09_044034_20220111') .select(['B4', 'B3', 'B2']) .visualize({min: 0.02, max: 0.4, gamma: 1.2}) .clip(exportRegion); Map.addLayer(landsatImage, {}, 'landsatImage'); Map.centerObject(exportRegion); // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForEE', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true });
import ee import geemap.core as geemap
Colab(Python)
# --- Example Export Map Tiles - basic --- # Specify area to clip/export, setup image and preview on map. export_region = ee.Geometry.BBox(-122.9, 37.1, -121.2, 38.2) landsat_image = ( ee.Image('LANDSAT/LC09/C02/T1_TOA/LC09_044034_20220111') .select(['B4', 'B3', 'B2']) .visualize(min=0.02, max=0.4, gamma=1.2) .clip(export_region) ) m = geemap.Map() m.add_layer(landsat_image, {}, 'landsatImage') m.center_object(export_region) display(m) # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForEE', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, ) task.start()
이렇게 하면 지정된 Cloud Storage 버킷에 새 디렉터리가 생성되며, 기본적으로 description 매개변수에 따라 이름이 지정됩니다. path 매개변수를 사용하여 디렉터리 이름을 변경하거나 하위 디렉터리를 지정할 수 있습니다. 출력 디렉터리의 index.html 및 earth.html 파일을 사용하여 지도 또는 어스에서 타일을 미리 볼 수 있습니다.
ACL 및 CORS 옵션
위의 예에서는 직접 요청을 통해 공개적으로 액세스할 수 있도록 타일의 ACL(액세스 제어 목록)을 설정하지만 웹 앱이 액세스할 수 있도록 버킷의 JS 액세스(CORS 설정)를 설정하지는 않습니다.
즉, 내보낸 타일은 지도 및 어스 미리보기에서 볼 수 있지만 JS 액세스가 필요한 다른 플랫폼에서는 유용하지 않습니다. 출력 버킷의 소유자라고 가정합니다.
지정된 출력 버킷의 작성자(소유자가 아님)인 경우 writePublicTiles를 false로 설정하여 출력 버킷의 기본 객체 ACL을 사용합니다.
모든 웹 앱에서 타일에 공개적으로 액세스할 수 있도록 하려면 작업 매개변수에 bucketCorsUris: ['*']를 추가합니다. 서드 파티가 타일을 사용하여 클라우드 비용이 발생할 위험이 있는 경우 전체 공개 JS 액세스가 바람직하지 않을 수 있습니다. 이를 제한하려면 특정 도메인 또는 URL의 웹 앱으로만 JS 액세스를 제한하면 됩니다. JS 액세스(CORS) 설정은 폴더 또는 객체 수준이 아닌 전체 버킷 수준에서 적용됩니다.
ACL 및 CORS는 각각 writePublicTiles 및 bucketCorsUris 매개변수를 사용하거나 아래와 같이 내보내기 태스크 대화상자에서 설정할 수 있습니다.
Export.map.toCloudStorage() 작업 대화상자
- 보기/다운로드 액세스 코드 편집기 또는 Earth Engine 앱에서 액세스하려면 타일을 '공개적으로 액세스 가능'하게 만들어야 합니다.
- JS 액세스 코드 편집기, Earth Engine 앱 또는 기타 웹 앱이 타일에 액세스할 수 있도록 하려면 맵을 내보내는 버킷에서 가독성을 허용해야 합니다. 이러한 교차 출처 요청 설정(CORS)은 버킷 수준에서 구성해야 합니다. 편의를 위해 Earth Engine 내보내기 대화상자를 사용하면 내보내기 시 버킷에 CORS를 구성할 수 있습니다.
- 참고: JS 액세스/CORS 설정은 폴더 또는 객체 수준이 아닌 버킷 수준에서 적용되므로 설정을 변경하면 버킷의 모든 폴더와 객체에 대해 업데이트됩니다. 버킷의 현재 CORS 구성을 보는 방법을 포함하여 Cloud Storage CORS 문서에서 자세히 알아보세요.
매개변수 목록
다음은 지도 타일 내보내기 작업의 모든 매개변수 목록으로, 코드의 매개변수(인수) 이름과 작업 대화상자의 해당 필드(해당하는 경우)를 보여줍니다. 일부 필드는 상호 배타적입니다(예: maxzoom 및 scale). 자세한 내용은 Export.map 문서를 참고하세요.
| 코드의 인수 | 작업 대화상자의 필드 | 참고 |
|---|---|---|
| 이미지 | 해당 사항 없음 | 타일로 내보낼 이미지입니다. ImageCollection이 아닌 Image여야 합니다. |
| 설명 | 태스크 이름 | 인간이 읽을 수 있는 태스크 이름입니다. 기본값은 'myExportMapTask'입니다. 'path'(출력 프리픽스) 파라미터가 지정되지 않은 경우 타일의 폴더 이름으로도 사용됩니다. |
| 버킷 | GCS 버킷 이름 | 쓸 대상 버킷입니다. |
| fileFormat | 파일 형식 | 지도 타일의 파일 형식으로, 'auto', 'png', 'jpg' 중 하나입니다. 기본값은 'auto'입니다. 즉, 불투명 타일은 'jpg'로 인코딩되고 투명 타일은 'png'로 인코딩됩니다. |
| 경로 | 출력 프리픽스 | 출력 경로로 사용되는 문자열입니다. 후행 '/'는 선택사항입니다. 기본값은 작업 설명(작업 이름)입니다. |
| writePublicTiles | 액세스 수준 보기/다운로드 | 버킷의 기본 객체 ACL을 사용하는 대신 공개 타일을 쓸지 여부입니다. 기본값은 true이고 호출자는 버킷의 소유자입니다. |
| maxZoom | 최대 해상도 및 최대 확대/축소 | 내보낼 지도 타일의 최대 확대/축소 수준입니다. |
| 활용 | 최대 해상도 및 최대 배율 | 'maxZoom' 대신 픽셀당 미터 단위의 최대 이미지 해상도입니다. 축척은 적도에서 가장 적절한 최대 확대/축소 수준으로 변환됩니다. |
| minZoom | 최대 해상도 및 최소 확대/축소 | 내보낼 지도 타일의 최소 확대/축소 수준입니다(선택사항). 기본값은 0입니다. |
| 지역 | 해당 사항 없음 | 내보낼 리전을 나타내는 LinearRing, Polygon 또는 좌표입니다. 자세한 내용은 문서를 참고하세요. |
| skipEmptyTiles | 해당 사항 없음 | true인 경우 비어 있는(즉, 완전히 투명한) 지도 타일 쓰기를 건너뜁니다. 기본값은 false입니다. |
| mapsApiKey | Maps API 키 | index.html에서 Google 지도 API를 초기화하는 데 사용됩니다. 이렇게 하면 지도에서 '개발 목적으로만 사용' 메시지가 삭제됩니다. |
| bucketCorsUris | JS 액세스(및 허용할 웹사이트) 추가 | JavaScript(CORS)를 통해 내보낸 타일을 가져올 수 있는 도메인 목록(예: https://code.earthengine.google.com)입니다. |
배율 및 확대/축소
이전 예시에서는 maxZoom이 13로 설정되었습니다.
확대/축소 수준은 전 세계 지도를 표시하는 다양한 크기의 픽셀 그리드에 해당합니다. 자세한 내용은 픽셀 좌표 참조를 확인하세요. 지구의 곡률로 인해 특정 확대/축소 수준에서 픽셀의 해상도는 위도에 따라 달라집니다. 구체적으로, 픽셀당 미터는 cos(위도)만큼 감소합니다. 다음 표는 Google 메르카토르 도법의 적도에서 각 확대 수준의 픽셀당 미터를 보여줍니다.
| 확대/축소 수준 | 픽셀 크기(적도 기준) | 확대/축소 수준 | 픽셀 크기(적도 기준) |
|---|---|---|---|
| 0 | 156 km | 10 | 152 m |
| 1 | 78 km | 11 | 76 m |
| 2 | 39 km | 12 | 38분 |
| 3 | 20 km | 13 | 19분 |
| 4 | 10 km | 14 | 9.6 m |
| 5 | 4.9 km | 15 | 4.8 m |
| 6 | 2.4 km | 16 | 2.4 m |
| 7 | 1.2 km | 17 | 1.2 m |
| 8 | 611 m | 18 | 0.6 m |
| 9 | 305 m | 19 | 0.3 m |
| 20 | 0.15 m |
이전 표에서 예시에 설정된 maxZoom는 적도에서 19미터에 해당하며 위도가 높을수록 작아집니다. 이는 입력 이미지의 공칭 30초/픽셀 해상도보다 작습니다. 따라서 출력
index.html
에 표시된 지도는 기본 해상도의 픽셀이 지도에 표시될 때까지 확대할 수 있습니다.
지도 표시를 기본 픽셀 해상도로 제한하려면 maxZoom를 기본 해상도 이하에 해당하는 값으로 설정합니다.
플랫폼별 가이드라인
다음은 지도 타일을 보고 사용할 수 있는 여러 플랫폼입니다. 각 섹션에는 타일이 해당 플랫폼에서 작동하는 데 필요한 설정과 필요한 매개변수가 포함된 예시 코드의 사본이 표시됩니다.
Earth Engine에서 지도 타일 사용(코드 편집기 또는 EE 앱)
Google Earth Engine 또는 EE 앱에서 재사용하기 위해서만 지도 타일을 내보내려면 '액세스 수준'을 '공개적으로 액세스 가능'으로 설정하고 'JS 액세스 수준'(작업 대화상자)을 'Earth Engine 액세스 추가' 또는 '공개 액세스 추가'로 설정합니다. 또는 코드에서 다음 매개변수를 설정할 수 있습니다.
writePublicTiles: true, bucketCorsUris: ['https://code.earthengine.google.com','https://*.earthengine.app']
타일을 내보내면 Earth Engine에서 액세스할 수 있습니다.
코드 편집기(JavaScript)
// --- Export Map Tiles for use in EE --- // Use image setup code from example at top of the page. // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForEE', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true, bucketCorsUris: ['https://code.earthengine.google.com','https://*.earthengine.app'] });
import ee import geemap.core as geemap
Colab(Python)
# --- Export Map Tiles for use in EE --- # Use image setup code from example at top of the page. # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForEE', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, bucketCorsUris=[ 'https://code.earthengine.google.com', 'https://*.earthengine.app', ], ) task.start()
Google 지도 미리보기 보기
Google 지도에서 지도 타일을 미리 보려면 Google Cloud Storage의 출력 폴더로 이동하여 브라우저에서 'index.html' 파일을 엽니다. 그러면 다음과 같이 Google Maps Platform JavaScript API를 사용하여 Google 지도에 타일을 표시하는 전체 페이지 지도가 열립니다. index.html 기본 내보내기를 사용하면 비활성화되고 '개발 전용' 워터마크가 표시된 기본 지도 타일이 생성됩니다. 이 문제를 방지하고 표준 Google 기본 지도 타일을 표시하려면 API 키를 생성하여 내보내기 설정에 포함하세요.
내보내기 시 API 키를 제공하면 이 미리보기 페이지를 공개적으로 볼 수 있고 다른 페이지에 삽입할 수 있으며, 보는 사람이 등록된 Earth Engine 사용자일 필요가 없습니다.
코드 편집기(JavaScript)
// --- Export Map Tiles for use with Map Preview --- // Use image setup code from example at top of the page. // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForMapPreview', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true, mapsApiKey: 'fakeMapsApiKey012345' // replace with a valid API Key });
import ee import geemap.core as geemap
Colab(Python)
# --- Export Map Tiles for use with Map Preview --- # Use image setup code from example at top of the page. # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForMapPreview', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, mapsApiKey='fakeMapsApiKey012345', # replace with a valid API Key ) task.start()
Google 어스 미리보기
웹용 Google 어스에서 지도 타일을 미리 보려면 액세스 수준을 '공개적으로 액세스 가능'으로 설정하여 타일을 내보내야 합니다. 그런 다음 Google Cloud Storage의 출력 폴더로 이동하여 브라우저에서 'earth.html' 파일을 엽니다(예: earth.html ). 그런 다음 표시되는 'Google 어스에서 열기' 버튼을 클릭합니다. 이렇게 하면 Google 어스가 열리고 3D 지도에 타일이 표시됩니다. 'JS 액세스' 수준을 '공개적으로 액세스 가능'으로 설정하는 것도 좋습니다. 이렇게 하면 미리보기 파일 없이 Google 어스에서 타일을 사용할 수 있습니다(타일에 필요한 JS 액세스/CORS 설정이 없는 경우 프록시 서버를 사용함).
데이터 링크가 포함된 KML 파일을 다운로드하려면 Google 어스에서 점 3개 메뉴를 클릭하고 'KML 파일로 내보내기'를 선택합니다. 참고: 이 방식으로 생성된 KML 파일은 Google 어스 프로(데스크톱 버전 어스)와 호환되지 않습니다.
코드 편집기(JavaScript)
// --- Export Map Tiles for use with Earth Preview --- // Use image setup code from example at top of the page. // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForEarthPreview', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true, bucketCorsUris: [] // leaving blank is ok for Earth Preview only // for direct use in Earth, set to: ['https://earth.google.com'] // or set to public: ['*'] (risk of misuse) });
import ee import geemap.core as geemap
Colab(Python)
# --- Export Map Tiles for use with Earth Preview --- # Use image setup code from example at top of the page. # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForEarthPreview', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, bucketCorsUris=[], # leaving blank is ok for Earth Preview only # for direct use in Earth, set to: ['https://earth.google.com'] # or set to public: ['*'] (risk of misuse) ) task.start()
Google Maps Platform(지도 API)으로 게시
Google Maps Platform을 통해 공개적으로 게시할 수 있는 지도 타일 세트를 만들려면 API 키가 있거나 만들어야 하며 액세스 수준이 '공개적으로 액세스 가능'으로 설정되어 있는지 확인해야 합니다. 지도 API 애플리케이션이 타일에 액세스하는 방식에 따라 사이트에 적절한 'JS 액세스 수준'을 설정해야 할 수도 있습니다. 타일을 내보내면 코드 편집기 작업 탭의 출력에 Google 지도 API와 함께 사용할 수 있는 적절한 변수가 포함된 타일의 URL이 제공됩니다. 예를 들면 다음과 같습니다.
https://storage.googleapis.com/my_bucket/my_test_tiles/{Z}/{X}/{Y}
코드 편집기(JavaScript)
// --- Export Map Tiles for use with Maps Platform APIs --- // Use image setup code from example at top of the page. // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForMapsPlatform', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true, bucketCorsUris: ['*'], // '*' = All domains = risk of misuse // For better protection, specify the domain(s) where the // tiles will be used, eg: ['https://mysite.mydomain.com'] mapsApiKey: 'fakeMapsApiKey012345' // replace with a valid API Key });
import ee import geemap.core as geemap
Colab(Python)
# --- Export Map Tiles for use with Maps Platform APIs --- # Use image setup code from example at top of the page. # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForMapsPlatform', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, bucketCorsUris=['*'], # '*' = All domains = risk of misuse # For better protection, specify the domain(s) where the # tiles will be used, eg: ['https://mysite.mydomain.com'] mapsApiKey='fakeMapsApiKey012345', # replace with a valid API Key ) task.start()
Google 어스에 게시(웹)
Google 어스를 통해 공개적으로 게시할 지도 타일 세트를 만들려면 액세스 수준을 '공개적으로 액세스 가능'으로 설정하고 JS 액세스 수준을 'https://earth.google.com'(또는 '공개적으로 액세스 가능')을 허용하도록 설정해야 합니다. 내보내기 후에는 내보내기 디렉터리의 earth.html 파일을 사용하여 Google 어스에서 미리 볼 수 있습니다(위 참조).
코드 편집기(JavaScript)
// --- Export Map Tiles for use with Google Earth web --- // Use image setup code from example at top of the page. // Set up Export task. Export.map.toCloudStorage({ image: landsatImage, description: 'mapTilesForEarthWeb', bucket: 'yourBucketName', // replace with your GCS bucket name fileFormat: 'auto', maxZoom: 13, region: exportRegion, writePublicTiles: true, bucketCorsUris: ['https://earth.google.com'] // ['*'] will also work, but risks misuse });
import ee import geemap.core as geemap
Colab(Python)
# --- Export Map Tiles for use with Google Earth web --- # Use image setup code from example at top of the page. # Set up Export task. task = ee.batch.Export.map.toCloudStorage( image=landsat_image, description='mapTilesForEarthWeb', bucket='yourBucketName', # replace with your GCS bucket name fileFormat='auto', maxZoom=13, region=export_region, writePublicTiles=True, bucketCorsUris=['https://earth.google.com'], # ['*'] will also work, but risks misuse ) task.start()
타일을 내보낸 후 Google 어스 웹의 프로젝트에 추가할 수 있습니다. 코드 편집기 Tasks 탭의 출력(아래 표시)은 Google 어스에서 사용할 수 있는 적절한 변수가 포함된 타일의 URL을 제공합니다(예:
https://storage.googleapis.com/my_bucket/my_test_tiles/$[level]/$[x]/$[y]
).
어스 웹에서 이를 사용하려면 타일 오버레이 기능을 만들고 이 URL을 '오버레이 URL'로 추가합니다. 데이터 세트가 전역이 아니고 존재하지 않는 타일에 대한 타일 요청 오류를 방지하려면 '오버레이 옵션' 섹션을 열고 내보낸 타일의 범위와 일치하도록 네 가지 타일 적용 범위 매개변수를 조정해야 합니다.
다른 지도 플랫폼에 게시
다른 플랫폼이나 애플리케이션에서 사용할 타일을 내보낼 때 필요한 설정은 타일에 액세스하는 방식에 따라 달라집니다. 타일을 최대한 광범위하게 액세스할 수 있도록 하려면 액세스 수준을 '공개적으로 액세스 가능'으로 설정하고 JS 액세스 수준을 '공개적으로 액세스 가능'으로 설정합니다.
Google Maps Platform API 키 생성하기
Google Maps Platform에서 지도 타일을 사용하거나 개발자 제한 기본 지도 없이 지도에서 미리 보려면 Google Maps Platform API 키를 보유하거나 생성해야 하며, 이를 내보내기 설정에 포함하거나 나중에 사이트에 추가해야 합니다. Google 어스에서 사용하기 위해 이 작업이 필요하지는 않습니다.
Earth Engine에서 지도 타일을 내보내면 Google Maps Platform JavaScript API를 사용하여 타일을 미리 볼 수 있도록 출력 디렉터리에 저장된 샘플 HTML 페이지가 생성됩니다. 내보내기 시 Google Maps Platform API 키를 제공할 수 있으며, 이 키는 샘플 뷰어의 API 호출에 사용됩니다.
지금 Google Maps Platform API 키를 생성하려면 다음 네 단계를 따르세요.
- 아래의 'Maps Platform API 키 만들기' 버튼을 클릭합니다.
- API 키의 Cloud 프로젝트를 선택하고 '다음'을 클릭합니다.
- 를 클릭하여 새 키를 복사하고 코드 편집기의 지도 내보내기 대화상자에 붙여넣습니다.
- (권장) 새 키 아래의 API 콘솔 링크를 클릭하여 리퍼러 제한을 설정합니다. 자세한 내용은 리퍼러 및 애플리케이션 제한사항을 참고하세요.
API 키에 리퍼러 제한사항 추가
API 키를 추가할 때 리퍼러 제한사항을 사용하면 지정된 앱만 키를 사용할 수 있습니다. Cloud 콘솔의 사용자 인증 정보 페이지를 방문하여 다음 단계에 따라 언제든지 리퍼러 제한을 설정하거나 수정할 수 있습니다.
- 화면 상단의 드롭다운에서 올바른 프로젝트 이름이 선택되어 있는지 확인합니다.
- 위에서 생성된 Maps Platform API 키를 클릭하여 키의 세부정보를 확인합니다.
-
HTTP 리퍼러(웹사이트)를 선택하고 다음 템플릿을 사용하여
Export.map.toCloudStorage에 지정된 Cloud Storage 버킷을 지정합니다.https://storage.googleapis.com/{bucket}/* - 저장을 클릭합니다. '저장 중…' 표시기가 나타납니다.