Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update version references to 1.0.0-beta.4 #199

Merged
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 <https://api.stacspec.org/v1.0.0-beta.3>, in addition to human-readable documentation.
rendered online into HTML at <https://api.stacspec.org/v1.0.0-beta.4>, in addition to human-readable documentation.

## Stability Note

Expand Down
2 changes: 1 addition & 1 deletion build/swagger-config.yaml
Original file line number Diff line number Diff line change
@@ -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:
Expand Down
4 changes: 2 additions & 2 deletions collections/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
- [Conformance](#conformance)

- **OpenAPI specification:** Missing
- **Conformance URI:** <http://stacspec.org/spec/api/1.0.0-beta.3/extensions/collections>
- **Conformance URI:** <http://stacspec.org/spec/api/1.0.0-beta.4/extensions/collections>
- **Extension [Maturity Classification](../extensions.md#extension-maturity):** Pilot
- **Dependencies**: [STAC API - Core](../core)

Expand Down Expand Up @@ -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.
Expand Down
6 changes: 3 additions & 3 deletions collections/openapi.yaml
Original file line number Diff line number Diff line change
@@ -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.
Expand Down Expand Up @@ -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'
Expand Down
6 changes: 3 additions & 3 deletions core/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:** <https://api.stacspec.org/v1.0.0-beta.3/core>
- **Conformance URI:** <https://api.stacspec.org/v1.0.0-beta.4/core>
- **Extension [Maturity Classification](../extensions.md#extension-maturity):** Pilot
- **Dependencies**: None

Expand Down Expand Up @@ -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": [
{
Expand Down
2 changes: 1 addition & 1 deletion core/commons.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
4 changes: 2 additions & 2 deletions core/openapi.yaml
Original file line number Diff line number Diff line change
@@ -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
Expand Down Expand Up @@ -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
Expand Down
22 changes: 11 additions & 11 deletions extensions.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
- <https://api.stacspec.org/v1.0.0-beta.3/item-search#fields>
- <https://api.stacspec.org/v1.0.0-beta.4/item-search#fields>
- [Filter](item-search/README.md#filter)
- <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:simple-cql>
- <https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:item-search-filter>
- <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.4/item-search#filter:filter>
- <https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:simple-cql>
- <https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:item-search-filter>
- <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>
- [Context](item-search/README.md#context)
- <https://api.stacspec.org/v1.0.0-beta.3/item-search#context>
- <https://api.stacspec.org/v1.0.0-beta.4/item-search#context>
- [Sort](item-search/README.md#sort)
- <https://api.stacspec.org/v1.0.0-beta.3/item-search#sort>
- <https://api.stacspec.org/v1.0.0-beta.4/item-search#sort>
- [Transaction](ogcapi-features/extensions/transaction/README.md)
- <https://api.stacspec.org/v1.0.0-beta.3/ogcapi-features/extensions/transaction>
- <https://api.stacspec.org/v1.0.0-beta.4/ogcapi-features/extensions/transaction>
- [Items and Collections API Version](ogcapi-features/extensions/version/README.md)
- <https://api.stacspec.org/v1.0.0-beta.3/ogcapi-features/extensions/version>
- <https://api.stacspec.org/v1.0.0-beta.4/ogcapi-features/extensions/version>
- [Query](item-search/README.md#query)
- <https://api.stacspec.org/v1.0.0-beta.3/item-search#query>
- <https://api.stacspec.org/v1.0.0-beta.4/item-search#query>

## Third-party / vendor extensions

Expand Down
2 changes: 1 addition & 1 deletion fragments/context/README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# STAC API - Context Fragment

- **OpenAPI specification:** [openapi.yaml](openapi.yaml)
- **Conformance Class:** <https://api.stacspec.org/v1.0.0-beta.3/item-search#context>
- **Conformance Class:** <https://api.stacspec.org/v1.0.0-beta.4/item-search#context>
- **Fragment [Maturity Classification](../../extensions.md#extension-maturity):** Pilot
- **Dependents:**
- [Item Search](../../item-search)
Expand Down
2 changes: 1 addition & 1 deletion fragments/context/openapi.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
2 changes: 1 addition & 1 deletion fragments/fields/README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# STAC API - Fields Fragment

- **OpenAPI specification:** [openapi.yaml](openapi.yaml)
- **Conformance Class:** <https://api.stacspec.org/v1.0.0-beta.3/item-search#fields>
- **Conformance Class:** <https://api.stacspec.org/v1.0.0-beta.4/item-search#fields>
- **Fragment [Maturity Classification](../../extensions.md#extension-maturity):** Pilot
- **Dependents:**
- [Item Search](../../item-search)
Expand Down
2 changes: 1 addition & 1 deletion fragments/fields/openapi.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
82 changes: 41 additions & 41 deletions fragments/filter/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,20 +2,20 @@

- **OpenAPI specification:** [openapi.yaml](openapi.yaml)
- **Conformance Classes:**
- Filter: <https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:filter>
- Item Search Filter: <https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:item-search-filter>
- CQL Text: <https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:cql-text>
- CQL JSON: <https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:cql-json>
- Basic CQL: <https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:basic-cql>
- Basic Spatial Operators: <https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:basic-spatial-operators>
- Basic Temporal Operators: <https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:basic-temporal-operators>
- Enhanced Comparison Operators: <https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:enhanced-comparison-operators>
- Enhanced Spatial Operators: <https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:enhanced-spatial-operators>
- Enhanced Temporal Operators: <https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:enhanced-temporal-operators>
- Functions: <https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:functions>
- Arithmetic: <https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:arithmetic>
- Arrays: <https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:arrays>
- Queryable Second Operand: <https://api.stacspec.org/v1.0.0-beta.3/item-search#filter:queryable-second-operand>
- Filter: <https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:filter>
- Item Search Filter: <https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:item-search-filter>
- CQL Text: <https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:cql-text>
- CQL JSON: <https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:cql-json>
- Basic CQL: <https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:basic-cql>
- Basic Spatial Operators: <https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:basic-spatial-operators>
- Basic Temporal Operators: <https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:basic-temporal-operators>
- Enhanced Comparison Operators: <https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:enhanced-comparison-operators>
- Enhanced Spatial Operators: <https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:enhanced-spatial-operators>
- Enhanced Temporal Operators: <https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:enhanced-temporal-operators>
- Functions: <https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:functions>
- Arithmetic: <https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:arithmetic>
- Arrays: <https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:arrays>
- Queryable Second Operand: <https://api.stacspec.org/v1.0.0-beta.4/item-search#filter:queryable-second-operand>
- **Extension [Maturity Classification](../../extensions.md#extension-maturity):** Pilot
- **Dependents:**
- [Item Search](../../item-search)
Expand Down Expand Up @@ -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
Expand All @@ -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.
Expand Down Expand Up @@ -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": [
Expand Down
2 changes: 1 addition & 1 deletion fragments/filter/openapi.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion fragments/itemcollection/openapi.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
Loading