ee.Image.getDownloadURL

یک URL دانلود برای تکه های کوچک داده تصویر در قالب GeoTIFF یا NumPy دریافت کنید. حداکثر اندازه درخواست 32 مگابایت، حداکثر ابعاد شبکه 10000 است.

از getThumbURL برای فرمت های تجسم RGB PNG و JPG استفاده کنید.

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

استفاده برمی گرداند
Image. getDownloadURL (params, callback ) شیء | رشته
استدلال تایپ کنید جزئیات
این: image تصویر نمونه تصویر.
params شیء یک شی حاوی گزینه های دانلود با مقادیر ممکن زیر:
name: یک نام پایه برای استفاده در هنگام ساخت نام فایل. فقط زمانی قابل اجرا است که قالب "ZIPPED_GEO_TIFF" (پیش‌فرض) یا filePerBand درست باشد. زمانی که قالب «ZIPPED_GEO_TIFF» یا 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 تولید می‌شود و همه تبدیل‌های سطح باند نادیده گرفته می‌شوند.
format: فرمت دانلود. یکی از:
  • "ZIPPED_GEO_TIFF" (فایل(های) GeoTIFF در یک فایل فشرده پیچیده شده است، پیش فرض)
  • "GEO_TIFF" (فایل GeoTIFF)
  • "NPY" (فرمت باینری NumPy)
اگر "GEO_TIFF" یا "NPY"، filePerBand و همه تبدیل‌های سطح باند نادیده گرفته می‌شوند. بارگذاری یک خروجی NumPy منجر به یک آرایه ساخت یافته می شود.
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);

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

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

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

import ee
import geemap.core as geemap

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

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