আর্থ ইঞ্জিন অ্যাক্সেস

আর্থ ইঞ্জিন গুগল ক্লাউডে চলে এবং এর অ্যাক্সেস ও এপিআই ব্যবস্থাপনার জন্য ক্লাউড প্রজেক্ট প্রয়োজন। আর্থ ইঞ্জিনের সমস্ত কল (কোড এডিটর, ক্লায়েন্ট লাইব্রেরি, অ্যাপস বা REST API থেকে হোক না কেন) একটি ক্লাউড প্রজেক্টের মাধ্যমে রাউট করা হয়, যা ক্লাউড কনসোলে অ্যাক্সেস নিয়ন্ত্রণ, রিসোর্স ব্যবস্থাপনা এবং ব্যবহার পর্যবেক্ষণের সুবিধা দেয়।

আর্থ ইঞ্জিনে প্রবেশাধিকার পান

আর্থ ইঞ্জিন ব্যবহার করার জন্য আপনার এমন একটি ক্লাউড প্রজেক্টে অ্যাক্সেস প্রয়োজন হবে, যা:

একটি প্রকল্প তৈরি করুন

নতুন ক্লাউড প্রজেক্ট তৈরি ও নিবন্ধন করতে অথবা বিদ্যমান কোনো প্রজেক্ট নিবন্ধন করতে রেজিস্ট্রেশন পেজটি ভিজিট করুন। নিবন্ধনের পর, আর্থ ইঞ্জিন অ্যাক্সেস তাৎক্ষণিকভাবে সক্রিয় হয়ে যায়।

নিবন্ধন প্রক্রিয়ার সময় তৈরি করা প্রজেক্টগুলো গুগল ক্লাউড কনসোল থেকে পরিচালনা করা যায়। আপনি ক্লাউড কনসোলের আর্থ ইঞ্জিন এপিআই (Earth Engine API) পৃষ্ঠা থেকে আর্থ ইঞ্জিন এপিআই সক্রিয় বা নিষ্ক্রিয় করতে পারেন।

ম্যানুয়াল ধাপসমূহ (রেজিস্ট্রেশন পেজ দ্বারা স্বয়ংক্রিয়)

একটি ক্লাউড প্রজেক্ট তৈরি করুন

যদি আগে থেকে তৈরি না করে থাকেন, তাহলে একটি গুগল ক্লাউড প্রজেক্ট তৈরি করুন। আপনি ক্লাউড কনসোলের প্রজেক্ট পেজ থেকে অথবা নিচের বাটনটিতে ক্লিক করে এটি করতে পারেন:

একটি ক্লাউড প্রজেক্ট তৈরি করুন

আর্থ ইঞ্জিন এপিআই সক্রিয় করুন

আপনার প্রোজেক্টের জন্য আর্থ ইঞ্জিন এপিআই (Earth Engine API) সক্রিয় করতে, আর্থ ইঞ্জিন এপিআই পৃষ্ঠায় যেতে নিম্নলিখিত বোতামটি ক্লিক করুন:

আর্থ ইঞ্জিন এপিআই সক্রিয় করুন

আর্থ ইঞ্জিন এপিআই পেজে, আপনার প্রজেক্টটি নির্বাচন করা নিশ্চিত করুন এবং এনাবল (ENABLE) বাটনে ক্লিক করুন।

বাণিজ্যিক বা অবাণিজ্যিক ব্যবহারের জন্য প্রকল্পটি নিবন্ধন করুন।

আপনার প্রোজেক্টের জন্য নিম্নলিখিত URL-টি সম্পাদনা করুন, পৃষ্ঠাটিতে যান এবং নিবন্ধন প্রক্রিয়াটি সম্পন্ন করুন।

https://code.earthengine.google.com/register?project=my-project

একটি অ্যাসেটস ফোল্ডার তৈরি করুন (ঐচ্ছিক)

You can create an Earth Engine assets folder associated with a Cloud project to which you have access using the earthengine create folder command using a path as described here . For example:

