Google App Engine מאפשר לכם ליצור ולהפעיל אפליקציות בהתאמה אישית בשרתים של Google. קל ליצור, לתחזק ולהתאים את האפליקציות של App Engine לשינויים בנפח תנועת המשתמשים ובצרכים של מאגר הנתונים. פשוט מעלים את קוד המקור של האפליקציה והיא מוכנה לפעולה. אם אתם חדשים בפיתוח ל-App Engine, כדאי לעיין במדריך למתחילים של App Engine ב-Python או ב-Node.js לפני שתמשיכו.
אפשר להשתמש ב-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 מהפרויקט בענן. כדי לעשות את זה:
- מגדירים מזהה לקוח לפי ההוראות האלה.
- מעדכנים את
static/script.js(או קובץ מקביל בקוד המקור) כדי להשתמש במזהה הלקוח. - מוודאים שהקובץ
ee_api_js.jsזמין בספרייה/static/(או בספרייה מקבילה). אפשר להוריד אותו ישירות מ-GitHub, להתקין אותו מ-npm או, אם כבר שיכפלתם את כל המאגר של EE API, להעתיק אותו מ-earthengine-api/javascript/buildבמערכת הקבצים המקומית.
הגדרת סביבת הפיתוח המקומית
Python
כדי להוריד ולבנות את הפרויקט, פועלים לפי ההוראות בכל ספריית דוגמה ב-GitHub. אם יש קובץ build.sh, מריצים אותו מתיקיית השורש של האפליקציה באמצעות הפקודה:
./build.sh
סקריפט ההגדרה יוריד יחסי תלות ויתקין את כלי שורת הפקודה של Google, אם הם עדיין לא קיימים במערכת. Earth Engine API בשפת Python ויחסי התלות שלו יועתקו לתיקייה ./lib בספריית הפרויקט.
כדי לוודא שכלי שורת הפקודה של App Engine זמינים, מריצים את הפקודה:
dev_appserver.py
אם הפקודה לא נמצאה, נסו להוריד ולהתקין ידנית את Google App Engine SDK for Python. אם הפקודה זמינה, היא אמורה להיכשל עם השגיאה "error: too few arguments".
Node.js
לא צריך להגדיר שום דבר.
הרצה מקומית
אחרי שחשבון השירות רשום לגישה ל-Earth Engine, אפשר להשתמש בו לאימות (ראו config.py) כשבודקים את הדוגמאות. כדאי לבדוק את הדוגמאות באופן מקומי קודם, על ידי מעבר לספריית הפרויקט והרצת הפקודה:
Python
dev_appserver.py .
Node.js
npm install npm start
עוברים אל http://localhost:8080 בדפדפן כדי לראות את האפליקציה פועלת בשרת מקומי. כל שינוי שתבצעו (ותשמרו) יתעדכן באופן אוטומטי כשתרעננו את הדף.