Skip to content

Releases: radiantearth/stac-api-spec

v1.0.0

25 Apr 17:53
@philvarner philvarner
v1.0.0
604ade6
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v1.0.0 Latest
Latest

What's Changed

Read more

Contributors

kurtmckee, tschaub, and 17 other contributors
Assets 2
Loading
0 Join discussion

v1.0.0-rc.4

17 Apr 15:28
@philvarner philvarner
v1.0.0-rc.4
80932ce
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v1.0.0-rc.4

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.

Assets 2
Loading
0 Join discussion

v1.0.0-rc.3

27 Mar 15:57
@philvarner philvarner
v1.0.0-rc.3
43078a5
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v1.0.0-rc.3

[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.

What's Changed

New Contributors

Full Changelog: v1.0.0-rc.2...v1.0.0-rc.3

Contributors

kurtmckee, tschaub, and 4 other contributors
Assets 2
Loading

v1.0.0-rc.2

01 Nov 21:43
@philvarner philvarner
v1.0.0-rc.2
d4f8b4a
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v1.0.0-rc.2

[1.0.0-rc.2]

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.

What's Changed

New Contributors

Full Changelog: v1.0.0-rc.1...v1.0.0-rc.2

Contributors

tschaub, philvarner, and 5 other contributors
Assets 2
Loading

v1.0.0-rc.1

21 Mar 17:42
@philvarner philvarner
v1.0.0-rc.1
62003db
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v1.0.0-rc.1

[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

What's Changed

  • Filter Extension - add Accent and Case-insensitive Comparison conform… by @philvarner in #235
  • Update example urls by @philvarner in #264
  • add type=application/geo+json to prev and next links by @philvarner in #266
  • Undeprecate query extension by @philvarner in #262
  • update CQL2 definition to reference OGC API yaml file in github, update npm build by @philvarner in #261
  • require children endpoint to return all child link objects by @philvarner in #265
  • update CQL2 implemenation suggestions by @philvarner in #269
  • explicitly state /children may return fewer fields for its entities by @philvarner in #273
  • clarify wording of search link rel requirement by @philvarner in #267
  • change all uses of shall to must, and stylize all non-linked conformance classes by @philvarner in #276
  • Pv/filter extension conformance class consistency by @philvarner in #279
  • update 1.0.0 beta.5 to rc.1 by @philvarner in #278
  • Update maturity classification for all conformance classes and extensions by @philvarner in #283
  • remove stray text from Filter by @philvarner in #290
  • Add Releases to readme and add all conformance classes to build index by @philvarner in #284
  • remove unused openapi spec elements and fix several stac_version values by @philvarner in #289
  • fix a few minor openapi spec issues, upgrade remark and spectral by @philvarner in #287
  • Claify Transaction Extension behavior by @philvarner in #271
  • v.1.0.0-rc.1 release merge to master by @philvarner in #291

Full Changelog: v1.0.0-beta.5...v1.0.0-rc.1

Contributors

philvarner
Assets 2
Loading

v1.0.0-beta.5

14 Jan 15:39
@philvarner philvarner
v1.0.0-beta.5
a93cfec
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v1.0.0-beta.5

[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

What's Changed

Read more

Contributors

philvarner, bitner, and 9 other contributors
Assets 2
Loading

v1.0.0-beta.4

07 Oct 00:51
@philvarner philvarner
v1.0.0-beta.4
0f1ff40
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v1.0.0-beta.4

[v1.0.0-beta4] - 2020-10-05

Added

  • Support binding Sort, Fields, and Context Extensions to STAC Features items resource
    endpoint (/collections/{collection_id}/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).

Deprecated

Removed

Fixed

New Contributors

Full Changelog: v1.0.0-beta.3...v1.0.0-beta.4

Contributors

davidraleigh and sbrunato
Assets 2
Loading

v1.0.0-beta.3

10 Aug 18:18
@philvarner philvarner
v1.0.0-beta.3
8745df7
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v1.0.0-beta.3

[v1.0.0-beta.3] - 2020-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

n/a

Removed

  • Remove stac_version and stac_extensions fields in ItemCollection

Fixed

n/a

Assets 2
Loading

v1.0.0-beta.2

09 Jun 13:07
@philvarner philvarner
v1.0.0-beta.2
1615434
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v1.0.0-beta.2

[v1.0.0-beta.2] - 2020-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
Assets 2
Loading

v1.0.0-beta.1

10 Dec 23:15
@cholmes cholmes
v1.0.0-beta.1
0d51770
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
v1.0.0-beta.1

[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
Assets 2
Loading