earthengine create folder projects/my-project/assets/

এছাড়াও আপনি কোড এডিটরের অ্যাসেটস প্যানেলে প্রজেক্টটি যোগ করে সেটির জন্য একটি অ্যাসেট ফোল্ডার তৈরি করতে পারেন।

প্রজেক্টে অ্যাসেট সংরক্ষণ করার পরিকল্পনা না থাকলে এই ফোল্ডারটি তৈরি করার প্রয়োজন নেই।

একটি বিদ্যমান প্রকল্প ব্যবহার করুন

আর্থ ইঞ্জিনের জন্য কনফিগার করা বিদ্যমান ক্লাউড প্রজেক্টগুলো সম্পর্কে আপনার প্রতিষ্ঠানের আইটি কর্মীদের সাথে কথা বলুন। নিশ্চিত করুন যে, আর্থ ইঞ্জিন পরিষেবাগুলো অ্যাক্সেস করার জন্য আপনি যে গুগল অ্যাকাউন্টটি ব্যবহার করবেন, প্রজেক্টটিতে সেটিকে সঠিক ভূমিকা (role) এবং অনুমতি (permission) দেওয়া হয়েছে।

একটি প্রকল্প নির্দিষ্ট করুন

নিম্নলিখিত বিভাগগুলিতে আর্থ ইঞ্জিনের পরিষেবাগুলির বিভিন্ন ইন্টারফেসের জন্য কীভাবে একটি প্রকল্প নির্দিষ্ট করতে হয় তা বর্ণনা করা হয়েছে।

ক্লায়েন্ট লাইব্রেরি (পাইথন, জাভাস্ক্রিপ্ট)

পাইথন এবং জাভাস্ক্রিপ্ট ক্লায়েন্ট লাইব্রেরি থেকে আসা আর্থ ইঞ্জিন অনুরোধের জন্য একটি প্রজেক্ট নির্দিষ্ট করতে ee.Initialize() ফাংশনটি ব্যবহৃত হয়। প্রজেক্ট স্পেসিফিকেশন কনফিগার করার বিভিন্ন উপায় রয়েছে, আরও বিস্তারিত জানতে অথেনটিকেশন এবং ইনিশিয়ালাইজেশন পৃষ্ঠাটি দেখুন।

কোড সম্পাদক

কোড এডিটরের উপরের ডান কোণায় থাকা প্রোফাইল আইকনে ক্লিক করুন এবং মেনু থেকে 'চেঞ্জ ক্লাউড প্রজেক্ট' নির্বাচন করুন। সিলেকশন ডায়ালগ থেকে একটি প্রজেক্ট বেছে নিন।

আর্থ ইঞ্জিন অ্যাপস

একটি আর্থ ইঞ্জিন অ্যাপ প্রকাশ করার সময়, অনুরোধগুলি পাঠানোর জন্য আপনাকে একটি প্রজেক্ট বেছে নিতে বলা হবে। প্রকাশনা ডায়ালগে দেওয়া নির্দেশাবলী অনুসরণ করুন।

কমান্ড-লাইন টুল

কমান্ড-লাইন টুল থেকে আর্থ ইঞ্জিন কলগুলোকে কোনো ক্লাউড প্রজেক্টের সাথে যুক্ত করতে, earthengine কলে --project প্যারামিটারটি ব্যবহার করুন অথবা একটি ডিফল্ট প্রজেক্ট সেট করতে set_project ব্যবহার করুন।

REST API

REST API-এর কলগুলোকে একটি ক্লাউড প্রজেক্টের সাথে যুক্ত করতে, অথেনটিকেটেড HTTP কল করুন যেখানে অথেন্টিকেশন oauth2 দ্বারা পরিচালিত হয়। লোকাল এনভায়রনমেন্টে, আপনি gcloud কমান্ড ব্যবহার করতে পারেন। এছাড়াও আপনি একটি ক্লাউড প্রজেক্টের সাথে যুক্ত সার্ভিস অ্যাকাউন্ট ব্যবহার করতে পারেন। সার্ভিস অ্যাকাউন্ট দিয়ে অথেন্টিকেট করার জন্য google.oath.service_account.Credentials.from_service_account_file() ব্যবহারের একটি উদাহরণের জন্য REST API কুইকস্টার্ট দেখুন।

