دسترسی به Earth Engine

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

دسترسی به Earth Engine

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

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

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

پروژه‌های ایجادشده درطول فرایند ثبت‌نام را می‌توان در Google Cloud Console مدیریت کرد. می‌توانید Earth Engine API را از صفحه Earth Engine API در «کنسول Cloud» فعال یا غیرفعال کنید.

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

ایجاد پروژه Cloud

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

ایجاد پروژه Cloud

فعال کردن Earth Engine API

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

فعال کردن Earth Engine API

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

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

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

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

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

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

earthengine create folder projects/my-project/assets/

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

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

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

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

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

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

کتابخانه‌های کارخواه (Python،‏ JavaScript)

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

ویرایشگر کد

روی نماد نمایه در گوشه بالا سمت چپ ویرایشگر کد کلیک کنید و «تغییر پروژه ابری» را از منو انتخاب کنید. پروژه‌ای را از کادر گفتگوی انتخاب انتخاب کنید.

برنامه‌های Earth Engine

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

رابط خط فرمان

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

REST API

برای مرتبط کردن تماس‌ها با REST API با پروژه Cloud، تماس‌های HTTP اصالت‌سنجی‌شده صادر کنید که در آن اصالت‌سنجی توسط oauth2 انجام می‌شود. در محیط محلی، می‌توانید از فرمان gcloud استفاده کنید. همچنین می‌توانید از حساب سرویس مرتبط با «پروژه ابری» استفاده کنید. برای نمونه‌ای از استفاده از google.oath.service_account.Credentials.from_service_account_file() برای اصالت‌سنجی با حساب سرویس، شروع سریع REST API را ببینید.

پیکربندی دسترسی به پروژه

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

حساب‌های سرویس

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

حساب‌های Google

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

شناسه کارخواه OAuth 2.0

ممکن است لازم باشد «شناسه کارخواه OAuth 2.0» را از پروژه ایجاد کنید، مثلاً برای ایجاد برنامه‌ای که اعتبارنامه‌های کاربر را به Earth Engine ارسال می‌کند. می‌توانید با رفتن به منوِ کنسول Cloud () و انتخاب میاناهای برنامه‌سازی کاربردی و سرویس‌ها > اطلاعات کاربری، اطلاعات کاربری پروژه Cloud خود را مدیریت کنید. (درصورت درخواست، پروژه را انتخاب کنید).

برای ایجاد «شناسه کارخواه» جدید برای پروژه، روی + ایجاد اطلاعات کاربری > شناسه کارخواه OAuth > برنامه وب کلیک کنید.

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

  • مبدأهای مجاز JavaScript را مشخص کنید، برای مثال:
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 مرتبط ظرف حدود ۳۰ روز پاک می‌شود.

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

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

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

دارایی‌ها

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

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

کارخواه Python

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»:

ویرایشگر کد

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

استفاده از Git

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

برنامه‌های Earth Engine

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

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

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

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

درستی‌سنجی

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

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

درستی‌سنجی مجدد

همه پروژه‌های دارای دسترسی غیرتجاری باید به‌صورت دوره‌ای برای دسترسی درستی‌سنجی مجدد شوند.

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

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

فسخ کردن دسترسی تجاری

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

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

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

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID
      
    • با انتخاب طرح «محدود»، حساب صورت‌حساب شما پس‌از چرخه صورت‌حساب فعلی‌تان دیگر مشمول هزینه اشتراک پلاتفرم Earth Engine نخواهد شد.

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

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

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