Anúncio: todos os projetos não comerciais registrados para usar o Earth Engine antes de
15 de abril de 2025 precisam
verificar a qualificação não comercial para manter o acesso ao Earth Engine.
ee.Image.loadGeoTIFF
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Carrega um GeoTIFF como uma imagem.
| Uso | Retorna |
|---|
ee.Image.loadGeoTIFF(uri) | Imagem |
| Argumento | Tipo | Detalhes |
|---|
uri | String | O URI do Cloud Storage do GeoTIFF a ser carregado. Os metadados do bucket precisam ser acessíveis (requer a permissão "storage.buckets.get", que é fornecida pela função "Leitor de bucket legados do Storage", entre outras. Consulte https://cloud.google.com/storage/docs/access-control/iam-roles). O bucket também precisa estar localizado na multirregião dos EUA, em uma região dupla, incluindo US-CENTRAL1, ou na região US-CENTRAL1. |
Exemplos
Editor de código (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);
Configuração do Python
Consulte a página
Ambiente Python para informações sobre a API Python e o uso de
geemap para desenvolvimento interativo.
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
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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```"]]
