Earth Engine REST API-এর মাধ্যমে ছবি গণনা করা

মনে রাখবেন: REST API-তে নতুন ও উন্নত ফিচার আছে যা সব ব্যবহারকারীর জন্য উপযুক্ত নাও হতে পারে। আপনি Earth Engine-এ নতুন হলে, জাভাস্ক্রিপ্ট গাইড দিয়ে শুরু করুন।

Earth Engine REST API কুইকস্টার্ট থেকে জানা যায় যে কীভাবে Earth Engine অ্যাসেট থেকে পিক্সেলের ব্লক অ্যাক্সেস করতে হয়। ধরুন, ফলাফল পাওয়ার আগে আপনি পিক্সেলে কম্পিউটেশন প্রয়োগ করতে চান। এই নির্দেশিকা দেখায় যে কীভাবে ক্লায়েন্ট লাইব্রেরিগুলির একটির সাথে একটি কম্পিউটেশনের প্রোটোটাইপ তৈরি করতে হয়, কম্পিউটেশন গ্রাফকে সিরিয়ালাইজ করতে হয় এবং কম্পিউট করা ফলাফল পেতে REST API ব্যবহার করতে হয়। REST API-এর মাধ্যমে কম্পিউট অনুরোধ করা মানে হল কম্পিউট এন্ডপয়েন্টের একটিতে POST অনুরোধ করা, যেমন computePixels, computeFeatures অথবা জেনেরিক value.compute। বিশেষ করে, এই উদাহরণটি একটি ছোট অঞ্চলে Sentinel-2 ছবির একটি মিডিয়ান কম্পোজিট পাওয়ার বিষয়টি দেখায়।

শুরু করার আগে

এইসব নির্দেশাবলী অনুসরণ করুন:

  1. Earth Engine-এর জন্য আবেদন করুন
  2. Google Cloud প্রোজেক্ট তৈরি করা
  3. প্রোজেক্টে Earth Engine API চালু করুন
  4. পরিষেবার অ্যাকাউন্ট তৈরি করা
  5. Earth Engine কম্পিউটেশন করার জন্য পরিষেবা অ্যাকাউন্টকে প্রোজেক্ট লেভেল অনুমতি দিন

মনে রাখবেন: এই টিউটোরিয়াল সম্পূর্ণ করতে, আপনার একটি পরিষেবা অ্যাকাউন্ট প্রয়োজন হবে যা Earth Engine অ্যাক্সেসের জন্য রেজিস্টার করা আছে। এগিয়ে যাওয়ার আগে, পরিষেবা অ্যাকাউন্ট রেজিস্টার করতে এই নির্দেশাবলী দেখুন।

Google Cloud-এ যাচাইকরণ করুন

প্রথমেই আপনাকে লগ-ইন করতে হবে যাতে আপনি Google Cloud-এ যাচাই করা অনুরোধ করতে পারেন। আপনি একই সময়ে প্রোজেক্ট সেট করবেন। সাইন-ইন সম্পূর্ণ করতে আউটপুটে দেওয়া নির্দেশাবলী অনুসরণ করুন।

# INSERT YOUR PROJECT HERE
PROJECT = 'your-project'

!gcloud auth login --project {PROJECT}

আপনার পরিষেবা অ্যাকাউন্টের জন্য ব্যক্তিগত কী ফাইল পান

Earth Engine ব্যবহার করার জন্য আপনার আগে থেকেই একটি রেজিস্টার করা পরিষেবা অ্যাকাউন্ট থাকতে হবে। আপনার কাছে না থাকলে, একটি পেতে এইসব নির্দেশাবলী অনুসরণ করুন। আপনার পরিষেবা অ্যাকাউন্টের ইমেল আইডি কপি করে নিম্নলিখিত সেলে পেস্ট করুন। (Earth Engine ব্যবহার করার জন্য পরিষেবা অ্যাকাউন্টটি আগে থেকেই রেজিস্টার করা থাকতে হবে)। নিম্নলিখিত সেলে, পরিষেবা অ্যাকাউন্টের জন্য কী ফাইল তৈরি করতে gsutil কমান্ড লাইন ব্যবহার করা হয়। নোটবুক VM-এ 'কী' ফাইল তৈরি করা হবে।

# INSERT YOUR SERVICE ACCOUNT HERE
SERVICE_ACCOUNT='your-service-account@your-project.iam.gserviceaccount.com'
KEY = 'key.json'

!gcloud iam service-accounts keys create {KEY} --iam-account {SERVICE_ACCOUNT}

AuthorizedSession শুরু করুন এবং আপনার ক্রেডেনশিয়াল পরীক্ষা করুন

ক্রেডেনশিয়াল পেতে ব্যক্তিগত কী ব্যবহার করে সেটি পরীক্ষা করুন। HTTP অনুরোধ করার জন্য অনুমোদিত সেশন তৈরি করতে ক্রেডেনশিয়াল ব্যবহার করুন। ক্রেডেনশিয়াল কাজ করছে কিনা তা চেক করতে সেশনের মাধ্যমে GET অনুরোধ করুন।

