دسترسی به موتور زمین

Earth Engine روی Google Cloud اجرا می‌شود و برای دسترسی و مدیریت API به پروژه‌های Cloud نیاز دارد. تمام فراخوانی‌های Earth Engine (چه از ویرایشگر کد، کتابخانه‌های کلاینت، برنامه‌ها یا REST API) از طریق یک پروژه Cloud مسیریابی می‌شوند و امکان کنترل دسترسی، مدیریت منابع و نظارت بر استفاده را در Cloud Console فراهم می‌کنند.

به موتور زمین دسترسی پیدا کنید

برای استفاده از Earth Engine به یک پروژه ابری نیاز دارید که:

ایجاد یک پروژه

برای ایجاد و ثبت یک پروژه ابری جدید یا ثبت یک پروژه موجود، به صفحه ثبت نام مراجعه کنید. پس از ثبت نام، دسترسی به Earth Engine بلافاصله فعال می‌شود.

پروژه‌های ایجاد شده در طول فرآیند ثبت نام را می‌توان در کنسول ابری گوگل مدیریت کرد. می‌توانید API موتور زمین را از صفحه API موتور زمین در کنسول ابری فعال یا غیرفعال کنید.

مراحل دستی (خودکار شده توسط صفحه ثبت نام)

ایجاد یک پروژه ابری

اگر قبلاً این کار را نکرده‌اید، یک پروژه گوگل کلود ایجاد کنید. می‌توانید این کار را از صفحه پروژه‌های کنسول کلود انجام دهید یا روی دکمه زیر کلیک کنید:

ایجاد یک پروژه ابری

فعال کردن API موتور زمین

برای فعال کردن API موتور زمین برای پروژه خود، روی دکمه زیر کلیک کنید تا به صفحه API موتور زمین بروید:

فعال کردن API موتور زمین

در صفحه Earth Engine API، مطمئن شوید که پروژه خود را انتخاب کرده‌اید و روی دکمه ENABLE کلیک کنید.

ثبت پروژه برای استفاده تجاری یا غیرتجاری

آدرس اینترنتی (URL) زیر را برای پروژه خود ویرایش کنید، از صفحه مربوطه بازدید کنید و مراحل ثبت نام را تکمیل کنید.

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

ایجاد پوشه دارایی‌ها (اختیاری)

شما می‌توانید با استفاده از دستور earthengine create folder و با استفاده از مسیری که در اینجا توضیح داده شده است، یک پوشه‌ی دارایی‌های Earth Engine مرتبط با یک پروژه‌ی ابری که به آن دسترسی دارید، ایجاد کنید. برای مثال:

earthengine create folder projects/my-project/assets/

همچنین می‌توانید با اضافه کردن پروژه در پنل Assets، یک پوشه دارایی برای یک پروژه در ویرایشگر کد ایجاد کنید.

نیازی به ایجاد این پوشه نیست، مگر اینکه قصد داشته باشید فایل‌هایی را در پروژه ذخیره کنید.

استفاده از یک پروژه موجود

با کارکنان فناوری اطلاعات سازمان خود در مورد پروژه‌های ابری موجود که برای Earth Engine پیکربندی شده‌اند، مشورت کنید. مطمئن شوید که به حساب گوگلی که برای دسترسی به سرویس‌های Earth Engine استفاده خواهید کرد، نقش‌ها و مجوزهای صحیح در پروژه اعطا شده است.

مشخص کردن یک پروژه

بخش‌های زیر نحوه مشخص کردن یک پروژه برای رابط‌های مختلف سرویس‌های Earth Engine را شرح می‌دهند.

کتابخانه‌های کلاینت (پایتون، جاوا اسکریپت)

تابع ee.Initialize() برای مشخص کردن یک پروژه برای درخواست‌های Earth Engine که از کتابخانه‌های کلاینت پایتون و جاوا اسکریپت سرچشمه می‌گیرند، استفاده می‌شود. روش‌های مختلفی برای پیکربندی مشخصات پروژه وجود دارد، برای جزئیات بیشتر به صفحه احراز هویت و مقداردهی اولیه مراجعه کنید.

ویرایشگر کد

روی آیکون پروفایل در گوشه سمت راست بالای ویرایشگر کد کلیک کنید و از منو، گزینه "تغییر پروژه ابری" را انتخاب کنید. از پنجره انتخاب، یک پروژه را انتخاب کنید.

برنامه‌های موتور زمین

هنگام انتشار یک برنامه Earth Engine ، از شما خواسته می‌شود پروژه‌ای را برای ارسال درخواست‌ها انتخاب کنید. دستورالعمل‌های موجود در کادر محاوره‌ای انتشار را دنبال کنید.

