Skip to content

Latest commit

 

History

History
283 lines (206 loc) · 13.7 KB

CHANGELOG.md

File metadata and controls

283 lines (206 loc) · 13.7 KB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

v1.0.0 - 2023-04-24

None

v1.0.0-rc.4 - 2023-04-13

Changed

  • Field type is no longer required for all Link objects, but is instead strongly recommended. This was added as a requirement in 1.0.0-rc.3 based on a mis-reading of the OGC Features spec, and is now removed as a requirement.

v1.0.0-rc.3 - 2023-03-27

Changed

Added

  • Added authentication status code recommendations.
  • Added extension field to all OpenAPI specifications x-conformance-classes indicating the conformance classes they define.
  • STAC API - Item Search now requires a root link relation in the response from /search
  • Added a collection link from and Item to its Collection to conform with the STAC spec.

Fixed

  • Item Search limit parameter semantics have been changed again to align with the current OAFeat definition, rather than the inconsistent definition in version 1.0. The new behavior is that if a client requests a limit value above the maximum advertised by the server, that the server should treat the request as if the limit parameter were the maximum value. It must not respond with a error because the the limit value, and must respond with no more than that many items.

v1.0.0-rc.2 - 2022-11-01

Added

  • Added optional numberMatched and numberReturned fields to ItemCollection to align with OGC Commons and OAFeat.

Changed

  • The Collections specification has been incorporated into the Features specification, but remains as a separate conformance class.
  • The Browseable specification has been incorporated into the Core specification, but remains as a separate conformance class.
  • Extensions moved to standalone specification repositories:

Fixed

  • Item Search limit parameter semantics now align with OAFeat. The server must not return more Items than the limit and a limit value higher than advertised in the service description must return a 400 Bad Request status code.

v1.0.0-rc.1 - 2022-03-17

