ee.data.getDownloadId

شناسه دانلود دریافت کنید.

شناسه بارگیری و رمز را برمی‌گرداند یا در صورت مشخص شدن پاسخ تماس، باطل می‌شود.

استفاده برمی گرداند
ee.data.getDownloadId(params, callback ) شناسه دانلود
استدلال تایپ کنید جزئیات
params شیء یک شی حاوی گزینه های دانلود با مقادیر ممکن زیر:
name: یک نام پایه برای استفاده در هنگام ساخت نام فایل. فقط زمانی قابل اجرا است که قالب «ZIPPED_GEO_TIFF» (پیش‌فرض)، «ZIPPED_GEO_TIFF_PER_BAND» یا filePerBand درست باشد. زمانی که قالب «ZIPPED_GEO_TIFF»، «ZIPPED_GEO_TIFF_PER_BAND»، یا filePerBand درست باشد، به شناسه تصویر (یا «دانلود» برای تصاویر محاسبه‌شده) پیش‌فرض می‌رسد، در غیر این صورت یک رشته کاراکتر تصادفی ایجاد می‌شود. زمانی که filePerBand درست باشد، نام باند اضافه می شود.
bands: توضیحاتی در مورد باندها برای دانلود. باید آرایه ای از نام باندها یا آرایه ای از فرهنگ لغت باشد که هر کدام دارای کلیدهای زیر هستند (پارامترهای اختیاری فقط زمانی اعمال می شوند که filePerBand درست باشد):
  • id: نام باند، یک رشته، مورد نیاز است.
  • crs: یک رشته CRS اختیاری که پروجکشن باند را تعریف می کند.
  • crs_transform: یک آرایه اختیاری از 6 عدد که یک تبدیل affine از CRS مشخص شده را به ترتیب ردیف اصلی مشخص می کند: [xScale، xShearing، xTranslation، yShearing، yScale، yTranslation]
  • dimensions: یک آرایه اختیاری از دو عدد صحیح که عرض و ارتفاعی را که باند به آن برش داده می شود را مشخص می کند.
  • scale: یک عدد اختیاری که مقیاس را بر حسب متر از باند مشخص می کند. اگر crs و crs_transform مشخص شده باشند نادیده گرفته می شود.
crs: یک رشته CRS پیش فرض برای استفاده برای هر باندی که به صراحت یکی را مشخص نمی کند.
crs_transform: یک تبدیل افین پیش‌فرض برای استفاده برای هر باندی که یکی را مشخص نمی‌کند، با همان فرمت باندهای crs_transform .
dimensions: ابعاد پیش‌فرض برش تصویر برای استفاده برای هر باندی که آنها را مشخص نمی‌کند.
scale: یک مقیاس پیش فرض برای استفاده برای هر باندی که یکی را مشخص نمی کند. اگر crs و crs_transform مشخص شده باشند نادیده گرفته می شود.
region: چند ضلعی که منطقه ای را برای دانلود مشخص می کند. اگر crs و crs_transform مشخص شده باشد نادیده گرفته می شود.
filePerBand: آیا برای تولید یک GeoTIFF جداگانه در هر باند (بولی). پیش فرض ها به درست است. اگر نادرست باشد، یک GeoTIFF تولید می‌شود و همه تبدیل‌های سطح باند نادیده گرفته می‌شوند. توجه داشته باشید که اگر قالب "ZIPPED_GEO_TIFF" یا "ZIPPED_GEO_TIFF_PER_BAND" باشد، این مورد نادیده گرفته می شود.
format: فرمت دانلود. یکی از:
  • "ZIPPED_GEO_TIFF" (فایل GeoTIFF در یک فایل فشرده پیچیده شده است، پیش فرض)
  • "ZIPPED_GEO_TIFF_PER_BAND" (چند فایل GeoTIFF پیچیده شده در یک فایل فشرده)
  • "NPY" (فرمت باینری NumPy)
اگر "GEO_TIFF" یا "NPY"، filePerBand و همه تبدیل‌های سطح باند نادیده گرفته می‌شوند. بارگذاری یک خروجی NumPy منجر به یک آرایه ساخت یافته می شود.
id: منسوخ شده، از پارامتر تصویر استفاده کنید.
callback عملکرد، اختیاری پاسخ به تماس اختیاری در صورت عدم ارائه، تماس به صورت همزمان انجام می شود.

نمونه ها

ویرایشگر کد (جاوا اسکریپت) 

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

راه اندازی پایتون

برای اطلاعات در مورد API پایتون و استفاده از geemap برای توسعه تعاملی به صفحه محیط پایتون مراجعه کنید.

import ee
import geemap.core as geemap

کولب (پایتون) 

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