প্রজেক্ট অ্যাক্সেস কনফিগার করুন

নিম্নলিখিত বিভাগগুলিতে বর্ণনা করা হয়েছে কীভাবে অন্যান্য ব্যক্তি এবং পরিষেবা অ্যাকাউন্টগুলির ব্যবহারের জন্য আর্থ ইঞ্জিন-সক্ষম প্রকল্পগুলি কনফিগার করতে হয়।

পরিষেবা অ্যাকাউন্ট

সার্ভিস অ্যাকাউন্টগুলো তাদের প্যারেন্ট প্রজেক্ট রেজিস্টার করা হলে এবং আর্থ ইঞ্জিন এপিআই (Earth Engine API) সক্রিয় করা থাকলে স্বয়ংক্রিয়ভাবে অ্যাক্সেস পেয়ে যায়। প্রজেক্টের মধ্যে তাদের সঠিক অনুমতিও প্রয়োজন। একটি প্রজেক্টে যেকোনো সংখ্যক সার্ভিস অ্যাকাউন্ট আর্থ ইঞ্জিন ব্যবহার করার জন্য কনফিগার করা যেতে পারে। আর্থ ইঞ্জিনের সাথে সার্ভিস অ্যাকাউন্ট ব্যবহার সম্পর্কে আরও জানতে সার্ভিস অ্যাকাউন্ট পেজটি দেখুন।

গুগল অ্যাকাউন্ট

ক্লাউড প্রজেক্টগুলো রোল এবং পারমিশন ম্যানেজ করতে ক্লাউড আইএএম (Cloud IAM) ব্যবহার করে। আপনার প্রজেক্টের মাধ্যমে অন্য ব্যবহারকারীরা যাতে আর্থ ইঞ্জিন (Earth Engine) অ্যাক্সেস করতে পারে, তার জন্য আপনাকে ক্লাউড কনসোল (Cloud Console) ব্যবহার করে তাদের সঠিক রোল এবং পারমিশন প্রদান করতে হবে।

OAuth 2.0 ক্লায়েন্ট আইডি

আপনার কোনো প্রজেক্ট থেকে একটি OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করার প্রয়োজন হতে পারে, উদাহরণস্বরূপ, এমন একটি অ্যাপ তৈরি করার জন্য যা আর্থ ইঞ্জিনে ব্যবহারকারীর ক্রেডেনশিয়াল পাঠায়। আপনি ক্লাউড কনসোল মেনুতে ( ) গিয়ে এবং APIs & Services > Credentials নির্বাচন করে আপনার ক্লাউড প্রজেক্টের ক্রেডেনশিয়াল পরিচালনা করতে পারেন। (প্রয়োজনে প্রজেক্টটি বেছে নিন)।

প্রজেক্টের জন্য একটি নতুন ক্লায়েন্ট আইডি তৈরি করতে, + ক্রেডেনশিয়াল তৈরি করুন > OAuth ক্লায়েন্ট আইডি > ওয়েব অ্যাপ্লিকেশন-এ ক্লিক করুন।

ওয়েব অ্যাপ্লিকেশনটির কনফিগারেশনে:

  • অনুমোদিত জাভাস্ক্রিপ্ট অরিজিন নির্দিষ্ট করুন, উদাহরণস্বরূপ: 
http://localhost:8080
https://foo-ee-project.appspot.com
  • অনুমোদিত পুনঃনির্দেশ URI-গুলি নির্দিষ্ট করুন, উদাহরণস্বরূপ: 
http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback

OAuth ব্যবহার করে ব্যবহারকারীদের প্রমাণীকরণ সম্পর্কে আরও জানুন ।

সাধারণ পরিস্থিতি

