Earth Engine presenta niveles de cuotas no comerciales para proteger los recursos de procesamiento compartidos y garantizar un rendimiento confiable para todos. Todos los proyectos no comerciales deberán seleccionar un nivel de cuota antes del 27 de abril de 2026 o usarán el nivel Comunidad de forma predeterminada. Las cuotas de nivel entrarán en vigencia para todos los proyectos (independientemente de la fecha de selección del nivel) el 27 de abril de 2026. Obtén más información.

ee.data.getDownloadId

Obtén un ID de descarga.

Devuelve un ID y un token de descarga, o bien un valor nulo si se especifica una devolución de llamada.

Uso	Muestra
`ee.data.getDownloadId(params, callback)`	DownloadId

Argumento Tipo Detalles

params

Objeto

Objeto que contiene opciones de descarga con los siguientes valores posibles:

name: un nombre base para usar cuando se construyen nombres de archivos Solo se aplica cuando el formato es "ZIPPED_GEO_TIFF" (predeterminado), "ZIPPED_GEO_TIFF_PER_BAND" o filePerBand es verdadero. De forma predeterminada, se establece el ID de la imagen (o "download" para las imágenes calculadas) cuando el formato es "ZIPPED_GEO_TIFF", "ZIPPED_GEO_TIFF_PER_BAND" o filePerBand es verdadero. De lo contrario, se genera una cadena de caracteres aleatoria. Los nombres de las bandas se agregan cuando filePerBand es verdadero.

bands: una descripción de las bandas que se descargarán. Debe ser un array de nombres de bandas o un array de diccionarios, cada uno con las siguientes claves (los parámetros opcionales solo se aplican cuando filePerBand es verdadero):

id: el nombre de la banda, una cadena obligatoria
crs: , una cadena de CRS opcional que define la proyección de la banda.
crs_transform: : Es un array opcional de 6 números que especifican una transformación afín desde el SRC especificado, en orden de fila principal: [xScale, xShearing, xTranslation, yShearing, yScale, yTranslation].
dimensions: un array opcional de dos números enteros que definen el ancho y la altura a los que se recorta la banda.
scale: : Es un número opcional que especifica la escala en metros de la banda. Se ignora si se especifican crs y crs_transform.

crs: una cadena de CRS predeterminada para usar en cualquier banda que no especifique una de forma explícita.

crs_transform: : Es una transformación afín predeterminada que se usará para cualquier banda que no especifique una, con el mismo formato que el crs_transform de las bandas.

Dimensiones de recorte de imagen predeterminadas de dimensions: para usar en cualquier banda que no las especifique.

scale: una escala predeterminada para usar en cualquier banda que no especifique una; se ignora si se especifican crs y crs_transform.

region: : Es un polígono que especifica una región para descargar. Se ignora si se especifican crs y crs_transform.

filePerBand: Indica si se debe generar un archivo GeoTIFF independiente por banda (booleano). El valor predeterminado es verdadero. Si es falso, se producirá un solo GeoTIFF y se ignorarán todas las transformaciones a nivel de la banda. Ten en cuenta que este parámetro se ignora si el formato es "ZIPPED_GEO_TIFF" o "ZIPPED_GEO_TIFF_PER_BAND".

format: el formato de descarga. Uno de los siguientes:

"ZIPPED_GEO_TIFF" (archivo GeoTIFF incluido en un archivo ZIP, opción predeterminada)
"ZIPPED_GEO_TIFF_PER_BAND" (varios archivos GeoTIFF incluidos en un archivo zip)
"NPY" (formato binario de NumPy)

Si es "GEO_TIFF" o "NPY", se ignorarán filePerBand y todas las transformaciones a nivel de la banda. La carga de un resultado de NumPy genera un array estructurado.

id: está obsoleto. Usa el parámetro image.

callback Función, opcional Es una devolución de llamada opcional. Si no se proporciona, la llamada se realiza de forma síncrona.

Ejemplos

Editor de código (JavaScript)

// A Sentinel-2 surface reflectance image.
var img = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG');

