# Extract imagery metadata

> Supported in: Batch, Streaming

Extracts metadata fields from an image.

**Expression categories:** Media

## Declared arguments

* **Media reference:** The column containing media references to imagery in the media set.<br>*Expression\<Media reference>*
* **Metadata to include:** Select the metadata columns to include in the output.
  For metadata columns that do not apply for the given image, the value will be null. For example, geo metadata should only be relevant for images with geospatial context such as satellite imagery with world coordinates. If this does not apply to the image, this field will return null.<br>*Set\<Enum\<Attributes, Bands, Bytes, Dimensions, EXIF Image Location, Format, Geographic Metadata, ICC Profile>>*

**Output type:** *Struct*

## Examples

### Example 1: Base case

**Argument values:**

* **Media reference:** `Media Reference`
* **Metadata to include:** \[`Attributes`, `Bands`, `Bytes`, `Dimensions`, `Format`, `Geographic Metadata`, `ICC Profile`, `EXIF Image Location`]

| Media Reference | **Output** |
| ----- | ----- |
| {"mimeType":"image/tiff","reference":{"type":"mediaSetItem","mediaSetItem":{"mediaSetRid":"ri.mio.test.media-set.1","mediaItemRid":"ri.mio.test.media-item.1"}}} | {<br> **attributes**: {<br> outer\_key1 -> {<br> inner\_key1 -> inner\_value1,<br>},<br>... |

***

### Example 2: Base case

**Argument values:**

* **Media reference:** `Media Reference`
* **Metadata to include:** \[`Bands`, `Dimensions`, `Geographic Metadata`]

| Media Reference | **Output** |
| ----- | ----- |
| {"mimeType":"image/tiff","reference":{"type":"mediaSetItem","mediaSetItem":{"mediaSetRid":"ri.mio.test.media-set.1","mediaItemRid":"ri.mio.test.media-item.1"}}} | {<br> **bands**: \[ {<br> **color\_interpretation**: RED,<br> **type**: BYTE,<br>}, {\<b... |

***

### Example 3: Base case

**Argument values:**

* **Media reference:** `Media Reference`
* **Metadata to include:** \[`ICC Profile`]

| Media Reference | **Output** |
| ----- | ----- |
| {"mimeType":"image/tiff","reference":{"type":"mediaSetItem","mediaSetItem":{"mediaSetRid":"ri.mio.test.media-set.1","mediaItemRid":"ri.mio.test.media-item.1"}}} | {<br> **icc\_profile**: some-icc-profile,<br>} |

***