Skip to content

Order Collection File

Last updated: August 12, 2022

Overview

The Order Collection file describes the STAC collection for the order. The file's contents provide links to the relevant files for the order, and provide the order's spatial and temporal extents.

Collection file information

This file adheres to the STAC collection specification . If multiple orders are delivered to the same bucket/prefix location, there will be a file for each order in the /order_collections folder.

File name: {orderID}_collection.json

File path: bucket/prefix/order_collections/{orderID}_collection.json

File type: GeoJSON (.json)

Collection Fields

The descriptions for STAC fields are taken from the collection specification.

Field Type Description Example
type string The type of the GeoJSON object. The type for a STAC item is "feature". "type": "Collection"
id string The unique identifier for the order. "id": "5681790434919305322"
stac_version string The STAC version for the file schema. "stac_version": "1.0.0"
description string Human-readable description of the file. "description": "Order 5681790434919305322 collection",
links object Provides links to metadata files associated with the acquisition. See "Links object" table below.
extent object Spatial and temporal extents for the acquisition collection. See "Extent object" table below.
license string License type "license": "proprietary"

The links object provides URLs to metadata files and shows their relationship to the file.

Field Description Example
rel The relationship between the link and the entity it describes. See "relationship" table below. "rel": "collection"
href The URL for the linked file. "href": "../../../acquisition_collections/104001006D0BB300_collection.json"
type The type for the linked file. "type": "application/json"

Relationship types

Type Description Example
child URL to the acquisition collection file. "href": "../../../order_collections/104001006D0BB300_collection.json"
root The order collection file described in this document is the root collection file. "href": "../../../order_collections/5681790434919305322_root_collection.json"

Extent object

The "extent" object lists the spatial and temporal extents for the collection of items.

Extent Field Description Example
spatial bbox Extents of the order. If the order has more than one AOI, the first item is the total extents, subsequent items are the sub-AOIs. "bbox":[[-117.29404086049149, 32.805629732625235, -117.148378194219, 32.94040782110711]]
temporal interval Date interval extents of the order. "interval": [["2021-09-21 18:34:57Z", "2021-09-21 18:34:59Z"]]

Example order collection JSON file

{
    "type": "Collection",
    "id": "5681790434919305322",
    "stac_version": "1.0.0",
    "description": "Order 5681790434919305322 collection",
    "links": [{
        "rel": "root",
        "href": "./5681790434919305322_root_collection.json",
        "type": "application/json"
    }, {
        "rel": "child",
        "href": "../acquisition_collections/104001006D0BB300_collection.json",
        "type": "application/json"
    }],
    "extent": {
        "spatial": {
            "bbox": [
                [-117.29404086049149, 32.805629732625235, -117.148378194219, 32.94040782110711]
            ]
        },
        "temporal": {
            "interval": [
                ["2021-09-21 18:34:57Z", "2021-09-21 18:34:59Z"]
            ]
        }
    },
    "license": "proprietary"
}
Back to top