ee.Image.getDownloadURL

Nhận URL tải xuống cho các khối dữ liệu hình ảnh nhỏ ở định dạng GeoTIFF hoặc NumPy. Kích thước yêu cầu tối đa là 32 MB, kích thước lưới tối đa là 10000.

Sử dụng getThumbURL cho các định dạng trực quan hoá RGB là PNG và JPG.

Trả về một URL tải xuống hoặc không xác định nếu bạn chỉ định một lệnh gọi lại.

Cách sử dụngGiá trị trả về
Image.getDownloadURL(params, callback)Đối tượng|Chuỗi
Đối sốLoạiThông tin chi tiết
this: imageHình ảnhĐối tượng Image.
paramsĐối tượngMột đối tượng chứa các lựa chọn tải xuống với các giá trị có thể có sau đây:
name: tên cơ sở để sử dụng khi tạo tên tệp. Chỉ áp dụng khi định dạng là "ZIPPED_GEO_TIFF" (mặc định) hoặc filePerBand là true. Mặc định là mã nhận dạng hình ảnh (hoặc "download" cho hình ảnh được tính toán) khi định dạng là "ZIPPED_GEO_TIFF" hoặc filePerBand là true, nếu không, một chuỗi ký tự ngẫu nhiên sẽ được tạo. Tên dải tần được thêm vào khi filePerBand là true.
bands: nội dung mô tả về các dải tần cần tải xuống. Phải là một mảng tên dải tần hoặc một mảng từ điển, mỗi từ điển có các khoá sau (các tham số không bắt buộc chỉ áp dụng khi filePerBand là true):
  • id: tên của ban nhạc, một chuỗi, bắt buộc.
  • crs: là một chuỗi CRS không bắt buộc, xác định phép chiếu băng tần.
  • crs_transform: một mảng gồm 6 số không bắt buộc, chỉ định một phép biến đổi á-phin từ CRS đã chỉ định, theo thứ tự hàng chính: [xScale, xShearing, xTranslation, yShearing, yScale, yTranslation]
  • dimensions: một mảng không bắt buộc gồm 2 số nguyên xác định chiều rộng và chiều cao mà dải này được cắt.
  • scale: một số tuỳ chọn, chỉ định tỷ lệ theo mét của dải tần; bị bỏ qua nếu bạn chỉ định crs và crs_transform.
crs: một chuỗi CRS mặc định để sử dụng cho mọi dải tần không chỉ định rõ một chuỗi CRS.
crs_transform: một phép biến đổi á-phin mặc định để dùng cho mọi dải tần không chỉ định một phép biến đổi, có cùng định dạng với crs_transform của dải tần.
dimensions: kích thước mặc định để cắt hình ảnh cho mọi dải tần không chỉ định kích thước.
scale: một tỷ lệ mặc định để sử dụng cho mọi dải tần không chỉ định tỷ lệ; bị bỏ qua nếu bạn chỉ định crs và crs_transform.
region: một đa giác chỉ định khu vực cần tải xuống; bị bỏ qua nếu bạn chỉ định crs và crs_transform.
filePerBand: có tạo GeoTIFF riêng cho mỗi dải tần hay không (boolean). Giá trị mặc định là đúng. Nếu là false, một GeoTIFF duy nhất sẽ được tạo và tất cả các phép biến đổi ở cấp dải tần sẽ bị bỏ qua.
format: định dạng tải xuống. Một trong các lựa chọn sau:
  • "ZIPPED_GEO_TIFF" (Tệp GeoTIFF được gói trong một tệp ZIP, mặc định)
  • "GEO_TIFF" (Tệp GeoTIFF)
  • "NPY" (định dạng nhị phân NumPy)
Nếu là "GEO_TIFF" hoặc "NPY", filePerBand và mọi phép biến đổi ở cấp dải tần sẽ bị bỏ qua. Việc tải một kết quả đầu ra của NumPy sẽ tạo ra một mảng có cấu trúc.
callbackHàm, không bắt buộcMột lệnh gọi lại không bắt buộc. Nếu không được cung cấp, lệnh gọi sẽ được thực hiện đồng bộ.

Ví dụ

Trình soạn thảo mã (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'
  }));

Thiết lập Python

Hãy xem trang Môi trường Python để biết thông tin về API Python và cách sử dụng geemap cho quá trình phát triển tương tác.

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)