# 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.

## 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` = number. Maximum number of items fetched. 0=unlimited. Default is 1000.

- `COLLECTION` = string. Name of collection to filter items.

- `CRS` = string. Name of CRS to filter items.

- `ASSET` = string. Name of asset to read.

- `RESOLUTION` = AVERAGE/HIGHEST/LOWEST. Strategy to use to determine dataset resolution. Default is AVERAGE.

## 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

- STACTA - Spatio-Temporal Asset Catalog Tiled Assets documentation page.