আমি একটি শিক্ষামূলক ক্লাস নিচ্ছি...

চমৎকার! আপনি যদি একটি অবাণিজ্যিক প্রকল্প নিবন্ধন করেন, তাহলে কোনো বিলিং কনফিগারেশনের প্রয়োজন নেই। এরপর, আপনি আপনার শিক্ষার্থীদের প্রকল্পে যুক্ত করতে পারবেন।

আমি একটি পরিচালন দল/বাণিজ্যিক প্রতিষ্ঠানের অংশ...

চমৎকার! আপনি বাণিজ্যিক ব্যবহারের জন্য একটি প্রজেক্ট নিবন্ধন করতে এবং এতে আপনার সহযোগীদের যুক্ত করতে পারবেন। অনুগ্রহ করে আপনার নির্বাচিত আর্থ ইঞ্জিন সাবস্ক্রিপশনের আসন সংখ্যার দিকেও মনোযোগ দিন।

আর্থ ইঞ্জিন ডেটা মুছে ফেলা

অ্যাকাউন্ট-স্তরের মুছে ফেলা

অ্যাকাউন্ট-স্তরের মুছে ফেলার ফলে আপনার অ্যাকাউন্ট থেকে আর্থ ইঞ্জিন-এর সমস্ত ডেটা মুছে যাবে।

আপনার অ্যাকাউন্টটি যদি কোনো গুগল ওয়ার্কস্পেস অর্গানাইজেশনের অংশ হয়, তাহলে আপনার অ্যাডমিনিস্ট্রেটর আপনার অ্যাকাউন্টের ডেটা নিয়ন্ত্রণ করেন। যখন কোনো অ্যাডমিনিস্ট্রেটর একটি গুগল অ্যাকাউন্ট ডিলিট করেন , তখন এর সাথে যুক্ত আর্থ ইঞ্জিন-এর সমস্ত ডেটা প্রায় ৩০ দিনের মধ্যে মুছে যায়।

একবার ডেটা মুছে গেলে আর্থ ইঞ্জিন টিমের পক্ষে তা পুনরুদ্ধার করা সম্ভব নয়।

ক্লাউড প্রকল্প

যখন কোনো ক্লাউড প্রজেক্ট ডিলিট করা হয় , তখন সেই প্রজেক্টের সাথে যুক্ত আর্থ ইঞ্জিন ডেটাও ডিলিট হয়ে যায় (যার মধ্যে অন্তর্ভুক্ত, উদাহরণস্বরূপ, প্রজেক্ট রুটে সংরক্ষিত যেকোনো অ্যাসেট, যেকোনো প্রজেক্ট-লেভেলের EE অ্যাপস, মনিটরিং ডেটা, ইত্যাদি)। এই প্রক্রিয়াটি ৩০ দিন পর্যন্ত পূর্বাবস্থায় ফেরানো সম্ভব হতে পারে , কিন্তু ৩০ দিন পর সেই ডেটা পুনরুদ্ধার করা কখনোই সম্ভব নয়।

সম্পদ

আপনার অ্যাসেটগুলি মুছে ফেলার সবচেয়ে সহজ পদ্ধতি হলো কোড এডিটরের "অ্যাসেটস" ট্যাব ব্যবহার করে আপনার আর্থ ইঞ্জিন অ্যাসেটগুলি দেখা এবং ম্যানুয়ালি মুছে ফেলা।

projects/{project-id}/assets/{asset-id} আইডিযুক্ত কোনো অ্যাসেট (যেমন, projects/my-project/assets/my-asset ) প্রোগ্রাম্যাটিকভাবে ডিলিট করার জন্য:

পাইথন ক্লায়েন্ট 

ee.data.deleteAsset('projects/my-project/assets/my-asset')

জাভাস্ক্রিপ্ট ক্লায়েন্ট

উল্লেখ্য যে, কোড এডিটরের নিরাপত্তা স্যান্ডবক্সের কারণে এই কলটি সেই পরিবেশে কাজ করে না।

