ee.data.getPixels (Python only)

Récupère les pixels d'un composant Image.

Renvoie les pixels sous forme de données d'image brutes.

Utilisation	Renvoie
ee.data.getPixels(params)	Objet|Valeur

Argument	Type	Détails
params	Objet	Objet contenant des paramètres avec les valeurs possibles suivantes : assetId : ID de l'asset pour lequel obtenir les pixels. Doit être un composant Image. fileFormat : format du fichier obtenu. La valeur par défaut est "png". Consultez ImageFileFormat pour connaître les formats disponibles. Il existe d'autres formats qui convertissent l'objet téléchargé en objet de données Python. Par exemple, NUMPY_NDARRAY est converti en tableau NumPy structuré. grid : paramètres décrivant la grille de pixels dans laquelle récupérer les données. La valeur par défaut est la grille de pixels native des données. region : si elle est présente, la région de données à renvoyer, spécifiée sous la forme d'un objet de géométrie GeoJSON (voir RFC 7946). bandIds : si cet élément est présent, il spécifie un ensemble de bandes à partir desquelles obtenir des pixels. visualizationOptions : ensemble d'options de visualisation à appliquer, le cas échéant, pour produire une visualisation RVB 8 bits des données, plutôt que de renvoyer les données brutes.

Exemples

Configuration de Python

Consultez la page Environnement Python pour en savoir plus sur l'API Python et sur l'utilisation de geemap pour le développement interactif.

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...