قدّمت Earth Engine
فئات حصص غير تجارية لحماية موارد الحوسبة المشتركة وضمان أداء موثوق للجميع. تستخدم المشاريع غير التجارية "فئة المجتمع" تلقائيًا، ولكن يمكنك تغيير فئة المشروع في أي وقت.
تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.
ee.ImageCollection.loadZarrV2Array
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتم تحميل مصفوفة Zarr v2 تتضمّن 3 أبعاد أو أكثر (أي بُعد واحد أو أكثر غير مكاني) كـ ImageCollection عن طريق التقسيم على طول محور غير مكاني محدّد. يجب أن تحتوي سمات المصفوفة (.zattrs) على الحقل "_ARRAY_DIMENSIONS"، وهو قائمة بأسماء كل سمة (مثلاً، ['time', 'y', 'x']). يجب أن يكون هناك بُعدان على الأقل، ويمثّل البُعدان الأخيران Y وX على التوالي (على سبيل المثال، ['lat', 'lon']). برامج ترميز الضغط المتوافقة هي "blosc" و"gzip" و"lz4" و"zlib" و"zstd". برامج ترميز الضغط الوصفي المتوافقة مع blosc هي "lz4" و"lz4hc" و"zlib" و"zstd" (برنامج الترميز "blosclz" غير متوافق).
| الاستخدام | المرتجعات |
|---|
ee.ImageCollection.loadZarrV2Array(uri, proj, axis, starts, ends) | ImageCollection |
| الوسيطة | النوع | التفاصيل |
|---|
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 | العرض | The projection of the array. |
axis | عدد صحيح، القيمة التلقائية: فارغة | المحور غير المكاني (المفهرس من 0) الذي يتم تقسيم الصفيف على طوله لإنشاء ImageCollection. وتمثّل كل صورة في المجموعة شريحة واحدة (بطول 1) على طول هذا المحور. إذا كانت القيمة فارغة، يتم ضبطها تلقائيًا على 0. يجب أن تكون القيمة في النطاق [0, N-1]، حيث N هو عدد الأبعاد غير المكانية (أي إجمالي الأبعاد - 2). يجب أن تحتوي المصفوفة على بُعد واحد على الأقل غير مكاني (أي أن تكون ثلاثية الأبعاد على الأقل). |
starts | قائمة، القيمة التلقائية: فارغة | الفهارس (مشمولة) التي يجب أن يبدأ عندها أخذ الشرائح على طول كل بُعد غير مكاني. إذا كانت القيمة فارغة، ستبدأ الشرائح عند الفهرس 0 لجميع السمات غير المكانية. في حال تحديدها، يجب أن يكون طول هذه القائمة مساويًا لعدد الأبعاد غير المكانية (إجمالي الأبعاد - 2). قد يكون العنصر الفردي ضمن القائمة فارغًا، ويتم ضبطه تلقائيًا على 0 لهذا البُعد. يتم احتساب الفهارس السالبة من نهاية البُعد (على سبيل المثال، -1 هو العنصر الأخير). |
ends | قائمة، القيمة التلقائية: فارغة | الفهارس (غير شاملة) التي يجب عندها التوقف عن أخذ الشرائح على طول كل بُعد غير مكاني. إذا كانت القيمة فارغة، ستمتد الشرائح إلى نهاية كل بُعد غير مكاني مقابل (أي يتم ضبطها تلقائيًا على طول البُعد). في حال تحديدها، يجب أن يكون طول هذه القائمة مساويًا لعدد الأبعاد غير المكانية (إجمالي الأبعاد - 2). قد يكون عنصر فردي ضمن القائمة فارغًا، ويتم ضبطه تلقائيًا على طول هذا البُعد. يتم احتساب الفهارس السالبة من نهاية البُعد (على سبيل المثال، -1 هو العنصر الأخير). |
أمثلة
أداة تعديل الرموز (JavaScript)
var timeStart = 1000000;
var timeEnd = 1000048;
// Load a 2m temperature Zarr v2 array.
var temperature = ee.ImageCollection.loadZarrV2Array({
uri: 'gs://gcp-public-data-arco-era5/ar/' +
'full_37-1h-0p25deg-chunk-1.zarr-v3/2m_temperature/.zarray',
proj: 'EPSG:4326',
axis: 0,
starts: [timeStart],
ends: [timeEnd]
});
print(temperature);
var visParams = {
min: 220,
max: 350,
palette: [
'darkblue', 'blue', 'cyan', 'green', 'yellow', 'orange', 'red', 'darkred'
]
};
Map.addLayer(temperature, visParams, '2m Temperature');
إعداد Python
يمكنك الاطّلاع على صفحة
بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python API واستخدام geemap للتطوير التفاعلي.
import ee
import geemap.core as geemap
Colab (Python)
time_start = 1000000
time_end = 1000048
# Load a 2m temperature Zarr v2 array.
temperature = ee.ImageCollection.loadZarrV2Array(
uri=(
'gs://gcp-public-data-arco-era5/ar/'
'full_37-1h-0p25deg-chunk-1.zarr-v3/2m_temperature/.zarray'
),
proj='EPSG:4326',
axis=0,
starts=[time_start],
ends=[time_end],
)
display(temperature)
vis_params = {
'min': 220,
'max': 350,
'palette': [
'darkblue',
'blue',
'cyan',
'green',
'yellow',
'orange',
'red',
'darkred',
],
}
m.add_layer(temperature, vis_params, '2m Temperature')
m
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2026-10-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2026-10-21 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]