ee.data.getDownloadId

İndirme kimliği alma

Bir geri çağırma belirtilmişse indirme kimliği ve jetonu veya boş değer döndürür.

Kullanımİadeler
ee.data.getDownloadId(params, callback)DownloadId
Bağımsız DeğişkenTürAyrıntılar
paramsNesneAşağıdaki olası değerleri içeren indirme seçeneklerini içeren bir nesne:
name: Dosya adları oluşturulurken kullanılacak bir temel ad. Yalnızca biçim "ZIPPED_GEO_TIFF" (varsayılan), "ZIPPED_GEO_TIFF_PER_BAND" olduğunda veya filePerBand doğru olduğunda geçerlidir. Biçim "ZIPPED_GEO_TIFF", "ZIPPED_GEO_TIFF_PER_BAND" olduğunda veya filePerBand doğru olduğunda varsayılan olarak resim kimliği (hesaplanmış resimler için "download") kullanılır. Aksi takdirde rastgele bir karakter dizesi oluşturulur. Band names are appended when filePerBand is true.
bands: İndirilecek bantların açıklaması. Grup adlarından oluşan bir dizi veya her biri aşağıdaki anahtarlara sahip sözlüklerden oluşan bir dizi olmalıdır (isteğe bağlı parametreler yalnızca filePerBand doğru olduğunda geçerlidir):
  • id: grubun adı (dize, zorunlu).
  • crs: Bant projeksiyonunu tanımlayan isteğe bağlı bir CRS dizesi.
  • crs_transform: Belirtilen CRS'den satır öncelikli sırada bir afin dönüşümü belirten 6 sayılık isteğe bağlı bir dizi: [xScale, xShearing, xTranslation, yShearing, yScale, yTranslation]
  • dimensions: , bandın kırpılacağı genişliği ve yüksekliği tanımlayan isteğe bağlı iki tam sayı dizisi.
  • scale: , isteğe bağlı bir sayıdır. Bandın metre cinsinden ölçeğini belirtir. crs ve crs_transform belirtilmişse yoksayılır.
crs: Açıkça belirtilmeyen bantlar için kullanılacak varsayılan bir CRS dizesi.
crs_transform: Bantların crs_transform ile aynı biçimde olan ve belirtilmeyen tüm bantlar için kullanılacak varsayılan bir afin dönüşümü.
dimensions: , boyutları belirtilmeyen bantlar için kullanılacak varsayılan resim kırpma boyutları.
scale: ölçek belirtmeyen bantlar için kullanılacak varsayılan ölçek; crs ve crs_transform belirtilirse yoksayılır.
region: : İndirilecek bölgeyi belirten bir poligon. crs ve crs_transform belirtilmişse yoksayılır.
filePerBand: Bant başına ayrı bir GeoTIFF oluşturulup oluşturulmayacağı (boolean). Varsayılan olarak true değerine ayarlanır. Yanlış ise tek bir GeoTIFF oluşturulur ve bant düzeyindeki tüm dönüşümler yoksayılır. Biçim "ZIPPED_GEO_TIFF" veya "ZIPPED_GEO_TIFF_PER_BAND" ise bu değerin yoksayıldığını unutmayın.
format: indirme biçimi. Şunlardan biri:
  • "ZIPPED_GEO_TIFF" (ZIP dosyasına sarılmış GeoTIFF dosyası, varsayılan)
  • "ZIPPED_GEO_TIFF_PER_BAND" (Bir zip dosyasına sarılmış birden fazla GeoTIFF dosyası)
  • "NPY" (NumPy ikili biçimi)
"GEO_TIFF" veya "NPY" ise filePerBand ve tüm bant düzeyindeki dönüşümler yoksayılır. NumPy çıktısı yüklemek, yapılandırılmış bir diziyle sonuçlanır.
id: desteği sonlandırıldı, image parametresini kullanın.
callbackİşlev, isteğe bağlıİsteğe bağlı geri arama. Sağlanmazsa arama senkronize olarak yapılır.

Örnekler

Kod Düzenleyici (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));

Python kurulumu

Python API'si ve etkileşimli geliştirme için geemap kullanımı hakkında bilgi edinmek üzere Python Ortamı sayfasına bakın.

import ee
import geemap.core as geemap

Colab (Python)

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

import io
import requests
import ee


ee.Authenticate()
ee.Initialize()

# 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.
import numpy
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))
print(data)
print(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)