إذا تم استدعاء initialize() أولاً في الوضع غير المتزامن (من خلال تمرير دالة ردّ ناجحة)، ستضيف أي استدعاءات مستقبلية للوضع غير المتزامن دوال الردّ إلى قائمة الانتظار وسيتم تشغيل جميع دوال الردّ معًا.
إذا تم إجراء مكالمة في الوضع المتزامن بعد أي عدد من المكالمات غير المتزامنة، سيتم حظر جميع عمليات معاودة الاتصال التي تم توفيرها سابقًا وتنفيذها قبل العودة.
في معظم الحالات، يجب ضبط رمز مميّز للتفويض قبل تهيئة المكتبة، إما باستخدام ee.data.authorize() أو ee.data.setAuthToken().
في Python، يُطلق على هذه الطريقة الاسم ee.Initialize، مع حرف I كبير. يُرجى العِلم أنّ بعض المَعلمات تختلف بين JavaScript وPython. بالإضافة إلى opt_url والمشروع أدناه، تتيح لغة Python أيضًا ما يلي: بيانات الاعتماد - عنصر google.oauth2.Credentials أو "ثابت" لاستخدام بيانات الاعتماد المخزّنة (الإعداد التلقائي)، وhttp_transport - عميل httplib2.Http.
| الاستخدام | المرتجعات |
|---|---|
ee.initialize(baseurl, tileurl, successCallback, errorCallback, xsrfToken, project) |
| الوسيطة | النوع | التفاصيل |
|---|---|---|
baseurl | سلسلة، اختياري | نقطة نهاية Earth Engine REST API (اسم وسيطة Python: opt_url) |
tileurl | سلسلة، اختياري | نقطة نهاية REST الخاصة بقطع Earth Engine، وهي اختيارية ويتم ضبطها تلقائيًا على baseurl. (JavaScript فقط) |
successCallback | الدالة، اختيارية | دالة ردّ اتصال اختيارية يتم استدعاؤها عند اكتمال عملية الإعداد بنجاح. في حال عدم توفيره، يتم إجراء عملية التهيئة بشكل متزامن. (JavaScript فقط) |
errorCallback | الدالة، اختيارية | دالة ردّ اختيارية يتم استدعاؤها مع ظهور خطأ في حال تعذُّر عملية الإعداد. (JavaScript فقط) |
xsrfToken | سلسلة، اختياري | سلسلة نصية يتم تمريرها في المَعلمة "xsrfToken" لطلبات XHR في واجهة برمجة تطبيقات "تجربة المطوّر". (JavaScript فقط) |
project | سلسلة، اختياري | معرّف مشروع العميل أو رقمه الاختياري الذي سيتم استخدامه عند إجراء طلبات إلى واجهة برمجة التطبيقات (اسم وسيطة Python: project) |