مقدمه
برنامه های Earth Engine رابط های کاربری پویا و قابل اشتراک گذاری برای تجزیه و تحلیل Earth Engine هستند. با برنامه‌ها، کارشناسان می‌توانند از عناصر ساده UI برای استفاده از فهرست داده‌های Earth Engine و قدرت تحلیلی، برای استفاده کارشناسان و غیرمتخصصان استفاده کنند.
برنامه‌های منتشر شده از Earth Engine از URL خاص برنامه تولید شده در زمان انتشار قابل دسترسی هستند. هیچ حساب Earth Engine برای مشاهده یا تعامل با یک برنامه منتشر شده مورد نیاز نیست. برنامه‌هایی که توسط سازنده‌شان به‌عنوان برجسته انتخاب شده‌اند نیز در گالری برنامه‌های خاص کاربر (مانند USERNAME.users.earthengine.app) در دسترس هستند.
اپلیکیشن خود را بسازید
برنامه‌های Earth Engine می‌توانند از بسیاری از عملکردهای مشابه استفاده شده در ویرایشگر کد، به استثنای چند مورد، بهره ببرند. علاوه بر این، ما رابط کاربری رابط کاربری API را با در نظر گرفتن توسعه دهندگان برنامه ها طراحی کردیم. اگر با رابط کاربری رابط کاربری API تازه وارد هستید، نگاهی به نمای کلی UI API بیندازید.
انتشار اپلیکیشن شما
برای انتشار یک برنامه از ویرایشگر کد، ابتدا اسکریپتی را که می خواهید بسازید در یک برنامه بارگیری کنید و سپس پنل مدیریت برنامه را باز کنید، که می توانید با کلیک بر روی دکمه برنامه ها در بالای بخش اسکریپت در ویرایشگر کد به آن دسترسی داشته باشید.
سپس بر روی دکمه NEW APP کلیک کنید.
در گفتگو، دسترسی ویرایشگر، نام برنامه را انتخاب کنید، پروژه Google Cloud را انتخاب کنید و محل کد منبع برنامه را مشخص کنید. دسترسی به این برنامه را به یک گروه Google خاص محدود کنید یا آن را با استفاده از گزینه‌های زیر برگه محدودیت در دسترس عموم قرار دهید. برای برنامه‌های در دسترس عموم، می‌توانید یک تصویر پیش‌نمایش سفارشی برای برنامه و همچنین توضیحی در برگه گالری ارائه دهید. اگر می‌خواهید این برنامه در گالری عمومی برنامه‌های موجود در USERNAME.users.earthengine.app نمایش داده شود، روی «این برنامه را در گالری برنامه‌هایتان نشان دهید» کلیک کنید. با آپلود یک تصویر دلخواه از برگه لوگو، به صورت اختیاری، یک لوگوی سفارشی را در گوشه سمت چپ بالای برنامه اضافه کنید.
مدیریت برنامه های شما
برای مدیریت یک برنامه از ویرایشگر کد، پانل مدیریت برنامه را با کلیک بر روی دکمه برنامه‌ها در بالای بخش اسکریپت در ویرایشگر کد باز کنید. از اینجا می توانید پیکربندی برنامه خود را به روز کنید یا برنامه را حذف کنید.
در برنامه های متعلق به پروژه با دیگران همکاری کنید
به‌طور پیش‌فرض، برنامه‌هایی که تحت نام کاربری خود منتشر می‌کنید، فقط توسط شما قابل ویرایش هستند. همکاری در برنامه ها با برنامه های متعلق به پروژه امکان پذیر است. برنامه‌های متعلق به پروژه برنامه‌هایی هستند که تحت مالکیت و انتشار یک پروژه ابری هستند. هر کسی که نقش Earth Engine Apps Publisher IAM را دارد می‌تواند برنامه‌های منتشر شده تحت پروژه Cloud را ویرایش و حذف کند. درباره نقش های IAM Engine Earth در اینجا بیشتر بیاموزید .
برای فعال کردن برنامه‌های متعلق به پروژه، گزینه Cloud Project را در مرحله «انتخاب دسترسی ویرایش» انتخاب کنید و پروژه Cloud را که می‌خواهید استفاده کنید انتخاب کنید، سپس جریان انتشار برنامه را به طور معمول به پایان برسانید. این برنامه در دامنه PROJECT-ID.projects.earthengine.app منتشر خواهد شد و توسط هر کسی که نقش ناشر Earth Engine Apps IAM را در پروژه Cloud داشته باشد قابل ویرایش خواهد بود.
برای مشاهده برنامه‌های یک پروژه ابری، دکمه ADD CLOUD PROJECT را فشار دهید و پروژه Cloud را انتخاب کنید.
برای اشتراک‌گذاری پروژه ابری با دیگران، دکمه SHARE PROJECT را فشار دهید. این شما را به صفحه IAM کنسول Cloud برای پروژه می برد که در آنجا می توانید نقش IAM ناشر Earth Engine Apps را به همکاران اعطا کنید.
سوالات متداول
- چگونه یک برنامه را از گالری برنامه های خود حذف کنم؟
- چک باکس "ویژگی این برنامه" در صفحه پیکربندی برنامه کنترل می کند که آیا یک برنامه در صفحه برنامه های ویژه ظاهر می شود یا نه. برنامه‌های با دسترسی محدود قابل نمایش نیستند.
- آیا کد Earth Engine من قابل مشاهده است؟
- بله، برای هر کسی که می تواند به برنامه دسترسی داشته باشد. اگرچه زمانی که برنامه شما منتشر می شود به وضوح قابل مشاهده نیست، اما مشاهده جاوا اسکریپت برای برنامه شما با مشاهده ترافیک شبکه به مرورگر وب برای شخصی نسبتاً آسان است. برای مثال، در کروم، جاوا اسکریپت با نگاه کردن به پنل شبکه ابزارهای توسعه‌دهنده قابل مشاهده خواهد بود.
- برخی از دلایل احتمالی خطای "خطایی در بارگیری برخی از قسمت‌های نقشه وجود داشت" برای یک برنامه منتشر شده چیست؟
- اطمینان حاصل کنید که تمام دارایی های تصویر یا جدول استفاده شده در برنامه شما به صورت عمومی یا با برنامه به اشتراک گذاشته شده است. در گفتگوی اشتراک دارایی ، گزینه "Anyone can read" را انتخاب کنید یا نام برنامه را از لیست کشویی انتخاب کنید. برای برنامه‌هایی که محدود به یک گروه Google هستند، اشتراک‌گذاری دارایی با آن گروه Google باعث نمی‌شود که برنامه قابل مشاهده باشد. در عوض، دارایی ها باید با برنامه یا به صورت عمومی به اشتراک گذاشته شوند.
- چرا صفحه "برنامه هنوز آماده نیست" را می بینم؟
- پس از ایجاد یک برنامه، ممکن است مدتی طول بکشد تا اطلاعات در سیستم منتشر شود. این معمولا در عرض چند دقیقه حل می شود. اگر خطا ادامه داشت، لطفاً برای کمک تماس بگیرید .
- چرا هندسه های ترسیم شده من در برنامه من نشان داده شده است؟
- این کار نشان دادن هندسه های مرجع را در برنامه شما آسان می کند و به شما امکان می دهد برنامه هایی ایجاد کنید که کاربران بتوانند هندسه ها را ویرایش کنند. اگر نمی‌خواهید هندسه‌های خاصی نشان داده یا ویرایش شوند، می‌توانید لایه‌های هندسی مجزا را پنهان یا قفل کنید تا قبل از انتشار برنامه‌تان از دیدن یا ویرایش آنها توسط کاربران جلوگیری شود. برای اطلاعات بیشتر به مستندات ابزار هندسه مراجعه کنید.
- سهمیه اپلیکیشن چیست؟
- برای جلوگیری از تأثیر منفی اسکریپت‌های اشتباه یا فشرده بر روی دسترسی به سرویس، Earth Engine دارای سهمیه‌های استفاده از برنامه در جستارهای همزمان است. این سهمیه مشابه سهمیه هر کاربر Earth Engine عمل می‌کند، با این تفاوت که این سهمیه به‌جای یک کاربر خاص، به یک برنامه مرتبط است.
- آیا هر برنامه ای که من می سازم سهمیه خاص خود را دارد؟
- بله، سهمیه جداگانه با هر برنامه مرتبط است. برای برنامه‌های قدیمی‌تر که با کلید API ایجاد می‌شوند، سهمیه به پروژه Cloud وابسته است که از آن کلید API یک برنامه را تولید می‌کنید. اگر چندین کلید API را از یک پروژه Cloud ایجاد کنید، همه آنها سهمیه استفاده یکسانی خواهند داشت.
- چرا یک حساب صورتحساب Cloud مورد نیاز است؟ آیا برای برنامه هایم هزینه ای از من دریافت می شود؟
- ما از Google Cloud Platform برای انواع کارهای پشت صحنه استفاده می کنیم. برای ایجاد اپلیکیشن Earth Engine هیچ هزینه ای از شما دریافت نمی شود. با این حال، Google Cloud Storage رایگان نیست، بنابراین اگر تصمیم بگیرید که نتایج تجزیه و تحلیل های خود را به Google Cloud Storage صادر کنید، ممکن است هزینه مربوط به آن وجود داشته باشد.
- چگونه می توانم میزان استفاده و سهمیه برنامه هایم را بهتر درک کنم؟
اگر از سهمیه فراتر رود، Earth Engine ممکن است خطاهای
HTTP 429: Too Many Requestsبرگرداند. به طور کلی، این خطاها توسط کتابخانه مشتری Earth Engine مدیریت می‌شود، که درخواست‌ها را به صورت نمایی جمع‌آوری می‌کند و پرس و جو را دوباره امتحان می‌کند تا موفق شود. کتابخانه مشتری Earth Engine درخواست را پنج بار دوباره امتحان خواهد کرد.اگر برنامه شما به قدری محبوب شود که بسیاری از کاربران با خطاهای فراتر از سهمیه مواجه شوند، کاربران یک پیام هشدار می بینند و Earth Engine ممکن است مجبور شود (به طور موقت) دسترسی به برنامه را محدود کند.
برای کمک به جلوگیری از دریافت خطاهای 429، ممکن است بخواهید ذخیره سازی را برای برنامه خود فعال کنید، مانند ذخیره آمار کل قابل ذخیره به عنوان دارایی های جدول Earth Engine، به جای محاسبه آن ها در لحظه.