Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Dictionary
Stay organized with collections
Save and categorize content based on your preferences.
Constructs a new Dictionary.
Usage | Returns | ee.Dictionary(dict) | Dictionary |
Argument | Type | Details | dict | ComputedObject|Object, optional | An object to convert to a dictionary. This constructor accepts the following types: 1) Another dictionary. 2) A list of key/value pairs. 3) A null or no argument (producing an empty dictionary) |
Examples
Code Editor (JavaScript)
// A dictionary input (e.g. results of ee.Image.reduceRegion of an S2 image).
var dict = {
B1: 182,
B2: 219,
B3: 443
};
print('ee.Dictionary from dictionary input', ee.Dictionary(dict));
// A list of key/value pairs (from previous dictionary).
var list = [
'B1', 182,
'B2', 219,
'B3', 443
];
print('ee.Dictionary from list input', ee.Dictionary(list));
// To create an ee.Dictionary from two corresponding lists of keys and values,
// use the ee.Dictionary.fromLists constructor.
var keys = ['B1', 'B2', 'B3'];
var values = [182, 219, 443];
print('Dictionary from lists of keys and values',
ee.Dictionary.fromLists(keys, values));
Python setup
See the
Python Environment page for information on the Python API and using
geemap
for interactive development.
import ee
import geemap.core as geemap
Colab (Python)
# A dictionary input (e.g. results of ee.Image.reduceRegion of an S2 image).
dic = {
'B1': 182,
'B2': 219,
'B3': 443
}
print('ee.Dictionary from dictionary input:', ee.Dictionary(dic).getInfo())
# A list of key/value pairs (from previous dictionary).
lst = [
'B1', 182,
'B2', 219,
'B3', 443
]
print('ee.Dictionary from list input', ee.Dictionary(lst).getInfo())
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["\u003cp\u003eCreates a new Earth Engine Dictionary object to store key-value pairs.\u003c/p\u003e\n"],["\u003cp\u003eAccepts dictionary, list of key/value pairs, or no arguments as input to the constructor.\u003c/p\u003e\n"],["\u003cp\u003eEnables data organization and manipulation, such as representing image band values with corresponding band names.\u003c/p\u003e\n"],["\u003cp\u003eProvides flexibility in creating dictionaries from various input types, including existing dictionaries and lists.\u003c/p\u003e\n"]]],[],null,["# ee.Dictionary\n\n\u003cbr /\u003e\n\nConstructs a new Dictionary.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------------------|------------|\n| `ee.Dictionary(`*dict*`)` | Dictionary |\n\n| Argument | Type | Details |\n|----------|----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `dict` | ComputedObject\\|Object, optional | An object to convert to a dictionary. This constructor accepts the following types: 1) Another dictionary. 2) A list of key/value pairs. 3) A null or no argument (producing an empty dictionary) |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A dictionary input (e.g. results of ee.Image.reduceRegion of an S2 image).\nvar dict = {\n B1: 182,\n B2: 219,\n B3: 443\n};\nprint('ee.Dictionary from dictionary input', ee.Dictionary(dict));\n\n// A list of key/value pairs (from previous dictionary).\nvar list = [\n 'B1', 182,\n 'B2', 219,\n 'B3', 443\n];\nprint('ee.Dictionary from list input', ee.Dictionary(list));\n\n// To create an ee.Dictionary from two corresponding lists of keys and values,\n// use the ee.Dictionary.fromLists constructor.\nvar keys = ['B1', 'B2', 'B3'];\nvar values = [182, 219, 443];\nprint('Dictionary from lists of keys and values',\n ee.Dictionary.fromLists(keys, values));\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 input (e.g. results of ee.Image.reduceRegion of an S2 image).\ndic = {\n 'B1': 182,\n 'B2': 219,\n 'B3': 443\n}\nprint('ee.Dictionary from dictionary input:', ee.Dictionary(dic).getInfo())\n\n# A list of key/value pairs (from previous dictionary).\nlst = [\n 'B1', 182,\n 'B2', 219,\n 'B3', 443\n]\nprint('ee.Dictionary from list input', ee.Dictionary(lst).getInfo())\n```"]]