ee.initialize

تهيئة المكتبة إذا لم يتم استدعاء هذه الدالة بحلول وقت استخدام أي من دوال إنشاء الكائنات، سيتم استدعاؤها في ذلك الوقت. إذا تم استدعاء هذه الدالة مرة ثانية باستخدام baseurl أو tileurl مختلفَين، لن يؤدي ذلك إلى إلغاء تهيئة، على سبيل المثال، الخوارزميات التي تم تحميلها سابقًا، ولكن سيتم استبدالها والسماح لها بالإشارة إلى خوادم بديلة.

إذا تم استدعاء 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)