إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
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) |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe \u003ccode\u003eee.initialize()\u003c/code\u003e function initializes the Earth Engine library, setting the API endpoint and optional tile server.\u003c/p\u003e\n"],["\u003cp\u003eInitialization can be performed synchronously or asynchronously with success and error callbacks.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization should typically be handled before initialization using \u003ccode\u003eee.data.authorize()\u003c/code\u003e or \u003ccode\u003eee.data.setAuthToken()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eee.initialize()\u003c/code\u003e offers parameters for customization, like base URL, tile URL, and project ID.\u003c/p\u003e\n"],["\u003cp\u003eThe Python equivalent is \u003ccode\u003eee.Initialize()\u003c/code\u003e, with minor parameter differences compared to JavaScript.\u003c/p\u003e\n"]]],[],null,["# ee.initialize\n\n\u003cbr /\u003e\n\nInitialize the library. If this hasn't been called by the time any object constructor is used, it will be called then. If this is called a second time with a different baseurl or tileurl, this doesn't do an un-initialization of e.g.: the previously loaded Algorithms, but will overwrite them and let point at alternate servers.\n\n\u003cbr /\u003e\n\nIf initialize() is first called in asynchronous mode (by passing a success callback), any future asynchronous mode calls will add their callbacks to a queue and all the callbacks will be run together.\n\nIf a synchronous mode call is made after any number of asynchronous calls, it will block and execute all the previously supplied callbacks before returning.\n\nIn most cases, an authorization token should be set before the library is initialized, either with ee.data.authorize() or ee.data.setAuthToken().\n\nIn Python, this method is named ee.Initialize, with a capital I. Note that some parameters differ between JavaScript and Python. In addition to opt_url and project below, Python also supports: credentials - a google.oauth2.Credentials object or 'persistent' to use stored credentials (the default); http_transport - a httplib2.Http client.\n\n| Usage | Returns |\n|--------------------------------------------------------------------------------------------------------------------|---------|\n| `ee.initialize(`*baseurl* `, `*tileurl* `, `*successCallback* `, `*errorCallback* `, `*xsrfToken* `, `*project*`)` | |\n\n| Argument | Type | Details |\n|-------------------|--------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `baseurl` | String, optional | The Earth Engine REST API endpoint. (Python argument name: opt_url) |\n| `tileurl` | String, optional | The Earth Engine REST tile endpoint, this is optional and defaults to baseurl. (JavaScript only) |\n| `successCallback` | Function, optional | An optional callback to be invoked when the initialization is successful. If not provided, the initialization is done synchronously. (JavaScript only) |\n| `errorCallback` | Function, optional | An optional callback to be invoked with an error if the initialization fails. (JavaScript only) |\n| `xsrfToken` | String, optional | A string to pass in the \"xsrfToken\" parameter of EE API XHRs. (JavaScript only) |\n| `project` | String, optional | Optional client project ID or number to use when making API calls. (Python argument name: project) |"]]
