STACIT - Spatio-Temporal Asset Catalog Items

New in version 3.4.

Driver short name

STACIT

Driver built-in by default

This driver is built-in by default

This driver supports opening STAC API ItemCollections, with the input usually being a STAC API search query or the results saved as a JSON file. Items in the response must include projection information following the Projection Extension Specification. It builds a virtual mosaic from the items.

A STACIT dataset which has no subdatasets is actually a VRT -- GDAL Virtual Format dataset. Thus, translating it into VRT will result in a VRT file that directly references the items.

Note that STAC API ItemCollections are not the same as STAC Collections. STAC API ItemCollections are GeoJSON FeatureCollections enhanced with STAC entities.

Note that when the ItemCollections contains overlapping items, and that some items are fully covered by other items that are more recent, the STACIT virtual mosaic will not list those fully covered items not participating to the pixel values of the mosaic.

Open syntax

STACIT datasets/subdatasets can be accessed with one of the following syntaxes:

  • filename.json: local file

  • STACIT:"https://example.com/filename.json": remote file or query

  • STACIT:"filename.json":asset=my_asset: specify the name of the asset GDAL should read (i.e. "visual")

  • STACIT:"filename.json":collection=my_collect,asset=my_asset: limit to items in a given collection and specify asset to read

  • STACIT:"filename.json":collection=my_collect,asset=my_asset,crs=my_crs: specify a collection, asset, and limit to items in a given CRS

Open options

The following open options are supported:

  • MAX_ITEMS=<integer>: Defaults to 1000. Maximum number of items fetched. 0=unlimited.

  • COLLECTION=value: Name of collection to filter items.

  • CRS=value: Name of CRS to filter items.

  • ASSET=value: Name of asset to read.

  • RESOLUTION=[AVERAGE/HIGHEST/LOWEST]: Defaults to AVERAGE. Strategy to use to determine dataset resolution.

Subdatasets

If a STACIT JSON file contains several collections, assets or CRS, the driver will return a list of subdataset names to open each of the possible subdatasets.

Driver capabilities

Supports VirtualIO

This driver supports virtual I/O operations (/vsimem/, etc.)

Examples

List the subdatasets associated to a STAC search on a given collection, bbox and starting from a datetime:

gdalinfo "STACIT:\"https://planetarycomputer.microsoft.com/api/stac/v1/search?collections=naip&bbox=-100,40,-99,41&datetime=2019-01-01T00:00:00Z%2F..\""

Open a subdataset returned by the above request:

gdalinfo "STACIT:\"https://planetarycomputer.microsoft.com/api/stac/v1/search?collections=naip&bbox=-100,40,-99,41&datetime=2019-01-01T00:00:00Z%2F..\":asset=image"

See Also