ee.Image.getDownloadURL

GeoTIFF veya NumPy biçimindeki küçük resim verileri parçaları için indirme URL'si alın. Maksimum istek boyutu 32 MB, maksimum ızgara boyutu ise 10.000'dir.

RGB görselleştirme biçimleri PNG ve JPG için getThumbURL'yi kullanın.

Bir indirme URL'si döndürür veya geri çağırma belirtilmişse tanımsız (undefined) değerini döndürür.

Kullanım	İadeler
Image.getDownloadURL(params, callback)	Nesne|Dize

Bağımsız Değişken	Tür	Ayrıntılar
bu: image	Resim	Image örneği.
params	Nesne	Aş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) olduğunda veya filePerBand doğru olduğunda geçerlidir. Biçim "ZIPPED_GEO_TIFF" 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. format: indirme biçimi. Şunlardan biri: "ZIPPED_GEO_TIFF" (ZIP dosyasına sarılmış GeoTIFF dosyaları, varsayılan) "GEO_TIFF" (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.
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);

print('Single-band GeoTIFF files wrapped in a zip file',
  img.getDownloadURL({
    name: 'single_band',
    bands: ['B3', 'B8', 'B11'],
    region: region
  }));

print('Multi-band GeoTIFF file wrapped in a zip file',
  img.getDownloadURL({
    name: 'multi_band',
    bands: ['B3', 'B8', 'B11'],
    region: region,
    scale: 20,
    filePerBand: false
  }));

print('Band-specific transformations',
  img.getDownloadURL({
    name: 'custom_single_band',
    bands: [
      {id: 'B3', scale: 10},
      {id: 'B8', scale: 10},
      {id: 'B11', scale: 20}
    ],
    region: region
  }));

print('Multi-band GeoTIFF file',
  img.getDownloadURL({
    bands: ['B3', 'B8', 'B11'],
    region: region,
    scale: 20,
    format: 'GEO_TIFF'
  }));

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.Image.getDownloadURL 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
url = img.getDownloadUrl({
    'bands': ['B3', 'B8', 'B11'],
    'region': region,
    'scale': 20,
    'format': 'NPY'
})
response = requests.get(url)
data = numpy.load(io.BytesIO(response.content))
print(data)
print(data.dtype)

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

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

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

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