Level 0 STAC product
This document describes the Level 0 product JSON (.json) file. The product file contains metadata and references to files that make up a product.
The Level 0 product file complies with STAC specification. STAC is a standardised way to expose collections of spatial temporal data. For more information about STAC specification, refer to The STAC Specification.
Sample file
Sample : L0_TIF_LANDSAT-9_20220804_product.json
| Key | Content Type | Description |
|---|---|---|
type | String | Always “Feature” |
id | String | The ID should be unique across the collection. It is recommended to use an ID that includes the acquisition date and source of the data. |
instruments | String array | List of instruments used by the spacecraft. |
geometry | object | See Geometry |
bbox | number array | Required if the geometry is not null. Bounding Box of the asset represented by this Item. Formatted according to RFC 7946, section 5. |
properties | object | A dictionary of additional metadata for the Item. See Properties |
assets | object | Dictionary of asset objects. See Assets |
links | array | A list of references to other documents. See Links. |
stac_version | String | Version of the STAC interface. Formatted as “X.Y.Z” where X, Y, and Z are numbers. |
Assets
Each FarEarth product consists of a product file and a set of asset files.
- The product file describes the product at high-level and lists asset files
- Each asset file has a type and at least one role associated with it
- The role describes the information and intended use of the file
- The type describes the file format
Product files may also contain high-level metadata used to index the product in the FarEarth Catalogue.
| Key | Content Type | Description |
|---|---|---|
href | String | URI to the asset object relative to the location of this file. Note: The name assigned to metadata must be the name of a data asset followed by _META. |
title | String | The displayed title for clients and users. |
type | String | Media type of the asset. |
roles | String array | The semantic roles of the asset. |
size | number | The size of the asset in bytes. |
Asset Roles
| Role | Asset description |
|---|---|
data | Image data |
metadata | Metadata about the product |
Properties
The Level 0 product JSON has a properties section with details about the product.
FarEarth-specific properties have been grouped into categories below.
| Key | Content Type | Description |
|---|---|---|
datetime | String | An ISO-8601-formatted string to indicate the imagery date, e.g. “2019-10-25T09:00:00Z” |
spacecraft | String | Name of the spacecraft |
correlationId | String | An ID that is shared for all FarEarth products. It is derived from the FarEarth product with the correlation ID, or was used to derive the FarEarth product. It is recommended that this ID is unique |
sceneCol | number | If an interval is subdivided into multiple scenes, this property will reflect the column number of the scene. Column numbers start at 1 from the left, across the track of the satellite |
sceneRow | number | If an interval is subdivided into multiple scenes, this property will reflect the row number of the scene. Row numbers start at 1, along the track of the satellite |
productType | String | Indicates the product type of the asset, L0 |
instruments | String array | A list of the sensors used to produce the data |
Geometry
May be null if the location of the image is provided in the data file (GeoTIFF), otherwise defines the full footprint of the asset represented by this item. Formatted according to RFC 7946, section 3.1. The footprint should be the default GeoJSON geometry, though additional geometries can be included.
| Key | Content Type | Description |
|---|---|---|
type | String | Formatted according to RFC 7946, section 3.1 |
properties | object | Formatted according to RFC 7946, section 3.1 |
coordinates | number array | Coordinates are specified in Longitude/Latitude or Longitude/Latitude/Elevation based on WGS 84 |