إذا تم استدعاء 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 | سلسلة، اختيارية | نقطة نهاية REST API في Earth Engine (اسم وسيطة Python: opt_url) |
tileurl | سلسلة، اختيارية | نقطة نهاية مربّع REST في Earth Engine، وهي اختيارية ويتم ضبطها تلقائيًا على baseurl. (JavaScript فقط) |
successCallback | الدالة، اختيارية | دالة رد اتصال اختيارية يتم استدعاؤها عند نجاح عملية الإعداد. وفي حال عدم توفيره، يتم إجراء الإعداد بشكل متزامن. (JavaScript فقط) |
errorCallback | الدالة، اختيارية | عملية استدعاء اختيارية يتم استدعاؤها مع ظهور خطأ في حال تعذّر الإعداد (JavaScript فقط) |
xsrfToken | سلسلة، اختيارية | سلسلة يتم تمريرها في مَعلمة "xsrfToken" لطلبات XHR في واجهة برمجة تطبيقات Earth Engine. (JavaScript فقط) |
project | سلسلة، اختيارية | رقم تعريف مشروع العميل أو رقمه الاختياري لاستخدامه عند إجراء طلبات البيانات من واجهة برمجة التطبيقات. (اسم وسيطة Python: project) |