ee.Image.getDownloadURL

GeoTIFF বা NumPy ফর্ম্যাটে ইমেজ ডেটার ছোট অংশের জন্য একটি ডাউনলোড URL পান৷ সর্বাধিক অনুরোধের আকার হল 32 MB, সর্বাধিক গ্রিডের মাত্রা হল 10000৷

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

রিটার্ন একটি ডাউনলোড URL প্রদান করে, অথবা একটি কলব্যাক নির্দিষ্ট করা হলে অনির্ধারিত।

ব্যবহার রিটার্নস
Image. getDownloadURL (params, callback ) অবজেক্ট|স্ট্রিং
যুক্তি টাইপ বিস্তারিত
এই: image ছবি ইমেজ উদাহরণ.
params অবজেক্ট নিম্নলিখিত সম্ভাব্য মান সহ ডাউনলোড বিকল্প ধারণকারী একটি বস্তু:
name: ফাইলের নাম তৈরি করার সময় ব্যবহার করার জন্য একটি বেস নাম। ফরম্যাট "ZIPPED_GEO_TIFF" (ডিফল্ট) বা filePerBand সত্য হলেই কেবল প্রযোজ্য৷ যখন বিন্যাস "ZIPPED_GEO_TIFF" বা 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: প্রতি ব্যান্ডে একটি পৃথক জিওটিআইএফএফ তৈরি করতে হবে কিনা (বুলিয়ান)। ডিফল্ট থেকে সত্য। মিথ্যা হলে, একটি একক জিওটিআইএফএফ তৈরি করা হয় এবং সমস্ত ব্যান্ড-স্তরের রূপান্তর উপেক্ষা করা হবে।
format: ডাউনলোড বিন্যাস। এর মধ্যে একটি:
  • "ZIPPED_GEO_TIFF" (জিওটিআইএফএফ ফাইল(গুলি) একটি জিপ ফাইলে মোড়ানো, ডিফল্ট)
  • "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'
  }));

পাইথন সেটআপ

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

import ee
import geemap.core as geemap

Colab (পাইথন)

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