ee.Image.getDownloadURL

GeoTIFF বা NumPy ফর্ম্যাটে ইমেজ ডেটার ছোট চাঙ্কের জন্য ডাউনলোড URL পান। অনুরোধের সর্বাধিক সাইজ হল ৩২ এমবি, সর্বাধিক গ্রিড ডাইমেনশন হল ১০০০০।

RGB ভিজ্যুয়ালাইজেশন ফর্ম্যাট PNG এবং JPG-এর জন্য getThumbURL ব্যবহার করুন।

ডাউনলোড URL রিটার্ন করে অথবা কলব্যাক উল্লেখ করা থাকলে, তা সংজ্ঞায়িত করা হয় না।

ব্যবহাররিটার্ন
Image.getDownloadURL(params, callback)অবজেক্ট|স্ট্রিং
আর্গুমেন্টধরনবিবরণ
এটি: imageছবিইমেজ ইনস্ট্যান্স।
paramsঅবজেক্টনিম্নলিখিত সম্ভাব্য ভ্যালু সহ ডাউনলোড করার বিকল্প আছে এমন অবজেক্ট:
name: ফাইলের নাম তৈরি করার সময় ব্যবহার করার জন্য একটি বেস নাম। শুধুমাত্র ফর্ম্যাট "ZIPPED_GEO_TIFF" (ডিফল্ট) বা filePerBand সত্য হলে প্রযোজ্য। ফর্ম্যাট "ZIPPED_GEO_TIFF" বা filePerBand-এর মান true হলে, ডিফল্ট হিসেবে ছবির আইডি (বা কম্পিউট করা ছবির জন্য "download") ব্যবহার করা হয়, অন্যথায় একটি র‍্যান্ডম ক্যারেক্টার স্ট্রিং তৈরি করা হয়। filePerBand-এর ভ্যালু true হলে ব্যান্ড নাম যোগ করা হয়।
bands: ডাউনলোড করার জন্য ব্যান্ডের বিবরণ। ব্যান্ডের নামের অ্যারে বা ডিকশনারির অ্যারে হতে হবে, যার প্রতিটিতে নিম্নলিখিত কী থাকবে (ঐচ্ছিক প্যারামিটার শুধুমাত্র filePerBand সত্য হলে প্রযোজ্য):
  • id: ব্যান্ডের নাম, একটি স্ট্রিং, প্রয়োজন।
  • crs: একটি ঐচ্ছিক CRS স্ট্রিং যা ব্যান্ড প্রজেকশনকে সংজ্ঞায়িত করে।
  • crs_transform: হল ৬টি সংখ্যার একটি ঐচ্ছিক অ্যারে যা নির্দিষ্ট 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 তৈরি করতে হবে কিনা (বুলিয়ান)। ডিফল্ট হিসেবে true সেট করা থাকে। মিথ্যা হলে, একটি 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_HARMONIZED/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'
  }));

Python সেট-আপ

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

import ee
import geemap.core as geemap

Colab (Python)

"""Demonstrates the ee.Image.getDownloadURL method."""

import io

import numpy
import requests

# A Sentinel-2 surface reflectance image.
img = ee.Image('COPERNICUS/S2_SR_HARMONIZED/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.
url = img.getDownloadUrl({
    'bands': ['B3', 'B8', 'B11'],
    'region': region,
    'scale': 20,
    'format': 'NPY'
})
response = requests.get(url)
data = numpy.load(io.BytesIO(response.content))
display(data)
display(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)