نمای کلی App Engine و Earth Engine

Google App Engine به شما امکان می‌دهد برنامه‌های سفارشی خودتان را در سرورهای Google بسازید و اجرا کنید. ایجاد، نگهداری، و مقیاس‌بندی برنامه‌های App Engine با تغییر ترافیک و نیازهای ذخیره‌سازی داده آسان است. کافی است کد منبع برنامه‌تان را بارگذاری کنید تا آماده استفاده شود. اگر در توسعه برای App Engine تازه‌کار هستید، حتماً پیش‌از ادامه دادن، Python یا Node.js در App Engine را بررسی کنید.

Earth Engine و App Engine را می‌توان با هم برای ساختن برنامه‌های زمین‌مکانی مقیاس‌پذیر استفاده کرد. معمولاً کد App Engine شما شامل کتابخانه کارخواه Earth Engine Python است و بااستفاده از حساب سرویس درخواست‌هایی به بااِست Earth Engine ارسال می‌کند. این کار مفید است زیرا به همه اجازه می‌دهد بدون ورود به سیستم یا ثبت‌نام به‌عنوان کاربر Earth Engine از برنامه شما استفاده کنند. توجه داشته باشید که محدودیت‌های استفاده استاندارد Earth Engine برای هر حساب سرویس اعمال می‌شود.

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

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

مستقر کردن برنامه‌های App Engine با Earth Engine

دستورالعمل‌های زیر نحوه استقرار برنامه‌های نمایشی را توضیح می‌دهد. دستورالعمل‌های Python برای Mac OS و Linux درنظر گرفته شده است. اگر از Python در Windows استفاده می‌کنید، این را امتحان کنید.

Earth Engine API را در پروژه Google Cloud خود فعال کنید

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

راه‌اندازی اعتبارنامه‌ها

حساب خدمات

ممکن است از حساب خدمات برای مجاز کردن درخواست‌ها به Earth Engine ازطرف هرکسی که از برنامه‌تان استفاده می‌کند استفاده شود. فایل config.py حاوی کد اصالت‌سنجی بااستفاده از نشانی ایمیل حساب خدمات و فایل کلید خصوصی است. برای راه‌اندازی اصالت‌سنجی با حساب سرویس، این دستورالعمل‌ها را برای ایجاد حساب سرویس و فایل کلید خصوصی دنبال کنید. نام فایل کلید را .private-key.json بگذارید و آن را به دایرکتوری پروژه‌تان منتقل کنید.

Python

اگر قبلاً این کار را نکرده‌اید، ابتدا Earth Engine Python API را راه‌اندازی کنید. حساب سرویس را طبق این دستورالعمل‌ها آزمایش کنید.

اگر آزمایش موفقیت‌آمیز بود، config.py (یا فایل معادل آن در کد منبع) را با نشانی ایمیل حساب سرویس خود به‌روز کنید. (مسیر فایل کلید نباید تغییر کند چون در فهرست راهنمای پروژه شما است).

Node.js

با اجرای npm install، وابستگی‌های پروژه را نصب کنید. Earth Engine Node.js API و هر وابستگی دیگری در پوشه ./node_modules در دایرکتوری پروژه‌تان کپی خواهد شد. اگر نصب ناموفق بود، بررسی کنید که نسخه جدیدی از Node.js نصب شده باشد. کتابخانه را اصالت‌سنجی و مقداردهی اولیه کنید، my-project را با شناسه پروژه Google Cloud خود جایگزین کنید:

const ee = require('@google/earthengine');
ee.data.authenticateViaPrivateKey('.private-key.json');
ee.initialize(null, null, null, null, null, 'my-project');

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

اگر می‌خواهید کاربران با هویت خودشان اصالت‌سنجی شوند (به‌جای استفاده از حساب سرویس)، باید «شناسه کارخواه OAuth» را از «پروژه ابری» خودتان راه‌اندازی کنید. برای انجام این کار:

  1. شناسه کارخواهی را طبق این دستورالعمل‌ها راه‌اندازی کنید.
  2. static/script.js (یا فایل معادل در کد منبع) را به‌روز کنید تا از شناسه مشتری‌تان استفاده کند.
  3. مطمئن شوید ee_api_js.js در فهرست راهنمای /static/ (یا معادل آن) دردسترس باشد. می‌توانید آن را مستقیماً از GitHub بارگیری کنید، از npm نصب کنید، یا اگر قبلاً کل مخزن EE API را شبیه‌سازی کرده‌اید، آن را از earthengine-api/javascript/build در سیستم فایل محلی خود کپی کنید.

راه‌اندازی محیط توسعه محلی

Python

دستورالعمل‌های موجود در هر فهرست راهنمای نمونه در GitHub را برای بارگیری و ساخت پروژه دنبال کنید. اگر فایل build.sh وجود دارد، آن را از پوشه ریشه برنامه با این فرمان اجرا کنید:

./build.sh

دستورگان راه‌اندازی وابستگی‌ها را بارگیری می‌کند و ابزارهای خط فرمان Google را نصب می‌کند، اگر ازقبل در سیستم شما وجود نداشته باشند. Earth Engine Python API و وابستگی‌های آن در پوشه ./lib در فهرست راهنمای پروژه شما کپی خواهد شد.

با اجرای دستور زیر، بررسی کنید که ابزارهای خط فرمان App Engine دردسترس باشند:

dev_appserver.py

اگر فرمان پیدا نشد، Google App Engine SDK for Python را به‌صورت دستی بارگیری و نصب کنید. اگر فرمان دردسترس باشد، باید با «خطا: متغیرهای مستقل بسیار کم» ناموفق شود.

Node.js

نیازی به راه‌اندازی نیست.

اجرا به‌صورت محلی

وقتی حساب سرویس شما ثبت شد تا به Earth Engine دسترسی داشته باشد، می‌توانید از آن برای اصالت‌سنجی (به config.py مراجعه کنید) هنگام آزمایش نمونه‌ها استفاده کنید. ابتدا نمونه‌ها را به‌صورت محلی با رفتن به فهرست راهنمای پروژه خود و اجرای دستور زیر آزمایش کنید:

Python
dev_appserver.py .
Node.js
npm install
npm start

مرورگرتان را به http://localhost:8080 هدایت کنید تا برنامه درحال اجرا در سرور محلی را ببینید. هر تغییری که ایجاد (و ذخیره) کنید، هنگام بازآوری صفحه به‌طور خودکار اعمال می‌شود.