diff --git a/README.md b/README.md index ccd78cd0..dd274503 100644 --- a/README.md +++ b/README.md @@ -29,7 +29,7 @@ to search STAC catalogs, where the features returned are STAC [Item](stac-spec/i that have common properties, links to their assets and geometries that represent the footprints of the geospatial assets. The specification for STAC API is provided as files that follow the [OpenAPI](http://openapis.org/) 3.0 specification, -rendered online into HTML at , in addition to human-readable documentation. +rendered online into HTML at , in addition to human-readable documentation. ## Stability Note diff --git a/build/swagger-config.yaml b/build/swagger-config.yaml index ad056d8e..86256693 100644 --- a/build/swagger-config.yaml +++ b/build/swagger-config.yaml @@ -1,7 +1,7 @@ openapi: 3.0.3 info: title: STAC API - Complete - version: 1.0.0-beta.3 + version: 1.0.0-beta.4 apis: - url: 'build/core/openapi.yaml' paths: diff --git a/collections/README.md b/collections/README.md index aa091ea0..584023a5 100644 --- a/collections/README.md +++ b/collections/README.md @@ -7,7 +7,7 @@ - [Conformance](#conformance) - **OpenAPI specification:** Missing -- **Conformance URI:** +- **Conformance URI:** - **Extension [Maturity Classification](../extensions.md#extension-maturity):** Pilot - **Dependencies**: [STAC API - Core](../core) @@ -134,7 +134,7 @@ and if the canonical location is elsewhere it is recommended to include a `rel` ## Conformance -Any implementation that provides the STAC Collection functionality described above must add `http://stacspec.org/spec/api/1.0.0-beta.3/collections`, +Any implementation that provides the STAC Collection functionality described above must add `http://stacspec.org/spec/api/1.0.0-beta.4/collections`, the conformance URI, to the `conformsTo` JSON at the landing page. The core STAC landing page (`/`) must also include a link with a `rel` of `data` that links to the `/collections` endpoint. diff --git a/collections/openapi.yaml b/collections/openapi.yaml index 3aa23810..edd40ae3 100644 --- a/collections/openapi.yaml +++ b/collections/openapi.yaml @@ -1,7 +1,7 @@ openapi: 3.0.3 info: title: STAC API - Collections - version: '1.0.0-beta.3' + version: '1.0.0-beta.4' description: >- This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Core specification. This is a subset of the STAC API - Collections specification. @@ -38,13 +38,13 @@ paths: schema: $ref: '../core/openapi.yaml#/components/schemas/landingPage' example: - stac_version: 1.0.0-beta.3 + stac_version: 1.0.0-beta.4 type: Catalog id: sentinel title: Copernicus Sentinel Imagery description: Catalog of Copernicus Sentinel 1 and 2 imagery. conformsTo: - - 'https://api.stacspec.org/v1.0.0-beta.3/core' + - 'https://api.stacspec.org/v1.0.0-beta.4/core' - 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core' - 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30' - 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson' diff --git a/core/README.md b/core/README.md index c32cfbe9..d9c05de8 100644 --- a/core/README.md +++ b/core/README.md @@ -5,9 +5,9 @@ - [Example Landing Page for STAC API - Core](#example-landing-page-for-stac-api---core) - [Extensions](#extensions) -- **OpenAPI specification:** [openapi.yaml](openapi.yaml) describes the core endpoints ([rendered version](https://api.stacspec.org/v1.0.0-beta.3/core)), +- **OpenAPI specification:** [openapi.yaml](openapi.yaml) describes the core endpoints ([rendered version](https://api.stacspec.org/v1.0.0-beta.4/core)), and [commons.yaml](commons.yaml) is the OpenAPI version of the core [STAC spec](../stac-spec) JSON Schemas. -- **Conformance URI:** +- **Conformance URI:** - **Extension [Maturity Classification](../extensions.md#extension-maturity):** Pilot - **Dependencies**: None @@ -82,7 +82,7 @@ the [overview](../overview.md#example-landing-page) document. "title": "A simple STAC API Example", "description": "This Catalog aims to demonstrate the a simple landing page", "conformsTo" : [ - "https://api.stacspec.org/v1.0.0-beta.3/core" + "https://api.stacspec.org/v1.0.0-beta.4/core" ], "links": [ { diff --git a/core/commons.yaml b/core/commons.yaml index c744e2f3..e42fe618 100644 --- a/core/commons.yaml +++ b/core/commons.yaml @@ -2,7 +2,7 @@ openapi: 3.0.3 info: title: The SpatioTemporal Asset Catalog API - Commons description: This is the OpenAPI version of the core STAC spec JSON Schemas. - version: 1.0.0-beta.3 + version: 1.0.0-beta.4 paths: {} components: responses: diff --git a/core/openapi.yaml b/core/openapi.yaml index eeb4d1f8..4d15443a 100644 --- a/core/openapi.yaml +++ b/core/openapi.yaml @@ -1,7 +1,7 @@ openapi: 3.0.3 info: title: STAC API - Core - version: 1.0.0-beta.3 + version: 1.0.0-beta.4 description: >- This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Core specification. Any service that implements this endpoint to allow discovery of @@ -63,7 +63,7 @@ components: title: Copernicus Sentinel Imagery description: Catalog of Copernicus Sentinel 1 and 2 imagery. conformsTo: - - 'https://api.stacspec.org/v1.0.0-beta.3/core' + - 'https://api.stacspec.org/v1.0.0-beta.4/core' links: - href: 'http://data.example.org/' rel: self diff --git a/extensions.md b/extensions.md index 88b8a75e..035a93bb 100644 --- a/extensions.md +++ b/extensions.md @@ -66,23 +66,23 @@ Each extension has its own conformance URI, which is used in the `conformsTo` re the service supports. This are listed at the top of each extension description, but the full table is given here for ease of reference. - [Fields](item-search/README.md#fields) - - + - - [Filter](item-search/README.md#filter) - - - - - - - - - - + - + - + - + - + - - [Context](item-search/README.md#context) - - + - - [Sort](item-search/README.md#sort) - - + - - [Transaction](ogcapi-features/extensions/transaction/README.md) - - + - - [Items and Collections API Version](ogcapi-features/extensions/version/README.md) - - + - - [Query](item-search/README.md#query) - - + - ## Third-party / vendor extensions diff --git a/fragments/context/README.md b/fragments/context/README.md index 56589304..1074e085 100644 --- a/fragments/context/README.md +++ b/fragments/context/README.md @@ -1,7 +1,7 @@ # STAC API - Context Fragment - **OpenAPI specification:** [openapi.yaml](openapi.yaml) -- **Conformance Class:** +- **Conformance Class:** - **Fragment [Maturity Classification](../../extensions.md#extension-maturity):** Pilot - **Dependents:** - [Item Search](../../item-search) diff --git a/fragments/context/openapi.yaml b/fragments/context/openapi.yaml index 42a4ca2d..8745c2d1 100644 --- a/fragments/context/openapi.yaml +++ b/fragments/context/openapi.yaml @@ -2,7 +2,7 @@ openapi: 3.0.3 info: title: The SpatioTemporal Asset Catalog API - Context description: Adds search related metadata (context) to GeoJSON Responses. - version: 1.0.0-beta.3 + version: 1.0.0-beta.4 paths: {} components: schemas: diff --git a/fragments/fields/README.md b/fragments/fields/README.md index 76f18fce..c140bb44 100644 --- a/fragments/fields/README.md +++ b/fragments/fields/README.md @@ -1,7 +1,7 @@ # STAC API - Fields Fragment - **OpenAPI specification:** [openapi.yaml](openapi.yaml) -- **Conformance Class:** +- **Conformance Class:** - **Fragment [Maturity Classification](../../extensions.md#extension-maturity):** Pilot - **Dependents:** - [Item Search](../../item-search) diff --git a/fragments/fields/openapi.yaml b/fragments/fields/openapi.yaml index e0ae8172..3c3397ef 100644 --- a/fragments/fields/openapi.yaml +++ b/fragments/fields/openapi.yaml @@ -2,7 +2,7 @@ openapi: 3.0.3 info: title: The SpatioTemporal Asset Catalog API - Fields description: Adds parameter to control which fields are returned in the response. - version: 1.0.0-beta.3 + version: 1.0.0-beta.4 paths: {} components: parameters: diff --git a/fragments/filter/README.md b/fragments/filter/README.md index bfc53406..dd2d7270 100644 --- a/fragments/filter/README.md +++ b/fragments/filter/README.md @@ -2,20 +2,20 @@ - **OpenAPI specification:** [openapi.yaml](openapi.yaml) - **Conformance Classes:** - - Filter: - - Item Search Filter: - - CQL Text: - - CQL JSON: - - Basic CQL: - - Basic Spatial Operators: - - Basic Temporal Operators: - - Enhanced Comparison Operators: - - Enhanced Spatial Operators: - - Enhanced Temporal Operators: - - Functions: - - Arithmetic: - - Arrays: - - Queryable Second Operand: + - Filter: + - Item Search Filter: + - CQL Text: + - CQL JSON: + - Basic CQL: + - Basic Spatial Operators: + - Basic Temporal Operators: + - Enhanced Comparison Operators: + - Enhanced Spatial Operators: + - Enhanced Temporal Operators: + - Functions: + - Arithmetic: + - Arrays: + - Queryable Second Operand: - **Extension [Maturity Classification](../../extensions.md#extension-maturity):** Pilot - **Dependents:** - [Item Search](../../item-search) @@ -131,32 +131,32 @@ The precise decomposition of the OAFeat conformance classes is still a work in p (see [ogcapi-features/issues/579](https://github.com/opengeospatial/ogcapi-features/issues/579)). The STAC API Filter Extension reuses the definitions in OAFeat CQL, but divides them into different conformance classes that better fit the use cases of STAC API. This extension uses conformance classes with a prefix of -`https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:`. We hope the conformance +`https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:`. We hope the conformance classes defined here and in OGC API Features Part 3 will re-align at some point but, for now, they do not. The implementation **must** support these conformance classes: -- Filter (`https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:filter`) defines the Queryables mechanism and +- Filter (`https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:filter`) defines the Queryables mechanism and parameters `filter-lang`, `filter-crs`, and `filter`. -- Basic CQL (`https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:basic-cql`) defines the basic operations allowed in +- Basic CQL (`https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:basic-cql`) defines the basic operations allowed in the query language used for the `filter` parameter defined by Filter. This includes logical operators (`AND`, `OR`, `NOT`), comparison operators (`=`, `<`, `<=`, `>`, `>=`), and `IS NULL`. -- Item Search Filter (`https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:item-search-filter`) binds the Filter and +- Item Search Filter (`https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:item-search-filter`) binds the Filter and Basic CQL conformance classes to apply to the Item Search endpoint (`/search`). This class is the correlate of the OAFeat CQL Features Filter class that binds Filter and Basic CQL to the Features resource (`/collections/{cid}/items`). It is **recommended** that the implementation also support the Basic Spatial Operators and Basic Temporal Operators classes: -- Basic Spatial Operators (`https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:basic-spatial-operators`) +- Basic Spatial Operators (`https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:basic-spatial-operators`) defines the `INTERSECTS` predicate -- Basic Temporal Operators: (`https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:basic-temporal-operators`) +- Basic Temporal Operators: (`https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:basic-temporal-operators`) defines the `ANYINTERACTS` predicate Additionally, the implementation **must** support at least one of the "CQL Text" or "CQL JSON" conformance classes that define the CQL format used in the filter parameter: -- CQL Text (`https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:cql-text`) defines that the CQL Text format is supported by Item Search. -- CQL JSON (`https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:cql-json`) defines that the CQL JSON format is supported by Item Search +- CQL Text (`https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:cql-text`) defines that the CQL Text format is supported by Item Search. +- CQL JSON (`https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:cql-json`) defines that the CQL JSON format is supported by Item Search If both are advertised as being supported, it is only required that both be supported for GET query parameters, and that only that CQL JSON be supported for POST JSON requests. It is recommended that clients use CQL Text in GET requests and @@ -169,18 +169,18 @@ operations required by the Enhanced Spatial Operators. If implemented for Item S URI should follow the same pattern relative to OAFeat CQL. - Enhanced Comparison Operators - (`https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:enhanced-comparison-operators`) defines the `LIKE`, + (`https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:enhanced-comparison-operators`) defines the `LIKE`, `BETWEEN`, and `IN` operators. It is **recommended** to implement this class. - Enhanced Spatial Operators - (`https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:enhanced-spatial-operators`) defines the + (`https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:enhanced-spatial-operators`) defines the same operators as OAF Part 3 CQL Enhanced Spatial Operators. - Enhanced Temporal Operators - (`https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:enhanced-temporal-operators`) defines the + (`https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:enhanced-temporal-operators`) defines the same operators as OAF Part 3 CQL Enhanced Temporal Operators. -- Functions (`https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:functions`) defines the same operators as OAF Part 3 CQL Functions. -- Arithmetic: (`https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:arithmetic`) defines the same operators as OAF Part 3 CQL Arithmetic. -- Arrays: (`https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:arrays`) defines the same operators as OAF Part 3 CQL Arrays. -- Queryable Second Operand: (`https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:queryable-second-operand`) allows the +- Functions (`https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:functions`) defines the same operators as OAF Part 3 CQL Functions. +- Arithmetic: (`https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:arithmetic`) defines the same operators as OAF Part 3 CQL Arithmetic. +- Arrays: (`https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:arrays`) defines the same operators as OAF Part 3 CQL Arrays. +- Queryable Second Operand: (`https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:queryable-second-operand`) allows the use of queryables (e.g., properties) in any position of a clause, not just in the first position. This allows predicates like `property1 == property2` be expressed, whereas the Basic CQL conformance class only requires comparisons against literal values. @@ -354,18 +354,18 @@ at least these values: "http://www.opengis.net/spec/ogcapi_common-2/1.0/req/collections", - "http://api.stacspec.org/v1.0.0-beta.3/core", - "http://api.stacspec.org/v1.0.0-beta.3/stac-search", - "http://api.stacspec.org/v1.0.0-beta.3/stac-response", - - "https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:filter", - "https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:features-filter", - "https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:basic-cql", - "https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:cql-text", - "https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:cql-json", - "https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:basic-spatial-operators", - "https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:basic-temporal-operators", - "https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:enhanced-comparison-operators" + "http://api.stacspec.org/v1.0.0-beta.4/core", + "http://api.stacspec.org/v1.0.0-beta.4/stac-search", + "http://api.stacspec.org/v1.0.0-beta.4/stac-response", + + "https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:filter", + "https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:features-filter", + "https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:basic-cql", + "https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:cql-text", + "https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:cql-json", + "https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:basic-spatial-operators", + "https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:basic-temporal-operators", + "https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:enhanced-comparison-operators" ], "links": [ diff --git a/fragments/filter/openapi.yaml b/fragments/filter/openapi.yaml index c1a331b2..be5fe32e 100644 --- a/fragments/filter/openapi.yaml +++ b/fragments/filter/openapi.yaml @@ -2,7 +2,7 @@ openapi: 3.0.3 info: title: The SpatioTemporal Asset Catalog API - Filter description: Adds parameters to compare properties and only return the items that match - version: 1.0.0-beta.3 + version: 1.0.0-beta.4 tags: - name: STAC API - Core diff --git a/fragments/itemcollection/openapi.yaml b/fragments/itemcollection/openapi.yaml index ed222885..b2295e4d 100644 --- a/fragments/itemcollection/openapi.yaml +++ b/fragments/itemcollection/openapi.yaml @@ -2,7 +2,7 @@ openapi: 3.0.3 info: title: The SpatioTemporal Asset Catalog API - Item Collection description: The specification for a set of items, e.g. returned by a search. - version: 1.0.0-beta.3 + version: 1.0.0-beta.4 paths: {} components: schemas: diff --git a/fragments/query/README.md b/fragments/query/README.md index 2229092d..38a3cfb1 100644 --- a/fragments/query/README.md +++ b/fragments/query/README.md @@ -1,7 +1,7 @@ # STAC API - Query Fragment - **OpenAPI specification:** [openapi.yaml](openapi.yaml) -- **Conformance Class:** +- **Conformance Class:** - **Extension [Maturity Classification](../../extensions.md#extension-maturity):** Pilot, scheduled to be Deprecated in favor of the [Filter Extension](../filter/README.md) using [CQL](http://docs.opengeospatial.org/DRAFTS/19-079.html). - **Dependents:** - [Item Search](../../item-search) diff --git a/fragments/query/openapi.yaml b/fragments/query/openapi.yaml index fd22abc7..ccdaeabe 100644 --- a/fragments/query/openapi.yaml +++ b/fragments/query/openapi.yaml @@ -2,7 +2,7 @@ openapi: 3.0.3 info: title: The SpatioTemporal Asset Catalog API - Query description: Adds parameter to compare properties and only return the items that match - version: 1.0.0-beta.3 + version: 1.0.0-beta.4 paths: {} components: parameters: diff --git a/fragments/sort/README.md b/fragments/sort/README.md index 8c61d51d..dd531bb3 100644 --- a/fragments/sort/README.md +++ b/fragments/sort/README.md @@ -1,7 +1,7 @@ # STAC API - Sort Fragment - **OpenAPI specification:** [openapi.yaml](openapi.yaml) -- **Conformance Class:** +- **Conformance Class:** - **Fragment [Maturity Classification](../../extensions.md#extension-maturity):** Pilot - **Dependents:** - [Item Search](../../item-search) diff --git a/fragments/sort/openapi.yaml b/fragments/sort/openapi.yaml index 7cfbf7cd..e64a2cb9 100644 --- a/fragments/sort/openapi.yaml +++ b/fragments/sort/openapi.yaml @@ -2,7 +2,7 @@ openapi: 3.0.3 info: title: The SpatioTemporal Asset Catalog API - Sort description: Adds Parameter to control sorting of returns results. - version: 1.0.0-beta.3 + version: 1.0.0-beta.4 paths: {} components: parameters: diff --git a/item-search/README.md b/item-search/README.md index ba019598..8dcf2bf2 100644 --- a/item-search/README.md +++ b/item-search/README.md @@ -20,8 +20,8 @@ - [Context](#context) - [Query](#query) -- **OpenAPI specification:** [openapi.yaml](openapi.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-beta.3/item-search)) -- **Conformance URI:** +- **OpenAPI specification:** [openapi.yaml](openapi.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-beta.4/item-search)) +- **Conformance URI:** - **Dependencies**: [STAC API - Core](../core) - **Examples**: [examples.md](examples.md) @@ -256,8 +256,8 @@ the [overview](../overview.md#example-landing-page) document. "title": "A simple STAC API Example", "description": "This Catalog aims to demonstrate the a simple landing page", "conformsTo" : [ - "https://api.stacspec.org/v1.0.0-beta.3/core", - "https://api.stacspec.org/v1.0.0-beta.3/item-search" + "https://api.stacspec.org/v1.0.0-beta.4/core", + "https://api.stacspec.org/v1.0.0-beta.4/item-search" ], "links": [ { @@ -298,7 +298,7 @@ the root (`/`) landing page, to indicate to clients that they will respond prope ### Fields -- **Conformance URI:** +- **Conformance URI:** - **Extension [Maturity Classification](../extensions.md#extension-maturity):** Pilot - **Definition**: [STAC API - Fields Fragment](../fragments/fields/) @@ -310,7 +310,7 @@ through the use of a `fields` parameter. The full description of how this extens ### Filter -- **Conformance URI:** +- **Conformance URI:** - **Extension [Maturity Classification](../extensions.md#extension-maturity):** Pilot - **Definition**: [STAC API - Filter Fragment](../fragments/filter/) @@ -322,7 +322,7 @@ fragment](../fragments/filter/). ### Sort -- **Conformance URI:** +- **Conformance URI:** - **Extension [Maturity Classification](../extensions.md#extension-maturity):** Pilot - **Definition**: [STAC API - Sort Fragment](../fragments/sort/) @@ -335,7 +335,7 @@ of this extension can be found in the [sort fragment](../fragments/sort). ### Context -- **Conformance URI:** +- **Conformance URI:** - **Extension [Maturity Classification](../extensions.md#extension-maturity):** Pilot - **Definition**: [STAC API - Context Fragment](../fragments/context/) @@ -345,7 +345,7 @@ The full description and examples of this are found in the [context fragment](.. ### Query -- **Conformance URI:** +- **Conformance URI:** - **Extension [Maturity Classification](../extensions.md#extension-maturity):** Pilot, scheduled to be Deprecated - **Definition**: [STAC API - Query Fragment](../fragments/query/) diff --git a/item-search/openapi.yaml b/item-search/openapi.yaml index b719c42a..4f85b452 100644 --- a/item-search/openapi.yaml +++ b/item-search/openapi.yaml @@ -1,7 +1,7 @@ openapi: 3.0.3 info: title: STAC API - Item Search - version: 1.0.0-beta.3 + version: 1.0.0-beta.4 description: >- This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Item Search specification. diff --git a/ogcapi-features/README.md b/ogcapi-features/README.md index b4447ab1..479b6ceb 100644 --- a/ogcapi-features/README.md +++ b/ogcapi-features/README.md @@ -12,10 +12,10 @@ *based on [**OGC API - Features - Part 1: Core**](https://www.ogc.org/standards/ogcapi-features)* -- **OpenAPI specification:** [openapi.yaml](openapi.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-beta.3/ogcapi-features)) +- **OpenAPI specification:** [openapi.yaml](openapi.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-beta.4/ogcapi-features)) uses all the OGC API - Features openapi fragments to describe returning STAC Item objects. - **Conformance URIs:** - - + - - - [Requirements Class Core](http://docs.opengeospatial.org/is/17-069r3/17-069r3.html#rc_core)) - - [Requirements Class OpenAPI 3.0](http://docs.opengeospatial.org/is/17-069r3/17-069r3.html#rc_oas30)) - - [Requirements Class GeoJSON](http://docs.opengeospatial.org/is/17-069r3/17-069r3.html#_requirements_class_geojson)) @@ -151,8 +151,8 @@ the [overview](../overview.md#example-landing-page) document. "title": "A simple STAC API Example", "description": "This Catalog aims to demonstrate the a simple landing page", "conformsTo" : [ - "https://api.stacspec.org/v1.0.0-beta.3/core", - "https://api.stacspec.org/v1.0.0-beta.3/ogcapi-features", + "https://api.stacspec.org/v1.0.0-beta.4/core", + "https://api.stacspec.org/v1.0.0-beta.4/ogcapi-features", "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core", "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30", "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson" @@ -241,7 +241,7 @@ to requests from clients. ### Transaction - **Conformance URIs:** - - + - - - **Extension [Maturity Classification](../extensions.md#extension-maturity):** Pilot - **Definition**: [STAC API - Transaction Fragment](extensions/transaction/) @@ -253,7 +253,7 @@ POST, PUT, PATCH, and DELETE methods. The full description of how this extension ### Items and Collections API Version Extension -- **Conformance URI:** +- **Conformance URI:** - **Extension [Maturity Classification](../extensions.md#extension-maturity):** Pilot - **Definition**: [STAC API - Version](extensions/version/) diff --git a/ogcapi-features/extensions/transaction/README.md b/ogcapi-features/extensions/transaction/README.md index 73d5b971..35629c5d 100644 --- a/ogcapi-features/extensions/transaction/README.md +++ b/ogcapi-features/extensions/transaction/README.md @@ -4,7 +4,7 @@ - **OpenAPI specification:** [openapi.yaml](openapi.yaml) - **Conformance URIs:** - - + - - - **Extension [Maturity Classification](../../../extensions.md#extension-maturity):** Pilot - **Dependencies**: [STAC API - Features](../../README.md) diff --git a/ogcapi-features/extensions/transaction/openapi.yaml b/ogcapi-features/extensions/transaction/openapi.yaml index a2bb850e..f98fb612 100644 --- a/ogcapi-features/extensions/transaction/openapi.yaml +++ b/ogcapi-features/extensions/transaction/openapi.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: The SpatioTemporal Asset Catalog API - Transaction - version: 1.0.0-beta.3 + version: 1.0.0-beta.4 description: >- This is an OpenAPI definition of the SpatioTemporal Asset Catalog API Transaction specification. diff --git a/ogcapi-features/extensions/version/README.md b/ogcapi-features/extensions/version/README.md index b6a4b7fd..906b14c4 100644 --- a/ogcapi-features/extensions/version/README.md +++ b/ogcapi-features/extensions/version/README.md @@ -1,7 +1,7 @@ # Items and Collections API Version Extension - **OpenAPI specification:** [openapi.yaml](openapi.yaml) -- **Conformance URI:** +- **Conformance URI:** - **Extension [Maturity Classification](../../../extensions.md#extension-maturity):** Proposal - **Dependencies**: [STAC API - Features](../../README.md) diff --git a/ogcapi-features/extensions/version/openapi.yaml b/ogcapi-features/extensions/version/openapi.yaml index 6f720835..79a1e1f6 100644 --- a/ogcapi-features/extensions/version/openapi.yaml +++ b/ogcapi-features/extensions/version/openapi.yaml @@ -1,7 +1,7 @@ openapi: 3.0.3 info: title: The SpatioTemporal Asset Catalog API - Item Search - version: 1.0.0-beta.3 + version: 1.0.0-beta.4 description: >- This is an OpenAPI definition of the SpatioTemporal Asset Catalog API Item Search specification. diff --git a/ogcapi-features/openapi.yaml b/ogcapi-features/openapi.yaml index 70111cef..f4644e72 100644 --- a/ogcapi-features/openapi.yaml +++ b/ogcapi-features/openapi.yaml @@ -1,7 +1,7 @@ openapi: 3.0.3 info: title: STAC API - Features - version: '1.0.0-beta.3' + version: '1.0.0-beta.4' description: >- This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Features specification. This extends OGC API - Features - Part 1: Core. @@ -38,13 +38,13 @@ paths: schema: $ref: '../core/openapi.yaml#/components/schemas/landingPage' example: - stac_version: 1.0.0-beta.3 + stac_version: 1.0.0-beta.4 type: Catalog id: sentinel title: Copernicus Sentinel Imagery description: Catalog of Copernicus Sentinel 1 and 2 imagery. conformsTo: - - 'https://api.stacspec.org/v1.0.0-beta.3/core' + - 'https://api.stacspec.org/v1.0.0-beta.4/core' - 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core' - 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30' - 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson' diff --git a/overview.md b/overview.md index a8fdaecf..5644e646 100644 --- a/overview.md +++ b/overview.md @@ -20,7 +20,7 @@ off point for the more powerful capabilities - it contains a list of URL's, each 'relationships' (`rel`) to indicate their functionality. Note that the [STAC Core specification](stac-spec) provides most all the content of API responses - the STAC API is primarily concerned with the return of STAC [Item](stac-spec/item-spec/README.md) and [Collection](stac-spec/collection-spec/README.md) objects via a -RESTful web API. See the [rendered OpenAPI document](https://api.stacspec.org/v1.0.0-beta.3/core) for more details. +RESTful web API. See the [rendered OpenAPI document](https://api.stacspec.org/v1.0.0-beta.4/core) for more details. There are then two major sets of functionality that build on the core, which are designed to be complementary, letting implementations choose which parts they want to utilize. Most every STAC API implements at least one, and many follow @@ -33,7 +33,7 @@ located at a `/search` endpoint. It re-uses all of the OAFeat [query parameters](http://docs.opengeospatial.org/is/17-069r3/17-069r3.html#_items_) specified in their 'core', and adds a couple more. It does not require a full implementation of OAFeat, it is instead a simplified construct that can run a search across any set of indexed STAC [`Item`](stac-spec/item-spec/README.md) objects. See the [rendered OpenAPI -document](https://api.stacspec.org/v1.0.0-beta.3/item-spec) for more details. +document](https://api.stacspec.org/v1.0.0-beta.4/item-spec) for more details. ### Collections @@ -65,7 +65,7 @@ is always in GeoJSON and OpenAPI is used to specify STAC API. Full compliance in individual `/collections/{collectionId}/items` endpoints that expose querying single collections, as OAFeat does not currently allow cross-collection search. And it adds a few other requirements, which are highlighted in the [features description](ogcapi-features/), in order to help STAC implementors understand OAFeat without having to -read the full spec from scratch. See the [rendered OpenAPI document](https://api.stacspec.org/v1.0.0-beta.3/ogcapi-features) +read the full spec from scratch. See the [rendered OpenAPI document](https://api.stacspec.org/v1.0.0-beta.4/ogcapi-features) for more details. ### Extensions & Fragments @@ -122,7 +122,7 @@ column is more of an example in some cases. OGC API makes some endpoint location STAC API is evolving to utilize OAFeat's '[Conformance](http://docs.opengeospatial.org/is/17-069r3/17-069r3.html#_declaration_of_conformance_classes)' JSON structure. For -STAC API 1.0.0-beta.3 we declare new STAC Conformance classes, with the core ones detailed in the table below. [STAC +STAC API 1.0.0-beta.4 we declare new STAC Conformance classes, with the core ones detailed in the table below. [STAC Features](ogcapi-features) requires the core OAFeat conformance classes, and declares that those endpoints return STAC Collection and Feature objects. The core STAC conformance classes communicate the conformance JSON only in the root (`/`) document, while OGC API @@ -138,10 +138,10 @@ have the URI's for conformance to actually resolve to machine-readable informati | **Name** | **Specified in** | **Conformance URI** | **Description** | | ------------- | -------------------------------------- | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | -| STAC Core | [Core](core) | | Specifies the STAC Landing page `/`, communicating conformance and available endpoints. | -| Item Search | [Item Search](item-search) | | Enables search of all STAC Item objects on the server, with the STAC `[/search](#stac-api-endpoints)` endpoint. | -| STAC Features | [STAC API - Features](ogcapi-features) | | Specifies the use of OGC API - Features to serve STAC Item and Collection objects | -| Collections | [Collections](collections) | | Specifies the use of a subset of OGC API - Features to serve Collection objects | +| STAC Core | [Core](core) | | Specifies the STAC Landing page `/`, communicating conformance and available endpoints. | +| Item Search | [Item Search](item-search) | | Enables search of all STAC Item objects on the server, with the STAC `[/search](#stac-api-endpoints)` endpoint. | +| STAC Features | [STAC API - Features](ogcapi-features) | | Specifies the use of OGC API - Features to serve STAC Item and Collection objects | +| Collections | [Collections](collections) | | Specifies the use of a subset of OGC API - Features to serve Collection objects | Additional conformance classes are specified in the [STAC Extensions](extensions.md#Conformance-classes-of-extensions). @@ -162,10 +162,10 @@ The Landing Page will at least have the following `conformsTo` and `links`: "title": "A simple STAC API Example", "description": "This Catalog aims to demonstrate the a simple landing page", "conformsTo" : [ - "https://api.stacspec.org/v1.0.0-beta.3/core", - "https://api.stacspec.org/v1.0.0-beta.3/item-search", - "https://api.stacspec.org/v1.0.0-beta.3/ogcapi-features", - "https://api.stacspec.org/v1.0.0-beta.3/collections", + "https://api.stacspec.org/v1.0.0-beta.4/core", + "https://api.stacspec.org/v1.0.0-beta.4/item-search", + "https://api.stacspec.org/v1.0.0-beta.4/ogcapi-features", + "https://api.stacspec.org/v1.0.0-beta.4/collections", "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core", "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30", "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson" diff --git a/package.json b/package.json index be5a0971..fc55b2fb 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "api-spec", - "version": "1.0.0-beta.3", + "version": "1.0.0-beta.4", "description": "STAC API helpers to generate, serve and check the API spec.", "repository": "https://github.com/radiantearth/stac-api-spec", "license": "Apache-2.0", @@ -31,4 +31,4 @@ "remark-preset-lint-recommended": "^4.0.1", "remark-validate-links": "^10.0.2" } -} +} \ No newline at end of file