ابزار خط فرمان

برای مرتبط کردن فراخوانی‌های Earth Engine از ابزار خط فرمان با یک پروژه Cloud، از پارامتر --project در فراخوانی earthengine خود استفاده کنید یا set_project برای تنظیم یک پروژه پیش‌فرض استفاده کنید.

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 از یک پروژه ایجاد کنید، برای مثال برای ایجاد برنامه‌ای که اعتبارنامه‌های کاربر را به Earth Engine منتقل می‌کند. می‌توانید با رفتن به منوی Cloud Console ( ) و انتخاب APIها و خدمات > اعتبارنامه‌ها ، اعتبارنامه‌های پروژه Cloud خود را مدیریت کنید. (در صورت درخواست، پروژه را انتخاب کنید).

برای ایجاد یک شناسه کلاینت جدید برای پروژه، روی +CREATE CREDENTIALS > OAuth client ID > Web application کلیک کنید.

در پیکربندی برنامه وب:

  • برای مثال، منابع مجاز جاوا اسکریپت را مشخص کنید: 
http://localhost:8080
https://foo-ee-project.appspot.com
  • برای مثال، URI های مجاز برای تغییر مسیر را مشخص کنید: 
http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback

درباره احراز هویت کاربران با OAuth بیشتر بدانید .

سناریوهای رایج

دارم یه کلاس آموزشی برگزار میکنم...

عالیه! اگر یک پروژه غیرتجاری ثبت کنید، نیازی به پیکربندی صورتحساب نیست. سپس می‌توانید دانش‌آموزان خود را به پروژه اضافه کنید.

من عضوی از یک تیم عملیاتی/سازمان تجاری هستم...

عالیه! شما می‌توانید یک پروژه را برای استفاده تجاری ثبت کنید و همکاران خود را به آن اضافه کنید. لطفاً به محدودیت تعداد صندلی در اشتراک Earth Engine که انتخاب می‌کنید نیز توجه کنید.

حذف داده‌های Earth Engine

حذف در سطح حساب کاربری

حذف در سطح حساب کاربری، تمام داده‌های Earth Engine را از حساب شما حذف می‌کند.

اگر حساب شما بخشی از یک سازمان Google Workspace باشد، مدیر شما داده‌های حساب شما را کنترل می‌کند. وقتی یک مدیر یک حساب Google را حذف می‌کند ، تمام داده‌های مرتبط با Earth Engine ظرف تقریباً 30 روز پاک می‌شوند.

بازیابی اطلاعات پس از حذف، برای تیم Earth Engine امکان‌پذیر نیست.

پروژه‌های ابری

وقتی یک پروژه ابری حذف می‌شود ، باعث حذف داده‌های Earth Engine مرتبط با آن پروژه می‌شود (از جمله، برای مثال، هرگونه دارایی ذخیره شده در ریشه پروژه، هرگونه برنامه EE در سطح پروژه، داده‌های مانیتورینگ و غیره). این فرآیند ممکن است تا 30 روز قابل برگشت باشد، اما بازیابی آن داده‌ها پس از 30 روز هرگز امکان‌پذیر نیست.

دارایی‌ها

ساده‌ترین روش برای حذف دارایی‌هایتان، استفاده از تب «دارایی‌ها» در ویرایشگر کد برای مشاهده و حذف دستی دارایی‌های Earth Engine است.

برای حذف دارایی با شناسه projects/{project-id}/assets/{asset-id} از طریق برنامه‌نویسی (مثلاً projects/my-project/assets/my-asset ):

کلاینت پایتون 

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

کلاینت جاوا اسکریپت

توجه داشته باشید که محیط امنیتی ویرایشگر کد (Code Editor) مانع از اجرای این فراخوانی در آن محیط می‌شود.

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

ابزار خط فرمان

از دستور rm استفاده کنید:

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

اسکریپت‌های ویرایشگر کد

برای حذف اسکریپت‌های ویرایشگر کد Earth Engine :

ویرایشگر کد

از تب «اسکریپت‌ها» در ویرایشگر کد ، یک اسکریپت یا مخزن را انتخاب کرده و آن را حذف کنید. پس از علامت‌گذاری یک مخزن به عنوان حذف‌شده، ظرف 30 روز غیرقابل بازیابی می‌شود.

استفاده از گیت

کاربران پیشرفته می‌توانند از گیت برای مدیریت اسکریپت‌های خود استفاده کنند. برای مشاهده‌ی مخازن قابل مشاهده، به https://earthengine.googlesource.com/ مراجعه کنید.