from google.auth.transport.requests import AuthorizedSession
from google.oauth2 import service_account

credentials = service_account.Credentials.from_service_account_file(KEY)
scoped_credentials = credentials.with_scopes(
    ['https://www.googleapis.com/auth/cloud-platform'])

session = AuthorizedSession(scoped_credentials)

url = 'https://earthengine.googleapis.com/v1beta/projects/earthengine-public/assets/LANDSAT'

response = session.get(url)

from pprint import pprint
import json
pprint(json.loads(response.content))

একটি গণনা সিরিয়ালাইজ করুন

কিছু গণনা করার জন্য অনুরোধ পাঠানোর আগে, গণনাটি Earth Engine এক্সপ্রেশন গ্রাফ ফর্ম্যাটে রাখতে হবে। এক্সপ্রেশন গ্রাফ কীভাবে পাওয়া যায় তা নিচে দেখানো হয়েছে।

Earth Engine-এ যাচাই করুন

পরিষেবা অ্যাকাউন্ট থেকে Earth Engine স্কোপ করা ক্রেডেনশিয়াল পান। Earth Engine শুরু করতে এগুলি ব্যবহার করুন।

import ee

# Get some new credentials since the other ones are cloud scope.
ee_creds = ee.ServiceAccountCredentials(SERVICE_ACCOUNT, KEY)
ee.Initialize(ee_creds)

গণনা নির্ধারণ করুন

ক্লায়েন্ট API-এর মাধ্যমে একটি সাধারণ কম্পিউটেশনের প্রোটোটাইপ তৈরি করুন। মনে রাখবেন যে গণনার ফলাফল হল Image।

coords = [
  -121.58626826832939,
  38.059141484827485,
]
region = ee.Geometry.Point(coords)

collection = ee.ImageCollection('COPERNICUS/S2_HARMONIZED')
collection = collection.filterBounds(region)
collection = collection.filterDate('2020-04-01', '2020-09-01')
image = collection.median()

এক্সপ্রেশন গ্রাফ সিরিয়ালাইজ করো

এটি এমন একটি অবজেক্ট তৈরি করবে যা Earth Engine এক্সপ্রেশন গ্রাফকে (বিশেষত, একটি Expression) উপস্থাপন করে। সাধারণত, আপনাকে ক্লায়েন্ট API-এর একটির মাধ্যমে এগুলি তৈরি করতে হবে।

serialized = ee.serializer.encode(image)

প্রয়োজনীয় স্কেলে (Sentinel-2-এর জন্য ১০ মিটার) প্রয়োজনীয় প্রোজেকশন (WGS84) তৈরি করুন। এটি শুধু ডিগ্রিতে কাঙ্ক্ষিত স্কেল, প্রজেকশনের ইউনিট আবিষ্কার করার জন্য। অনুরোধে অ্যাফাইন ট্রান্সফর্ম নির্দিষ্ট করতে এই স্কেল ব্যবহার করা হবে।

# Make a projection to discover the scale in degrees.
proj = ee.Projection('EPSG:4326').atScale(10).getInfo()

# Get scales out of the transform.
scale_x = proj['transform'][0]
scale_y = -proj['transform'][4]

অনুরোধ পাঠান

computePixels এন্ডপয়েন্টে POST অনুরোধ করুন। মনে রাখবেন যে অনুরোধে Expression থাকে, যা হল সিরিয়ালাইজ করা গণনা। এতে PixelGrid-ও আছে। PixelGrid-এ কাঙ্খিত আউটপুটের জন্য dimensions এবং অনুরোধ করা কোঅর্ডিনেট সিস্টেমের ইউনিটে একটি AffineTransform থাকে। এখানে স্থানাঙ্ক সিস্টেমটি ভৌগোলিক, তাই ট্রান্সফর্মটি ডিগ্রিতে স্কেল এবং অনুরোধ করা ইমেজ প্যাচের উপরের বাম কোণের ভৌগোলিক স্থানাঙ্কের সাথে নির্দিষ্ট করা হয়েছে।

import json

url = 'https://earthengine.googleapis.com/v1beta/projects/{}/image:computePixels'
url = url.format(PROJECT)

response = session.post(
  url=url,
  data=json.dumps({
    'expression': serialized,
    'fileFormat': 'PNG',
    'bandIds': ['B4','B3','B2'],
    'grid': {
      'dimensions': {
        'width': 640,
        'height': 640
      },
      'affineTransform': {
        'scaleX': scale_x,
        'shearX': 0,
        'translateX': coords[0],
        'shearY': 0,
        'scaleY': scale_y,
        'translateY': coords[1]
      },
      'crsCode': 'EPSG:4326',
    },
    'visualizationOptions': {'ranges': [{'min': 0, 'max': 3000}]},
  })
)

image_content = response.content

আপনি যদি এটি কোনও নোটবুকে চালান, তাহলে আপনি IPython ইমেজ ডিসপ্লে উইজেট ব্যবহার করে ফলাফল দেখাতে পারবেন।

# Import the Image function from the IPython.display module.
from IPython.display import Image
Image(image_content)