ee.data.deleteAsset('projects/my-project/assets/my-asset')

কমান্ড-লাইন টুল

rm কমান্ডটি ব্যবহার করুন:

earthengine rm projects/my-project/assets/my-asset

কোড এডিটর স্ক্রিপ্ট

আপনার আর্থ ইঞ্জিন কোড এডিটর স্ক্রিপ্টগুলি মুছে ফেলতে:

কোড সম্পাদক

কোড এডিটর-এর 'স্ক্রিপ্টস' ট্যাব থেকে একটি স্ক্রিপ্ট বা রিপোজিটরি নির্বাচন করে সেটি মুছে ফেলুন। কোনো রিপোজিটরিকে একবার মুছে ফেলা হিসেবে চিহ্নিত করা হলে, ৩০ দিনের মধ্যে তা আর পুনরুদ্ধার করা যায় না।

গিট ব্যবহার করে

উন্নত ব্যবহারকারীরা তাদের স্ক্রিপ্ট পরিচালনা করতে গিট ব্যবহার করতে পারেন। আপনি যে রিপোজিটরিগুলো দেখতে পারবেন তার তালিকা পেতে https://earthengine.googlesource.com/ দেখুন।

আর্থ ইঞ্জিন অ্যাপস

আপনার আর্থ ইঞ্জিন অ্যাপসগুলো মুছে ফেলতে, কোড এডিটরে থাকা 'অ্যাপস' বাটনটি ব্যবহার করে আপনার অ্যাপসগুলো পরিচালনা করুন ।

কোড এডিটর থেকে আপনার 'গেট লিঙ্ক' লিঙ্কগুলো দেখতে ও মুছে ফেলতে ' ম্যানেজ লিঙ্কস' পৃষ্ঠাটি ব্যবহার করুন। 'গেট লিঙ্ক' বাটনের পাশের ড্রপ-ডাউন মেনুতে থাকা 'ম্যানেজ লিঙ্কস' অপশনটিতে গেলেই এই পৃষ্ঠাটি খুঁজে পাওয়া যাবে।

অবাণিজ্যিক অ্যাক্সেস কনফিগার করা

আপনার প্রকল্পের জন্য অবাণিজ্যিক (অবৈতনিক) আর্থ ইঞ্জিন অ্যাক্সেস সেট আপ করতে, আপনার প্রকল্পের যোগ্যতা নিশ্চিত করার জন্য আপনাকে ক্লাউড কনসোলে রেজিস্ট্রেশন প্রশ্নাবলীটি পূরণ করতে হবে।

যাচাইকরণ

যেহেতু আর্থ ইঞ্জিন বিপুল পরিমাণ কম্পিউট রিসোর্সে বিনামূল্যে অ্যাক্সেস দেয়, তাই অবাণিজ্যিক ব্যবহারের জন্য নিবন্ধিত প্রতিটি প্রজেক্টের যাচাইকরণ প্রয়োজন হয়। এই যাচাইকরণ প্রক্রিয়াটি নিবন্ধনের অংশ হিসেবেই সম্পন্ন করা হয়। আপনি যদি যাচাইকরণ প্রশ্নাবলীটি পূরণ করেন এবং আপনার প্রজেক্টটি বাণিজ্যিক হিসেবে নির্ধারিত হয়, তবে আপনি অর্থ প্রদান ছাড়া আর্থ ইঞ্জিন ব্যবহার করার যোগ্য হবেন না।

২০২৫ সালের ২৬শে সেপ্টেম্বর থেকে, সকল অ-বাণিজ্যিক প্রকল্পকে অবশ্যই ক্লাউড কনসোলে প্রশ্নাবলীটি পূরণ করতে হবে। আমরা যত তাড়াতাড়ি সম্ভব যাচাইকরণ প্রক্রিয়াটি সম্পন্ন করার পরামর্শ দিচ্ছি। যদি আপনি ২০২৫ সালের ২৬শে সেপ্টেম্বরের আগে কোনো পদক্ষেপ না নেন, তাহলে যাচাইকরণ প্রক্রিয়াটি সম্পন্ন না করা পর্যন্ত আপনার প্রকল্পের আর্থ ইঞ্জিন (Earth Engine)-এ প্রবেশাধিকার স্থগিত করা হবে।

