Stay organized with collectionsSave and categorize content based on your preferences.
Loads a GeoTIFF as an Image.
Usage
Returns
ee.Image.loadGeoTIFF(uri)
Image
Argument
Type
Details
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-27 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```"]]
