Skip to main content

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

KeyContent TypeDescription
typeStringAlways “Feature”
idStringThe ID should be unique across the collection. It is recommended to use an ID that includes the acquisition date and source of the data.
instrumentsString arrayList of instruments used by the spacecraft.
geometryobjectSee Geometry
bboxnumber arrayRequired if the geometry is not null. Bounding Box of the asset represented by this Item. Formatted according to RFC 7946, section 5.
propertiesobjectA dictionary of additional metadata for the Item. See Properties
assetsobjectDictionary of asset objects. See Assets
linksarrayA list of references to other documents. See Links.
stac_versionStringVersion 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.

KeyContent TypeDescription
hrefStringURI 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.
titleStringThe displayed title for clients and users.
typeStringMedia type of the asset.
rolesString arrayThe semantic roles of the asset.
sizenumberThe size of the asset in bytes.

Asset Roles​

RoleAsset description
dataImage data
metadataMetadata 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.

KeyContent TypeDescription
datetimeStringAn ISO-8601-formatted string to indicate the imagery date, e.g. “2019-10-25T09:00:00Z”
spacecraftStringName of the spacecraft
correlationIdStringAn 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
sceneColnumberIf 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
sceneRownumberIf 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
productTypeStringIndicates the product type of the asset, L0
instrumentsString arrayA 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.

KeyContent TypeDescription
typeStringFormatted according to RFC 7946, section 3.1
propertiesobjectFormatted according to RFC 7946, section 3.1
coordinates number arrayCoordinates are specified in Longitude/Latitude or Longitude/Latitude/Elevation based on WGS 84