אם הפונקציה initialize() נקראת קודם במצב אסינכרוני (על ידי העברת קריאה חוזרת (callback) מוצלחת), כל הקריאות העתידיות במצב אסינכרוני יוסיפו את הקריאות החוזרות שלהן לתור וכל הקריאות החוזרות יופעלו יחד.
אם מתבצעת קריאה במצב סינכרוני אחרי מספר כלשהו של קריאות אסינכרוניות, היא תחסום ותבצע את כל הקריאות החוזרות שסופקו קודם לפני שהיא תחזור.
ברוב המקרים, צריך להגדיר אסימון הרשאה לפני שהספרייה עוברת אתחול, באמצעות ee.data.authorize() או ee.data.setAuthToken().
ב-Python, השיטה הזו נקראת ee.Initialize, עם I גדולה. שימו לב שיש הבדלים בין חלק מהפרמטרים ב-JavaScript וב-Python. בנוסף ל-opt_url ול-project שבהמשך, Python תומכת גם ב: credentials – אובייקט google.oauth2.Credentials או persistent לשימוש בפרטי כניסה מאוחסנים (ברירת המחדל); http_transport – צד הלקוח ב-HTTP של httplib2.Http.
| שימוש | החזרות |
|---|---|
ee.initialize(baseurl, tileurl, successCallback, errorCallback, xsrfToken, project) |
| ארגומנט | סוג | פרטים |
|---|---|---|
baseurl | מחרוזת, אופציונלי | נקודת הקצה של Earth Engine API בארכיטקטורת REST. (שם הארגומנט ב-Python: opt_url) |
tileurl | מחרוזת, אופציונלי | נקודת הקצה של האריח ב-Earth Engine REST. זהו שדה אופציונלי, וברירת המחדל היא baseurl. (JavaScript בלבד) |
successCallback | פונקציה, אופציונלי | קריאה חוזרת (callback) אופציונלית שמופעלת כשהאתחול מסתיים בהצלחה. אם לא מציינים את הפרמטר, ההפעלה מתבצעת באופן סינכרוני. (JavaScript בלבד) |
errorCallback | פונקציה, אופציונלי | קריאה חוזרת (callback) אופציונלית שתופעל עם שגיאה אם האתחול ייכשל. (JavaScript בלבד) |
xsrfToken | מחרוזת, אופציונלי | מחרוזת שצריך להעביר בפרמטר "xsrfToken" של בקשות XHR של EE API. (JavaScript בלבד) |
project | מחרוזת, אופציונלי | מספר או מזהה פרויקט אופציונלי של הלקוח, שמשמש לביצוע קריאות ל-API. (שם הארגומנט ב-Python: project) |