공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해
비상업용 자격 요건을 인증해야 합니다.
ee.Image.loadGeoTIFF
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
GeoTIFF를 이미지로 로드합니다.
| 사용 | 반환 값 |
|---|
ee.Image.loadGeoTIFF(uri) | 이미지 |
| 인수 | 유형 | 세부정보 |
|---|
uri | 문자열 | 로드할 GeoTIFF의 Cloud Storage URI입니다. 버킷 메타데이터에 액세스할 수 있어야 합니다('Storage Legacy Bucket Reader' 역할에서 제공하는 `storage.buckets.get` 권한 필요, https://cloud.google.com/storage/docs/access-control/iam-roles 참고). 또한 버킷이 미국 멀티 리전, US-CENTRAL1을 포함한 이중 리전 또는 US-CENTRAL1 리전에 있어야 합니다. |
예
코드 편집기 (JavaScript)
var uri = 'gs://gcp-public-data-landsat/LC08/01/001/002/' +
'LC08_L1GT_001002_20160817_20170322_01_T2/' +
'LC08_L1GT_001002_20160817_20170322_01_T2_B5.TIF';
var cloudImage = ee.Image.loadGeoTIFF(uri);
print(cloudImage);
Map.addLayer(cloudImage, {min: 0, max: 20000});
Map.centerObject(cloudImage, 6);
Python 설정
Python API 및 대화형 개발을 위한 geemap 사용에 관한 자세한 내용은
Python 환경 페이지를 참고하세요.
import ee
import geemap.core as geemap
Colab (Python)
uri = (
'gs://gcp-public-data-landsat/'
+ 'LC08/01/001/002/'
+ 'LC08_L1GT_001002_20160817_20170322_01_T2/'
+ 'LC08_L1GT_001002_20160817_20170322_01_T2_B5.TIF'
)
cloud_image = ee.Image.loadGeoTIFF(uri)
display(cloud_image)
m = geemap.Map()
m.add_layer(cloud_image, {'min': 0, 'max': 20000})
m.center_object(cloud_image, 6)
m
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003e\u003ccode\u003eee.Image.loadGeoTIFF\u003c/code\u003e loads a Cloud Storage-hosted GeoTIFF file as an \u003ccode\u003eee.Image\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe function takes a single argument, \u003ccode\u003euri\u003c/code\u003e, which specifies the Cloud Storage location of the GeoTIFF.\u003c/p\u003e\n"],["\u003cp\u003eExamples demonstrate loading and displaying a Landsat 8 GeoTIFF from the public data catalog in both JavaScript and Python.\u003c/p\u003e\n"]]],["The function `ee.Image.loadGeoTIFF(uri)` loads a GeoTIFF from a Cloud Storage URI as an `Image`. The `uri` must be a string pointing to a GeoTIFF file in a supported Google Cloud Storage bucket, requiring specific access permissions. Example code is provided for both JavaScript and Python, demonstrating loading, printing, and displaying the GeoTIFF. The Python code uses `geemap` for interactive development. The loaded image can then be used in further processing and analysis.\n"],null,["# ee.Image.loadGeoTIFF\n\nLoads a GeoTIFF as an Image.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------|---------|\n| `ee.Image.loadGeoTIFF(uri)` | Image |\n\n| Argument | Type | Details |\n|----------|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `uri` | String | The Cloud Storage URI of the GeoTIFF to load. The bucket metadata must be accessible (requires the \\`storage.buckets.get\\` permission which is provided by the role \"Storage Legacy Bucket Reader\" among others, see https://cloud.google.com/storage/docs/access-control/iam-roles) and the bucket must be located in the US multi-region, a dual-region including US-CENTRAL1, or the US-CENTRAL1 region. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\nvar uri = 'gs://gcp-public-data-landsat/LC08/01/001/002/' +\n 'LC08_L1GT_001002_20160817_20170322_01_T2/' +\n 'LC08_L1GT_001002_20160817_20170322_01_T2_B5.TIF';\nvar cloudImage = ee.Image.loadGeoTIFF(uri);\n\nprint(cloudImage);\n\nMap.addLayer(cloudImage, {min: 0, max: 20000});\nMap.centerObject(cloudImage, 6);\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\nuri = (\n 'gs://gcp-public-data-landsat/'\n + 'LC08/01/001/002/'\n + 'LC08_L1GT_001002_20160817_20170322_01_T2/'\n + 'LC08_L1GT_001002_20160817_20170322_01_T2_B5.TIF'\n)\ncloud_image = ee.Image.loadGeoTIFF(uri)\n\ndisplay(cloud_image)\n\nm = geemap.Map()\nm.add_layer(cloud_image, {'min': 0, 'max': 20000})\nm.center_object(cloud_image, 6)\nm\n```"]]
