- Title: Item Assets Definition
- Identifier: https://stac-extensions.github.io/item-assets/v1.0.0/schema.json
- Field Name Prefix: -
- Scope: Collection
- Extension Maturity Classification: Proposal
- Owner: @matthewhanson
This document explains the Item Assets Definition Extension to the SpatioTemporal Asset Catalog (STAC) specification.
This extension serves two purposes:
- Provide a human-readable definition of assets available in any Items belonging to this Collection so that the user can determine the key(s) of assets they are interested in.
- Provide a way to programmatically determine what assets are available in any member Item. Otherwise a random Item needs to be examined to determine assets available, but a random Item may not be representative of the set.
- Examples:
- Landsat-8 Collection Example: Shows the basic usage of the extension in a STAC Collection
- JSON Schema
- Changelog
This extension introduces a single new field, item_assets at the top level of a Collection.
An Asset Object defined at the Collection level is nearly the same as the
Asset Object in Items, except for two differences.
The href field is not required, because Collections don't point to any data by themselves, but at least two other fields must be present.
| Field Name | Type | Description |
|---|---|---|
| item_assets | Map<string, Asset Object> | REQUIRED. A dictionary of assets that can be found in member Items |
An asset is an object that contains details about the datafiles that will be included in member Items. Assets included at the Collection level do not imply that all assets are available from all Items. However, it is recommended that the Asset Definition is a complete set of all assets that may be available from any member Items.
| Field Name | Type | Description |
|---|---|---|
| title | string | The displayed title for clients and users. |
| description | string | A description of the Asset providing additional details, such as how it was processed or created. CommonMark 0.29 syntax MAY be used for rich text representation. |
| type | string | Media type of the asset. |
| roles | [string] | The semantic roles of the asset, similar to the use of rel in links. |
Other custom fields, or fields from other extensions may also be included in the Asset object.
Any property that exists for a Collection-level asset object must also exist in the corresponding assets object in each Item. If a collection's asset object contains properties that are not explicitly stated in the Item's asset object then that property does not apply to the item's asset. Item asset objects at the Collection-level can describe any of the properties of an asset, but those assets properties and values must also reside in the item's asset object. To consolidate item-level asset object properties in an API setting, consider storing the STAC Item objects without the larger properties internally as 'invalid' STAC items, and merge in the desired properties at serving time from the Collection-level.
At least two fields (e.g. title and type) are required to be provided, in order for it to adequately describe Item assets.
The two fields must not necessarily be taken from the list above and may include any custom field.