ee.data.getPixels (Python only)

Busca pixels de um recurso de imagem.

Retorna: Os pixels como dados de imagem brutos.

UsoRetorna
ee.data.getPixels(params)Objeto|Valor
ArgumentoTipoDetalhes
paramsObjetoUm objeto que contém parâmetros com os seguintes valores possíveis:
assetId: o ID do recurso para o qual os pixels serão recebidos. Precisa ser um recurso de imagem.
fileFormat: o formato do arquivo resultante. O padrão é png. Consulte ImageFileFormat para ver os formatos disponíveis. Há outros formatos que convertem o objeto baixado em um objeto de dados do Python. São elas: NUMPY_NDARRAY, que converte em uma matriz NumPy estruturada.
grid: parâmetros que descrevem a grade de pixels em que os dados serão buscados. O padrão é a grade de pixels nativa dos dados.
region: se presente, a região de dados a ser retornada, especificada como um objeto de geometria GeoJSON (consulte RFC 7946).
bandIds: se presente, especifica um conjunto específico de bandas de onde os pixels serão extraídos.
visualizationOptions: se presente, um conjunto de opções de visualização a serem aplicadas para produzir uma visualização RGB de 8 bits dos dados, em vez de retornar os dados brutos.

Exemplos

Configuração do Python

Consulte a página Ambiente Python para informações sobre a API Python e como usar geemap para desenvolvimento interativo.

import ee
import geemap.core as geemap

Colab (Python)

# Region of interest.
coords = [
    -121.58626826832939,
    38.059141484827485,
]
region = ee.Geometry.Point(coords)

# Get a Sentinel-2 image.
image = (ee.ImageCollection('COPERNICUS/S2')
  .filterBounds(region)
  .filterDate('2020-04-01', '2020-09-01')
  .sort('CLOUD_COVERAGE_ASSESSMENT')
  .first())
image_id = image.getInfo()['id']

# Make a projection to discover the scale in degrees.
proj = ee.Projection('EPSG:4326').atScale(10).getInfo()

# Get scales out of the transform.
scale_x = proj['transform'][0]
scale_y = -proj['transform'][4]

# Make a request object.
request = {
    'assetId': image_id,
    'fileFormat': 'PNG',
    'bandIds': ['B4', 'B3', 'B2'],
    'grid': {
        'dimensions': {
            'width': 640,
            'height': 640
        },
        'affineTransform': {
            'scaleX': scale_x,
            'shearX': 0,
            'translateX': coords[0],
            'shearY': 0,
            'scaleY': scale_y,
            'translateY': coords[1]
        },
        'crsCode': proj['crs'],
    },
    'visualizationOptions': {'ranges': [{'min': 0, 'max': 3000}]},
}

image_png = ee.data.getPixels(request)
# Do something with the image...