ee.data.getDownloadId

Lấy mã nhận dạng lượt tải xuống.

Trả về mã nhận dạng và mã thông báo tải xuống hoặc giá trị rỗng nếu bạn chỉ định một lệnh gọi lại.

Cách sử dụngGiá trị trả về
ee.data.getDownloadId(params, callback)DownloadId
Đối sốLoạiThông tin chi tiết
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), "ZIPPED_GEO_TIFF_PER_BAND" hoặc filePerBand là true. Mặc định là mã nhận dạng hình ảnh (hoặc "download" đối với hình ảnh được tính toán) khi định dạng là "ZIPPED_GEO_TIFF", "ZIPPED_GEO_TIFF_PER_BAND" 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. Xin lưu ý rằng thông tin này sẽ bị bỏ qua nếu định dạng là "ZIPPED_GEO_TIFF" hoặc "ZIPPED_GEO_TIFF_PER_BAND".
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 tệp zip, mặc định)
  • "ZIPPED_GEO_TIFF_PER_BAND" (Nhiều tệp GeoTIFF được gói trong một tệp zip)
  • "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.
id: không được dùng nữa, hãy sử dụng tham số hình ảnh.
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);

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));

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.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)