إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ee.Dictionary.select
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض قاموسًا يحتوي على المفاتيح المحدّدة فقط.
الاستخدام | المرتجعات |
---|
Dictionary.select(selectors, ignoreMissing) | القاموس |
الوسيطة | النوع | التفاصيل |
---|
هذا: dictionary | القاموس | |
selectors | قائمة | قائمة بالمفاتيح أو التعبيرات العادية التي سيتم اختيارها |
ignoreMissing | قيمة منطقية، القيمة التلقائية: false | تجاهُل أدوات الاختيار التي لا تتطابق مع مفتاح واحد على الأقل |
أمثلة
محرّر الرموز البرمجية (JavaScript)
// A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).
var dict = ee.Dictionary({
B1: 182,
B2: 219,
B3: 443
});
print('Select keys by name', dict.select(['B1', 'B2']));
print('Select keys by regex', dict.select(['B[1-2]']));
print('Set ignoreMissing as true to avoid an unmatched key error',
dict.select({selectors: ['B1', 'B2', 'Region'], ignoreMissing: true}));
إعداد Python
راجِع صفحة
بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python واستخدام
geemap
للتطوير التفاعلي.
import ee
import geemap.core as geemap
Colab (Python)
# A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).
dic = ee.Dictionary({
'B1': 182,
'B2': 219,
'B3': 443
})
print('Select keys by name:', dic.select(['B1', 'B2']).getInfo())
print('Select keys by regex:', dic.select(['B[1-2]']).getInfo())
dic_select = dic.select(**{'selectors': ['B1', 'B2', 'Region'],
'ignoreMissing': True})
print('Set ignoreMissing as true to avoid an unmatched key error:',
dic_select.getInfo())
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eDictionary.select()\u003c/code\u003e returns a new dictionary containing only the specified keys from the original dictionary.\u003c/p\u003e\n"],["\u003cp\u003eKeys can be selected by providing a list of key names or regular expressions.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eignoreMissing\u003c/code\u003e parameter, when set to true, prevents errors if a selector doesn't match any key in the dictionary.\u003c/p\u003e\n"]]],[],null,["# ee.Dictionary.select\n\nReturns a dictionary with only the specified keys.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------------------------------------------|------------|\n| Dictionary.select`(selectors, `*ignoreMissing*`)` | Dictionary |\n\n| Argument | Type | Details |\n|--------------------|-------------------------|---------------------------------------------------|\n| this: `dictionary` | Dictionary | |\n| `selectors` | List | A list of keys or regular expressions to select. |\n| `ignoreMissing` | Boolean, default: false | Ignore selectors that don't match at least 1 key. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).\nvar dict = ee.Dictionary({\n B1: 182,\n B2: 219,\n B3: 443\n});\n\nprint('Select keys by name', dict.select(['B1', 'B2']));\nprint('Select keys by regex', dict.select(['B[1-2]']));\nprint('Set ignoreMissing as true to avoid an unmatched key error',\n dict.select({selectors: ['B1', 'B2', 'Region'], ignoreMissing: true}));\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\n# A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).\ndic = ee.Dictionary({\n 'B1': 182,\n 'B2': 219,\n 'B3': 443\n})\n\nprint('Select keys by name:', dic.select(['B1', 'B2']).getInfo())\nprint('Select keys by regex:', dic.select(['B[1-2]']).getInfo())\n\ndic_select = dic.select(**{'selectors': ['B1', 'B2', 'Region'],\n 'ignoreMissing': True})\nprint('Set ignoreMissing as true to avoid an unmatched key error:',\n dic_select.getInfo())\n```"]]