STACTA - Spatio-Temporal Asset Catalog Tiled Assets

Added in version 3.3.

Driver short name

STACTA

Driver built-in by default

This driver is built-in by default

This driver supports opening JSON files following the Spatio-Temporal Asset Catalog Tiled Assets specification. Such JSON file references tiles (also called metatiles), split from a potentially big dataset according to a tiling scheme, with several zoom levels. The driver provides a single raster view, with overviews, of the dataset described by the JSON file. The driver supports metatiles of arbitrary size.

The driver may use the Electro-Optical Extension and, starting with GDAL 3.8.2, the Raster Extension attached to an asset template.

Configuration options

Configuration options can be specified in command-line tools using the syntax --config <NAME>=<VALUE> or using functions such as CPLSetConfigOption() (C) or gdal.config_options (Python). The following configuration options are available:

Open syntax

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

  • filename.json: local file

  • STACTA:"https://example.com/filename.json": remote file

  • STACTA:"filename.json":my_asset: specify an asset of a local/remote file

  • STACTA:"filename.json":my_asset:my_tms: specify an asset and tiling scheme of a local/remote file

The root of the JSON file must be of type Feature.

Starting with GDAL 3.10, specifying the -if STACTA option to command line utilities accepting it, or STACTA as the only value of the papszAllowedDrivers of GDALOpenEx(), also forces the driver to recognize the passed filename or URL.

Open options

Open options can be specified in command-line tools using the syntax -oo <NAME>=<VALUE> or by providing the appropriate arguments to GDALOpenEx() (C) or gdal.OpenEx (Python). The following open options are supported:

  • WHOLE_METATILE=[YES​/​NO.]: If set to YES, metatiles will be entirely downloaded (into memory). Otherwise by default, if metatiles are bigger than a threshold, they will be accessed in a piece-wise way.

  • SKIP_MISSING_METATILE=[YES​/​NO]: If set to YES, metatiles that are missing will be skipped without error, and corresponding area in the dataset will be filled with the nodata value or zero if there is no nodata value. This setting can also be set with the GDAL_STACTA_SKIP_MISSING_METATILE configuration option.

Subdatasets

If a STACTA JSON file contains several asset templates and/or tiling scheme, 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.)

See Also