Previous | Table of contents | Next


1. Introduction#

This document provides server implementation best practices for SpatioTemporal Asset Catalog (STAC) search and catalog services that allow for standardized and harmonized access to metadata and data for CEOS agencies, including CWIC and FedEO.

STAC is a lightweight, JSON-based language that is asset-oriented, self-navigable and tailored towards the spatial and temporal domain.

It also provides a framework for achieving federated discovery in much the same way as OpenSearch. Where STAC has an advantage over OpenSearch is its widespread adoption in the earth science informatics community.

1.1 Purpose of document#

The STAC ecosystem comprises both API-related and metadata-related specifications. This document provides server implementation Best Practices for STAC-based metadata publication and related discovery services allowing for standardized and harmonized access to metadata and data for CEOS agencies.

The purpose of this document is to achieve the following,

  • Promote the use of the STAC standard as a means of data discovery for Earth Data providers

  • Define the expectations and requirements of candidate STAC implementations

  • Remove ambiguity in implementation where possible

  • Facilitate the aggregation of results between disparate Earth Data providers via STAC common standards

  • Allow for clients to access search engines via STAC capabilities with no a priori knowledge of specific implementations

  • Facilitate smooth integration between related STAC implementations, such as a dataset resource collection that refers to granule resource collections from another provider

  • Replace the existing CEOSS WGISS Integrated Catalog (CWIC) and WGISS Connected Data Assets (CDA) infrastructure, based on the OpenSearch API, with the STAC API and STAC catalogs

1.2 Document overview#

The document is organized as follows:

  • Chapter 1 is the introduction of the document.

  • Chapter 2: Objectives and needs gives an overview of objectives and needs.

  • Chapter 3: Best Practices introduces the categories of Best Practices and presents best practices for catalogs and metadata appicable to collections and granules.

The following chapters present Best Practices for one particular topic:

1.3 Terms, definitions and abbreviated terms#

1.3.1 Terms and Definitions#

Analysis Ready Data

Satellite data that have been processed to a minimum set of requirements and organized into a form that allows immediate analysis with a minimum of additional user effort and interoperability both through time and with other datasets.

Granule

A granule is the finest granularity of data that can be independently managed. A granule usually matches the individual file of EO satellite data.

Collection

A collection is an aggregation of granules sharing the same product specification. A collection typically corresponds to the series of products derived from data acquired by a sensor on board a satellite and having the same mode of operation. [RD01]

Interface

Named set of operations that characterize the behavior of an entity.

Metadata

Information about a resource [RD02].

Metadata element

Discrete unit of metadata [RD02].

1.3.2 Acronyms#

API

Application Programming Interface

ARD

Analysis Ready Data

CEOS

Committee on Earth Observation Satellites

CQL

Common Query Language

DIF-10

Directory Interchange Format Version 10

EO

Earth Observation

GCMD

Global Change Master Directory

HATEOAS

Hypertext As The Engine Of Application State

IDN

International Directory Network

JSON

JavaScript Object Notation

OGC

Open Geospatial Consortium

OSDD

OpenSearch Description Document

S3

Simple Storage Service

STAC

Spatiotemporal Asset Catalog

WGISS

Working Group on Information Systems and Services

1.4 References#

1.4.1 Applicable documents#

ID

Title

AD01

STAC Catalog Specification, v1.0.0

AD02

STAC Collection Specification, v1.0.0

AD03

STAC Item Specification, v1.0.0

AD04

STAC API Specification, v1.0.0

AD05

STAC API - Item Search, v1.0.0

AD06

STAC API - Filter Extension

AD07

STAC API - Collection Search

AD08

OGC17-069r3, OGC API - Features - Part 1: Core

AD09

OGC17-079r2, OGC API - Features - Part 3: Filtering

AD10

OGC21-065r2, Common Query Language (CQL2)

AD11

RFC 7946 - The GeoJSON Format

AD12

JSON Schema: A Media Type for Describing JSON Documents, draft-handrews-json-schema-02

AD13

STAC Scientific Citation Extension Specification, v1.0.0

AD14

STAC Electro-Optical Extension Specification, v1.1.0

AD15

STAC SAR Extension Specification, v1.3.0

AD16

STAC Satellite Extension Specification, v1.0.0

AD17

STAC Versioning Indicators Extension Specification, v1.2.0

AD18

STAC View Geometry Extension Specification, v1.0.0

AD19

STAC Projection Extension Specification, v1.0.0

AD20

STAC Timestamps Extension Specification, v1.0.0

AD21

STAC Processing Extension Specification, v1.2.0

AD22

STAC Hyperspectral Imagery Extension Specification, draft

AD23

STAC Landsat Extension Specification, v1.1.1

AD24

STAC Alternate Assets Extension Specification, v1.2.0

AD25

STAC Item Assets Definition Extension Specification, v1.0.0

AD26

STAC Web Map Links Extension Specification, v1.3.0

AD27

STAC API - Free Text Search

AD28

STAC CEOS-ARD Extension Specification

AD29

STAC Themes Extension Specification, v1.0.0

AD30

CEOS-ARD Product Family Specifications

AD31

STAC Product Extension Specification, v1.0.0

AD32

STAC Authentication Extension Specification, v1.1.0

AD33

STAC Grid Extension Specification, v1.1.0

AD34

STAC File Extension Specification, v2.1.0

1.4.2 Reference documents#


Previous | Table of contents | Next