// A small region within the image.
var region = ee.Geometry.BBox(-122.0859, 37.0436, -122.0626, 37.0586);

var downloadId = ee.data.getDownloadId({
    image: img,
    name: 'single_band',
    bands: ['B3', 'B8', 'B11'],
    region: region
});
print('Single-band GeoTIFF files wrapped in a zip file',
      ee.data.makeDownloadUrl(downloadId));

var downloadId = ee.data.getDownloadId({
  image: img,
  name: 'multi_band',
  bands: ['B3', 'B8', 'B11'],
  region: region,
  scale: 20,
  filePerBand: false
});
print('Multi-band GeoTIFF file wrapped in a zip file',
      ee.data.makeDownloadUrl(downloadId));

var downloadId = ee.data.getDownloadId({
  image: img,
  name: 'custom_single_band',
  bands: [
    {id: 'B3', scale: 10},
    {id: 'B8', scale: 10},
    {id: 'B11', scale: 20}
  ],
  region: region
});
print('Band-specific transformations',
      ee.data.makeDownloadUrl(downloadId));

var downloadId = ee.data.getDownloadId({
  image: img,
  bands: ['B3', 'B8', 'B11'],
  region: region,
  scale: 20,
  format: 'GEO_TIFF'
});
print('Multi-band GeoTIFF file',
      ee.data.makeDownloadUrl(downloadId));

Configuración de Python

Consulta la página Entorno de Python para obtener información sobre la API de Python y el uso de geemap para el desarrollo interactivo.

import ee
import geemap.core as geemap

Colab (Python)

"""Demonstrates the ee.data.getDownloadId method."""

import io

import numpy
import requests

# A Sentinel-2 surface reflectance image.
img = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG')

# A small region within the image.
region = ee.Geometry.BBox(-122.0859, 37.0436, -122.0626, 37.0586)

# Image chunk as a NumPy structured array.
download_id = ee.data.getDownloadId({
    'image': img,
    'bands': ['B3', 'B8', 'B11'],
    'region': region,
    'scale': 20,
    'format': 'NPY'
})
response = requests.get(ee.data.makeDownloadUrl(download_id))
data = numpy.load(io.BytesIO(response.content))
display(data)
display(data.dtype)

# Single-band GeoTIFF files wrapped in a zip file.
download_id = ee.data.getDownloadId({
    'image': img,
    'name': 'single_band',
    'bands': ['B3', 'B8', 'B11'],
    'region': region
})
response = requests.get(ee.data.makeDownloadUrl(download_id))
with open('single_band.zip', 'wb') as fd:
  fd.write(response.content)

# Multi-band GeoTIFF file wrapped in a zip file.
download_id = ee.data.getDownloadId({
    'image': img,
    'name': 'multi_band',
    'bands': ['B3', 'B8', 'B11'],
    'region': region,
    'scale': 20,
    'filePerBand': False
})
response = requests.get(ee.data.makeDownloadUrl(download_id))
with open('multi_band.zip', 'wb') as fd:
  fd.write(response.content)

# Band-specific transformations.
download_id = ee.data.getDownloadId({
    'image': img,
    'name': 'custom_single_band',
    'bands': [
        {'id': 'B3', 'scale': 10},
        {'id': 'B8', 'scale': 10},
        {'id': 'B11', 'scale': 20}
    ],
    'region': region
})
response = requests.get(ee.data.makeDownloadUrl(download_id))
with open('custom_single_band.zip', 'wb') as fd:
  fd.write(response.content)

# Multi-band GeoTIFF file.
download_id = ee.data.getDownloadId({
    'image': img,
    'bands': ['B3', 'B8', 'B11'],
    'region': region,
    'scale': 20,
    'format': 'GEO_TIFF'
})
response = requests.get(ee.data.makeDownloadUrl(download_id))
with open('multi_band.tif', 'wb') as fd:
  fd.write(response.content)

ee.data.getDownloadId Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Ejemplos

Editor de código (JavaScript)

Colab (Python)

ee.data.getDownloadId