إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ee.Image.loadZarrV2Array
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تُحمِّل صفيف Zarr v2 كصورة. يجب أن تحتوي سمات الصفيف (.zattrs) على الحقل _ARRAY_DIMENSIONS، وهو قائمة بأسماء كل سمة (مثل ['time', 'y', 'x']). يجب أن يكون هناك سمتان على الأقل، مع تمثيل السمتَين الأخيرتَين لسمتَي Y وX على التوالي (على سبيل المثال، ['lat', 'lon']). برامج ترميز الضغط المتوافقة هي blosc وgzip وlz4 وzlib وzstd. برامج ترميز ضغط البيانات الفائقة blosc المتوافقة هي lz4 وlz4hc وzlib وzstd (لا يُسمح باستخدام blosclz).
| الاستخدام | المرتجعات |
|---|
ee.Image.loadZarrV2Array(uri, proj, starts, ends) | صورة |
| الوسيطة | النوع | التفاصيل |
|---|
uri | سلسلة | معرّف الموارد المنتظم (URI) الخاص بخدمة Cloud Storage لملف .zarray المطلوب تحميله يجب أن يكون ملف .zmetadata متوفّرًا في الدليل الرئيسي لدليل الصفيف (على سبيل المثال، بالنسبة إلى "gs://b/o/.zarray"، يجب أن يكون "gs://b/.zmetadata" متوفّرًا). يجب أن تكون البيانات الوصفية للحزمة متاحة للوصول إليها (يتطلب ذلك الحصول على الإذن storage.buckets.get الذي يوفّره الدور "قارئ الحِزم القديمة في مساحة التخزين"، من بين أذونات أخرى، اطّلِع على https://cloud.google.com/storage/docs/access-control/iam-roles)، ويجب أن تكون الحزمة متوفّرة في منطقة متعددة في الولايات المتحدة أو منطقة مزدوجة تشمل US-CENTRAL1 أو منطقة US-CENTRAL1. |
proj | الإسقاط | إسقاط الصفيف |
starts | قائمة، القيمة التلقائية: فارغة | المؤشرات (شاملة) التي يجب أن تبدأ عندها عملية أخذ الشرائح على طول كل سمة غير مكانية إذا كانت القيمة فارغة، ستبدأ الشرائح من الفهرس 0 لجميع السمات غير المكانية. في حال تحديدها، يجب أن يكون طول هذه القائمة مساويًا لعدد السمات غير المكانية (إجمالي السمات - 2). قد يكون عنصر فردي ضمن القائمة فارغًا، ما يؤدي تلقائيًا إلى ضبطه على 0 لهذه السمة. يتم احتساب المؤشرات السالبة من نهاية السمة (مثل، -1 هو العنصر الأخير). |
ends | قائمة، القيمة التلقائية: فارغة | الفهارس (الحصرية) التي يتم عندها إيقاف أخذ الشرائح على طول كل سمة غير مكانية إذا كانت القيمة فارغة، ستمتد الشرائح إلى نهاية كل سمة غير مكانية مقابلة (أي القيمة التلقائية هي طول السمة). في حال تحديدها، يجب أن يكون طول هذه القائمة مساويًا لعدد السمات غير المكانية (إجمالي السمات - 2). قد يكون عنصر فردي ضمن القائمة فارغًا، ما يؤدي تلقائيًا إلى ضبط طول تلك السمة. يتم احتساب الفواصل الزمنية السالبة من نهاية السمة (مثل، -1 هو العنصر الأخير). |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# ee.Image.loadZarrV2Array\n\nLoads a Zarr v2 array as an Image. The array attributes (.zattrs) must contain the field '_ARRAY_DIMENSIONS', which is a list of the names of each dimension (e.g., \\['time', 'y', 'x'\\]). There must be at least two dimensions, with the final two representing Y and X respectively (e.g., \\['lat', 'lon'\\]). The supported compression codecs are 'blosc', 'gzip', 'lz4', 'zlib', and 'zstd'. The supported blosc meta-compression codecs are 'lz4', lz4hc', 'zlib', and 'zstd' ('blosclz' is not supported).\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|--------------------------------------------------------------|---------|\n| `ee.Image.loadZarrV2Array(uri, proj, `*starts* `, `*ends*`)` | Image |\n\n| Argument | Type | Details |\n|----------|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `uri` | String | The Cloud Storage URI of the .zarray file to load. A .zmetadata file must be present in the parent directory of the array's directory (e.g., for 'gs://b/o/.zarray', 'gs://b/.zmetadata' must be present). The bucket metadata must be accessible (requires the \\`storage.buckets.get\\` permission which is provided by the role \"Storage Legacy Bucket Reader\" among others, see https://cloud.google.com/storage/docs/access-control/iam-roles) and the bucket must be located in the US multi-region, a dual-region including US-CENTRAL1, or the US-CENTRAL1 region. |\n| `proj` | Projection | The projection of the array. |\n| `starts` | List, default: null | The indices (inclusive) at which to start taking slices along each non-spatial dimension. If null, slices will start at index 0 for all non-spatial dimensions. If specified, this list must have a length equal to the number of non-spatial dimensions (total dimensions - 2). An individual element within the list may be null, which defaults to 0 for that dimension. Negative indices are counted from the end of the dimension (e.g., -1 is the last element). |\n| `ends` | List, default: null | The indices (exclusive) at which to stop taking slices along each non-spatial dimension. If null, slices will extend to the end of each corresponding non-spatial dimension (i.e., defaults to the length of the dimension). If specified, this list must have a length equal to the number of non-spatial dimensions (total dimensions - 2). An individual element within the list may be null, which also defaults to the length of that dimension. Negative indices are counted from the end of the dimension (e.g., -1 is the last element). |"]]