برنامه‌های موتور زمین

برای حذف برنامه‌های Earth Engine خود، از دکمه «برنامه‌ها» در ویرایشگر کد برای مدیریت برنامه‌های خود استفاده کنید.

از صفحه مدیریت پیوندها برای مشاهده و حذف پیوندهای «دریافت پیوند» خود از ویرایشگر کد استفاده کنید. این صفحه را می‌توانید با رفتن به گزینه «مدیریت پیوندها» در منوی کشویی کنار دکمه «دریافت پیوند» پیدا کنید.

پیکربندی دسترسی غیرتجاری

برای تنظیم دسترسی غیرتجاری (بدون پرداخت) به Earth Engine برای پروژه خود، باید پرسشنامه ثبت نام را در کنسول Cloud پر کنید تا واجد شرایط بودن پروژه خود را تأیید کنید.

تأیید

از آنجا که Earth Engine دسترسی رایگان به حجم زیادی از منابع محاسباتی را فراهم می‌کند، گوگل برای هر پروژه‌ای که برای دسترسی غیرتجاری ثبت شده است، تأییدیه می‌خواهد. فرآیند تأیید به عنوان بخشی از ثبت نام انجام می‌شود. اگر پرسشنامه تأیید را تکمیل کنید و پروژه شما تجاری تشخیص داده شود، بدون پرداخت هزینه، واجد شرایط استفاده از Earth Engine نخواهید بود.

از ۲۶ سپتامبر ۲۰۲۵، تمام پروژه‌های غیرتجاری باید پرسشنامه را در کنسول ابری پر کرده باشند. توصیه می‌کنیم فرآیند تأیید را در اسرع وقت تکمیل کنید. اگر قبل از ۲۶ سپتامبر ۲۰۲۵ اقدامی نکنید، دسترسی پروژه شما به Earth Engine تا زمان تکمیل فرآیند تأیید متوقف خواهد شد.

تأیید مجدد

تمام پروژه‌هایی که دسترسی غیرتجاری دارند، باید به صورت دوره‌ای دسترسی خود را مجدداً تأیید کنند.

پیکربندی دسترسی تجاری

برای تنظیم دسترسی تجاری (پولی) Earth Engine برای پروژه خود، باید پروژه را با استفاده از صفحه ثبت نام پیکربندی کنید و یک طرح را در حساب صورتحساب انتخاب کنید.

قطع دسترسی تجاری

اگر مشتری مستقیم Earth Engine هستید و می‌خواهید استفاده از Earth Engine را در یک زمینه پولی متوقف کنید، برای متوقف کردن هزینه‌های اضافی، چندین تغییر لازم است:

  • هزینه‌های اشتراک را متوقف کنید

    • برای خاتمه اشتراک Earth Engine در حساب صورتحساب خود، باید از صفحه «مدیریت طرح‌ها» استفاده کنید (این صفحه از منوی کشویی تنظیمات کاربر در سمت راست بالای ویرایشگر کد، هنگام استفاده از یک پروژه Cloud ثبت‌شده مرتبط با آن حساب صورتحساب، قابل دسترسی است).

    • همچنین می‌توانید مستقیماً به صفحه «مدیریت طرح‌ها» برای یک حساب صورتحساب دسترسی پیدا کنید:

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

    • انتخاب طرح «محدود» باعث می‌شود که حساب صورتحساب شما پس از چرخه صورتحساب فعلی‌تان، متحمل هیچ هزینه اشتراک دیگری برای پلتفرم Earth Engine نشود.

  • هزینه‌های محاسباتی را متوقف کنید

    • برای جلوگیری از هزینه‌های جدید مربوط به محاسبه (EECU-time)، API مربوط به Earth Engine را در پروژه(های) ابری خود غیرفعال کنید. توجه داشته باشید که این کار درخواست‌های در حال انجام را خاتمه نمی‌دهد یا اشیاء ذخیره شده را حذف نمی‌کند ، بنابراین ممکن است حتی با غیرفعال بودن API، همچنان متحمل هزینه‌های Earth Engine شوید.
    • برای اطلاعات بیشتر در مورد غیرفعال کردن APIها، به راهنمای کنسول API مراجعه کنید.

  • هزینه‌های ذخیره‌سازی را متوقف کنید

    • دارایی‌های ذخیره‌شده موتور زمین حتی اگر API غیرفعال باشد، همچنان هزینه‌ها را افزایش می‌دهند. حذف دارایی‌هایتان شما را از متحمل شدن هزینه‌های ذخیره‌سازی EE بیشتر باز می‌دارد.