Added

  • The CQL2 Accent and Case-insensitive Comparison (http://www.opengis.net/spec/cql2/1.0/conf/accent-case-insensitive-comparison) conformance class adds the ACCENTI and CASEI functions for case-insensitive comparison. These replace the UPPER and LOWER psuedo-functions that were previously part of the Advanced Comparison Operators class.

Changed

  • Query Extension is no longer deprecated.
  • Children conformance class now requires the /children endpoint includes all child catalogs or collections referenced via child link relations from the Landing Page
  • Clarified behavior of Transaction Extension endpoints:
    • PUT and PATCH of a body that changes the collection or id is disallowed.
    • POST, PUT, and PATCH do not need to include the collection attribute, as it should be derived from the URL.
    • POST and PUT can be used with a body that is at least a GeoJSON Feature, but does not have to be an Item, but for which the server can derive a valid Item, e.g., by populating the id and collection fields or adding links
    • Likewise, POST can be used with a body of a FeatureCollection that contains features that meet the same constraints.
  • Specifications now use the term "must" instead of "shall". The semantics of these words are identical.
  • Conformance class for Item Search Filter is now https://api.stacspec.org/v1.0.0-beta.5/item-search#filter, whereas before it was incorrectly stated as https://api.stacspec.org/v1.0.0-beta.5/item-search#filter:item-search-filter

Deprecated

Removed

Fixed

v1.0.0-beta.5 - 2022-01-14

Added

  • Added STAC API - Browseable conformance class
  • Added STAC API - Children conformance class
  • Added description of how to support both search and browse in an API.
  • The paging mechanism via a Link with rel next or prev as defined for Item Search can also be used for the STAC API - Features endpoint /collections/{collection_id}/items, as described in OAFeat.
  • The paging mechanism via a Link with rel next or prev as defined for items can also be used for the STAC API - Features and STAC API - Collections endpoint /collections.

Changed

  • Limit parameter semantics now match OAFeat. Previously, the behavior was not precisely defined.
  • Filter Extension updates to align with changes to OAFeat CQL2 spec
    • Updated all "CQL" usages to "CQL2"
    • Most conformance class URIs are now prefixed with http://www.opengis.net/spec/cql2/ instead of http://www.opengis.net/spec/ogcapi-features-3/
    • Conformance classes http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/basic-cql, http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/cql-text, and http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/cql-json have had cql replaced with cql2 (in addition to the prefix change) to become http://www.opengis.net/spec/cql2/1.0/conf/basic-cql2, http://www.opengis.net/spec/cql2/1.0/conf/cql2-text, and http://www.opengis.net/spec/cql2/1.0/conf/cql2-json
    • Significant changes to CQL2 JSON format, now using op and args structure
    • Spatial operator INTERSECTS is now S_INTERSECTS
    • Temporal operator ANYINTERACTS is now T_INTERSECTS
    • Updated Example 3 (now Example 5) to make it clear that property to property comparisons require the Property-Property Comparisons conformance class
    • The CQL2 Case-insensitive Comparison (http://www.opengis.net/spec/cql2/1.0/conf/case-insensitive-comparison) conformance class that adds UPPER/LOWER terms or function CASEI for case-insensitive comparison has not been added to this spec yet, since the definition in CQL2 is in flux.
  • service-desc endpoint may return any service description format, typically a machine-consumable one (previous restricted required to be OpenAPI 3.0 JSON)
  • service-doc endpoint may return any service description format, typically a human-consumable one (previous restricted required to be HTML)

Deprecated

Removed

Fixed

  • Collection conformance class URI should be https://api.stacspec.org/v1.0.0-beta.XXX/collections instead of http://stacspec.org/spec/api/1.0.0-beta.XXX/extensions/collections
  • definition of Item object was missing properties as an attribute
  • Filter Extension - examples of using intervals and timestamps in CQL2 were incorrect and have been fixed
  • Filter Extension - examples are updated so that text and json examples are equivalent

v1.0.0-beta.4 - 2021-10-05

Added

  • Support binding Sort, Fields, and Context Extensions to STAC Features items resource endpoint (/collections/{collectionId}/items)
  • In Collections, added canonical rel type, added / and /api to list of endpoints
  • In Item Search, added endpoint table

Changed

  • Filter Extension - query language is now referred to as "CQL2" rather than CQL
  • Filter Extension now uses OAFeat Part 3 conformance class URIs
  • Filter Extension - The following changes have been made to the Filter Extension conformance classes to align with changes to the OAFeat CQL draft. All classes whose names have changed also have changed conformance URI strings.
    • "Basic CQL" now includes the "not equal" operator (<>)
    • "Basic CQL" has always supported datetime comparisons, but this is now explicitly mentioned
    • "Enhanced Comparison Operators" has been renamed "Advanced Comparison Operators". This is the same as the OAFeat CQL definition, except that it does not require the upper and lower functions.
    • "Enhanced Spatial Operators" has been renamed to just "Spatial Operators" (not to be confused with Basic Spatial Operators)
    • "Basic Temporal Operators" and "Enhanced Temporal Operators" have merged into "Temporal Operators"
    • "Functions" has been renamed "Custom Functions"
    • "Arithmetic" has been renamed "Arithmetic Expressions"
    • "Arrays" has been renamed "Array Operators"
    • "Queryable Second Operand" has been renamed "Property-Property Comparisons"
  • The required Link Relations and endpoints for each conformance class now use the wording of 'shall' instead of 'should'. While this technically changes the semantics, it was generally understood previously the semantics were those of 'shall' (must).
  • Explicitly state that the /children endpoint can return Catalog and Collection objects that have fewer fields than are available through other endpoints.

Deprecated

Removed

Fixed

v1.0.0-beta.3 - 2021-08-06

Added

  • Added STAC API - Collections definition (subset of STAC API - Features)
  • More thorough definitions for valid datetime and bbox query parameter values.

Changed

Deprecated

Removed

  • Remove stac_version and stac_extensions fields in ItemCollection

Fixed

v1.0.0-beta.2 - 2021-06-01

Added

  • Added Filter extension to integrate OAFeat Part 3 CQL
  • Catalog and Collection definitions now have required field "type"
  • Added recommendation to enable CORS for public APIs

Changed

  • Updated all STAC versions to 1.0.0
  • Passing the ids parameter to an item search does not deactivate other query parameters #125
  • The first extent in a Collection is always the overall extent, followed by more specific extents. opengeospatial/ogcapi-features#520

Deprecated

  • Query extension is now deprecated. Replaced by the Filter extension using OGC CQL.

Removed

Fixed

  • Updated text description of root ('/') endpoint (also called landing page) that the return type is a Catalog

v1.0.0-beta.1 - 2020-12-10

Added

  • The landing page returns the conformance classes in a property conformsTo, which mirrors GET /conformances from OGC APIs.
  • Conformance classes for all the major functionality and extensions, to be referenced in a new conformsTo JSON object in the landing page.
  • Fragments: reusable OpenAPI documents for sort, filter, fields and context, along with explanation of how they work.
  • ItemCollection moved from STAC Core to this repo.

Changed

  • Major re-organization of the content and directory structure to make better conformance classes.
    • STAC API Core is the landing page (a STAC catalog and conformance information).
    • Item Search is the search cross-collection item search resource.
    • STAC API - Features is the OGC API - Features standards to be used in a STAC API.
    • Extensions are specified in the relevant functionality directory, though they can share openapi yaml's in the 'fragments' directory.
  • Updated to STAC specification version 1.0.0-beta.2
  • Named explicit supported STAC core versions to be from 0.9.0 up to (and not including) 2.0.0
  • Context Extension OpenAPI spec was updated to remove the no longer used next attribute
  • Added root endpoint Link search must have type of application/geo+json
  • Corrected the description of endpoint /collections to say it returns an object per OAFeat, instead of an array of Collection
  • Updated transaction extension so it aligns with OGC API - Features Part 4: Simple Transactions

Deprecated

Removed

Fixed

  • BBOX openapi yaml to only allow 4 or 6 element arrays
  • Fixed invalid OpenAPI files

Older versions

See the stac-spec CHANGELOG for STAC API releases prior to or equal to version 0.9.0.