إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ee.Dictionary.get
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تستخرج هذه الدالة قيمة مسماة من قاموس. إذا لم يحتوي القاموس على المفتاح المحدّد، يتم عرض defaultValue، ما لم تكن القيمة فارغة.
الاستخدام | المرتجعات |
---|
Dictionary.get(key, defaultValue) | عنصر |
الوسيطة | النوع | التفاصيل |
---|
هذا: dictionary | القاموس | |
key | سلسلة | |
defaultValue | كائن، القيمة التلقائية: null | |
أمثلة
محرّر الرموز البرمجية (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('Value for "B1" key', dict.get('B1'));
// Set a default value for the case where the key does not exist.
print('Value for nonexistent "Band_1" key',
dict.get({key: 'Band_1', defaultValue: -9999}));
إعداد 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('Value for "B1" key:', dic.get('B1').getInfo())
# Set a default value for the case where the key does not exist.
print('Value for nonexistent "Band_1" key:',
dic.get(**{'key': 'Band_1', 'defaultValue': -9999}).getInfo())
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe \u003ccode\u003eDictionary.get()\u003c/code\u003e method extracts the value associated with a specified key from a dictionary.\u003c/p\u003e\n"],["\u003cp\u003eIf the key is not found in the dictionary, the method returns a user-defined default value.\u003c/p\u003e\n"],["\u003cp\u003eA null default value can be specified, resulting in a null return if the key is absent.\u003c/p\u003e\n"],["\u003cp\u003eThis function is applicable across different Earth Engine environments, including JavaScript, Python, and Colab.\u003c/p\u003e\n"]]],["The `get` method retrieves a value from a dictionary using a specified key. If the key exists, its corresponding value is returned. If the key is absent, a `defaultValue` is returned. The `defaultValue` can be customized, defaulting to `null` if not provided. Usage examples demonstrate retrieving existing values and setting default values for nonexistent keys, in both JavaScript and Python. The `get` method is applicable to dictionary objects.\n"],null,["# ee.Dictionary.get\n\nExtracts a named value from a dictionary. If the dictionary does not contain the given key, then defaultValue is returned, unless it is null.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------------------|---------|\n| Dictionary.get`(key, `*defaultValue*`)` | Object |\n\n| Argument | Type | Details |\n|--------------------|-----------------------|---------|\n| this: `dictionary` | Dictionary | |\n| `key` | String | |\n| `defaultValue` | Object, default: null | |\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('Value for \"B1\" key', dict.get('B1'));\n\n// Set a default value for the case where the key does not exist.\nprint('Value for nonexistent \"Band_1\" key',\n dict.get({key: 'Band_1', defaultValue: -9999}));\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('Value for \"B1\" key:', dic.get('B1').getInfo())\n\n# Set a default value for the case where the key does not exist.\nprint('Value for nonexistent \"Band_1\" key:',\n dic.get(**{'key': 'Band_1', 'defaultValue': -9999}).getInfo())\n```"]]