ee.Image.getDownloadURL

Dapatkan URL download untuk potongan kecil data gambar dalam format GeoTIFF atau NumPy. Ukuran permintaan maksimum adalah 32 MB, dimensi petak maksimum adalah 10000.

Gunakan getThumbURL untuk format visualisasi RGB PNG dan JPG.

Returns menampilkan URL download, atau belum ditentukan jika callback ditentukan.

Penggunaan	Hasil
Image.getDownloadURL(params, callback)	Object|String

Argumen	Jenis	Detail
ini: image	Gambar	Instance Gambar.
params	Objek	Objek yang berisi opsi download dengan kemungkinan nilai berikut: name: nama dasar yang akan digunakan saat membuat nama file. Hanya berlaku jika formatnya adalah "ZIPPED_GEO_TIFF" (default) atau filePerBand benar. Secara default, ID gambar (atau "download" untuk gambar yang dikomputasi) jika formatnya adalah "ZIPPED_GEO_TIFF" atau filePerBand bernilai benar, jika tidak, string karakter acak akan dibuat. Nama band ditambahkan jika filePerBand bernilai benar (true). bands: deskripsi band yang akan didownload. Harus berupa array nama band atau array kamus, masing-masing dengan kunci berikut (parameter opsional hanya berlaku jika filePerBand bernilai benar): id: nama band, string, wajib diisi. crs: string CRS opsional yang menentukan proyeksi band. crs_transform: array 6 angka opsional yang menentukan transformasi affine dari CRS yang ditentukan, dalam urutan baris-utama: [xScale, xShearing, xTranslation, yShearing, yScale, yTranslation] dimensions: array opsional dari dua bilangan bulat yang menentukan lebar dan tinggi yang digunakan untuk memangkas rentang. scale: angka opsional, yang menentukan skala dalam meter dari band; diabaikan jika crs dan crs_transform ditentukan. crs: string CRS default untuk digunakan pada band apa pun yang tidak secara eksplisit menentukannya. crs_transform: transformasi affine default untuk digunakan pada setiap band yang tidak menentukannya, dengan format yang sama seperti crs_transform band. Dimensi pemangkasan gambar default dimensions: yang akan digunakan untuk setiap band yang tidak menentukannya. scale: skala default yang akan digunakan untuk setiap rentang yang tidak menentukannya; diabaikan jika crs dan crs_transform ditentukan. region: poligon yang menentukan region untuk didownload; diabaikan jika crs dan crs_transform ditentukan. filePerBand: apakah akan menghasilkan GeoTIFF terpisah per band (boolean). Nilai defaultnya adalah true (benar). Jika salah (false), satu GeoTIFF akan dihasilkan dan semua transformasi tingkat band akan diabaikan. format: format download. Salah satu dari: "ZIPPED_GEO_TIFF" (File GeoTIFF yang di-zip, default) "GEO_TIFF" (file GeoTIFF) "NPY" (format biner NumPy) Jika "GEO_TIFF" atau "NPY", filePerBand dan semua transformasi tingkat band akan diabaikan. Memuat output NumPy menghasilkan array terstruktur.
callback	Fungsi, opsional	Callback opsional. Jika tidak diberikan, panggilan dilakukan secara sinkron.

Contoh

Code Editor (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'
  }));

Penyiapan Python

Lihat halaman Lingkungan Python untuk mengetahui informasi tentang Python API dan penggunaan geemap untuk pengembangan interaktif.

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)