পুনঃযাচাইকরণ

অবাণিজ্যিক প্রবেশাধিকার আছে এমন সমস্ত প্রকল্পকে পর্যায়ক্রমিকভাবে প্রবেশাধিকার পুনঃযাচাই করতে হবে।

বাণিজ্যিক অ্যাক্সেস কনফিগার করা

আপনার প্রকল্পের জন্য বাণিজ্যিক (সবেতন) আর্থ ইঞ্জিন অ্যাক্সেস সেট আপ করতে, আপনাকে রেজিস্ট্রেশন পেজ ব্যবহার করে প্রকল্পটি কনফিগার করতে হবে এবং বিলিং অ্যাকাউন্টে একটি প্ল্যান বেছে নিতে হবে।

বাণিজ্যিক প্রবেশাধিকার বন্ধ করা

আপনি যদি আর্থ ইঞ্জিনের সরাসরি গ্রাহক হন এবং অর্থের বিনিময়ে এর ব্যবহার বন্ধ করতে চান, তাহলে চার্জ আসা বন্ধ করার জন্য কয়েকটি পরিবর্তন করতে হবে:

  • সাবস্ক্রিপশন চার্জ বন্ধ করুন

    • আপনার বিলিং অ্যাকাউন্টে আর্থ ইঞ্জিন সাবস্ক্রিপশনটি বন্ধ করতে, আপনাকে 'ম্যানেজ প্ল্যানস' পেজটি ব্যবহার করতে হবে (যেটি সেই বিলিং অ্যাকাউন্টের সাথে লিঙ্ক করা একটি নিবন্ধিত ক্লাউড প্রজেক্ট ব্যবহার করার সময় কোড এডিটরের উপরের ডানদিকে থাকা ইউজার সেটিংস ড্রপ-ডাউন মেনু থেকে অ্যাক্সেস করা যায়)।

    • এছাড়াও আপনি একটি বিলিং অ্যাকাউন্টের জন্য সরাসরি "প্ল্যান পরিচালনা" পৃষ্ঠায় প্রবেশ করতে পারেন:

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID

    • 'লিমিটেড' প্ল্যানটি বেছে নিলে, আপনার বর্তমান বিলিং চক্রের পর আপনার বিলিং অ্যাকাউন্টে আর কোনো আর্থ ইঞ্জিন প্ল্যাটফর্ম সাবস্ক্রিপশন ফি যুক্ত হবে না।

  • কম্পিউটারের চার্জ বন্ধ করুন

    • কম্পিউট (EECU-time) সম্পর্কিত নতুন চার্জ এড়াতে, আপনার ক্লাউড প্রজেক্টগুলিতে আর্থ ইঞ্জিন এপিআই (Earth Engine API) নিষ্ক্রিয় করুন। মনে রাখবেন যে এটি চলমান অনুরোধগুলি বন্ধ করে না বা সংরক্ষিত অবজেক্টগুলি মুছে ফেলে না , তাই এপিআই নিষ্ক্রিয় থাকা সত্ত্বেও আপনার আর্থ ইঞ্জিন চার্জ লাগতে পারে।
    • এপিআই নিষ্ক্রিয় করার বিষয়ে তথ্যের জন্য এপিআই কনসোল হেল্প দেখুন।

  • স্টোরেজ চার্জ বন্ধ করুন

    • এপিআই নিষ্ক্রিয় করা হলেও সংরক্ষিত আর্থ ইঞ্জিন অ্যাসেটগুলো খরচ বাড়াতে থাকে। আপনার অ্যাসেটগুলো মুছে ফেললে আপনাকে আর কোনো ইই স্টোরেজ ফি দিতে হবে না।