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 নম্বরের একটি ঐচ্ছিক অ্যারে নির্দিষ্ট CRS থেকে একটি affine রূপান্তর নির্দিষ্ট করে, সারি-প্রধান ক্রমে: [xScale, xShearing, xTranslation, yShearing, yScale, yTranslation]
  • dimensions: দুটি পূর্ণসংখ্যার একটি ঐচ্ছিক অ্যারে যা ব্যান্ডটি ক্রপ করা হয়েছে সেই প্রস্থ এবং উচ্চতা নির্ধারণ করে।
  • scale: একটি ঐচ্ছিক সংখ্যা, ব্যান্ডের মিটারে স্কেল নির্দিষ্ট করে; crs এবং crs_transform নির্দিষ্ট করা থাকলে উপেক্ষা করা হয়।
crs: যে কোনো ব্যান্ডের জন্য একটি ডিফল্ট CRS স্ট্রিং যা স্পষ্টভাবে নির্দিষ্ট করে না।
crs_transform: যে কোনো ব্যান্ডের জন্য ব্যবহার করার জন্য একটি ডিফল্ট affine ট্রান্সফর্ম যা একটি নির্দিষ্ট করে না, ব্যান্ডের crs_transform এর মতো একই বিন্যাসের।
dimensions: ডিফল্ট ইমেজ ক্রপিং ডাইমেনশন যে কোনো ব্যান্ডের জন্য ব্যবহার করতে হবে যা তাদের নির্দিষ্ট করে না।
scale: যে কোনো ব্যান্ডের জন্য ব্যবহার করার জন্য একটি ডিফল্ট স্কেল যা একটি নির্দিষ্ট করে না; crs এবং crs_transform নির্দিষ্ট করা থাকলে উপেক্ষা করা হয়।
region: ডাউনলোড করার জন্য একটি অঞ্চল নির্দিষ্ট করে একটি বহুভুজ; crs এবং crs_transform নির্দিষ্ট করা থাকলে উপেক্ষা করা হয়।
filePerBand: প্রতি ব্যান্ডে একটি পৃথক জিওটিআইএফএফ তৈরি করতে হবে কিনা (বুলিয়ান)। ডিফল্ট থেকে সত্য। মিথ্যা হলে, একটি একক জিওটিআইএফএফ তৈরি করা হয় এবং সমস্ত ব্যান্ড-স্তরের রূপান্তর উপেক্ষা করা হবে। মনে রাখবেন যে ফর্ম্যাটটি "ZIPPED_GEO_TIFF" বা "ZIPPED_GEO_TIFF_PER_BAND" হলে এটি উপেক্ষা করা হয়।
format: ডাউনলোড বিন্যাস। এর মধ্যে একটি:
  • "ZIPPED_GEO_TIFF" (জিওটিআইএফএফ ফাইল একটি জিপ ফাইলে মোড়ানো, ডিফল্ট)
  • "ZIPPED_GEO_TIFF_PER_BAND" (একটি জিপ ফাইলে মোড়ানো একাধিক জিওটিআইএফএফ ফাইল)
  • "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));

পাইথন সেটআপ

পাইথন এপিআই এবং ইন্টারেক্টিভ ডেভেলপমেন্টের জন্য geemap ব্যবহার করার জন্য পাইথন এনভায়রনমেন্ট পৃষ্ঠাটি দেখুন।

import ee
import geemap.core as geemap

Colab (পাইথন)

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