# ee.Dictionary.get

Extracts a named value from a dictionary. If the dictionary does not contain the given key, then defaultValue is returned, unless it is null.

<br />

| Usage | Returns |
|---|---|
| `Dictionary.get(key, *defaultValue*)` | Object |

| Argument | Type | Details |
|---|---|---|
| this: `dictionary` | Dictionary |   |
| `key` | String |   |
| `defaultValue` | Object, default: null |   |

## Examples

### Code Editor (JavaScript)

```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 setup

See the [Python Environment](https://developers.google.com/earth-engine/guides/python_install) page for information on the Python API and using
`geemap` for interactive development.

```python
import ee
import geemap.core as geemap
```

### Colab (Python)

```python
# A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).
dic = ee.Dictionary({
    'B1': 182,
    'B2': 219,
    'B3': 443
})

display('Value for "B1" key:', dic.get('B1'))

# Set a default value for the case where the key does not exist.
display('Value for nonexistent "Band_1" key:',
        dic.get(**{'key': 'Band_1', 'defaultValue': -9999}))
```