Order STAC Collection File

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"

Links object

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": "self"
href	The URL for the linked file.	"href": "https://ard.maxar.com/api/v1/metadata/cells/"Z13-031133320302/acquisitions?format=stac"

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	Bounding box geometry for the extents of the order.	"bbox":[-117.29404086049149, 32.89643160060904, -117.26563783226379, 32.94040782110711],[-117.26911032701715, 32.89648791009229, -117.21217648743674, 32.93984186226933],[-117.2156193014351, 32.89659148103818, -117.15871490276942, 32.93847442771225]]
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"
}

Overview​

Collection file information​

Collection Fields​

Links object​

Relationship types​

Extent object​

Example order collection JSON file​