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

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

به Earth Engine دسترسی پیدا کنید

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

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

برای ایجاد و ثبت پروژه Cloud جدید یا ثبت پروژه موجود به صفحه ثبت مراجعه کنید.

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

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

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

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

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

Earth Engine API را فعال کنید

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

Earth Engine API را فعال کنید

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

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

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

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

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

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

earthengine create folder projects/my-project/assets/

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

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

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

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

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

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

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

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

ویرایشگر کد

روی نماد نمایه در گوشه سمت راست بالای ویرایشگر کد کلیک کنید و "Change Cloud Project" را از منو انتخاب کنید. یک پروژه را از گفتگوی انتخاب انتخاب کنید.

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

هنگام انتشار یک برنامه 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 Quickstart را ببینید.

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

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

حساب های خدماتی

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

حساب های گوگل

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

شناسه مشتری OAuth 2.0

ممکن است لازم باشد یک شناسه مشتری OAuth 2.0 از یک پروژه ایجاد کنید، به عنوان مثال برای ایجاد برنامه ای که اعتبار کاربری را به Earth Engine منتقل می کند. با رفتن به منوی Cloud Console ( ) و انتخاب APIs & Services > Credentials می‌توانید اعتبارنامه‌های پروژه Cloud خود را مدیریت کنید. (در صورت درخواست، پروژه را انتخاب کنید).

برای ایجاد یک Client ID جدید برای پروژه، روی + 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 را از حساب شما حذف می‌کند.

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

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

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

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

دارایی ها

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

برای حذف دارایی برنامه‌ریزی شده دارایی با ID 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

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

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

ویرایشگر کد

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

با استفاده از Git

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

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

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

از صفحه مدیریت پیوندها برای مشاهده و حذف پیوندهای «دریافت پیوند» از ویرایشگر کد استفاده کنید. این صفحه را می توانید با رفتن به گزینه "Manage Links" در منوی کشویی کنار دکمه "Get Link" پیدا کنید.

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

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

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

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

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

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

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

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

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

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

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