Skip to content

Commit

Permalink
Remove stac version and extensions from item collection (#171)
Browse files Browse the repository at this point in the history
* ItemCollection: remove stac_version and stac_extensions fields
  • Loading branch information
philvarner authored Jul 15, 2021
1 parent 44b0a0b commit 4c1a5dd
Show file tree
Hide file tree
Showing 7 changed files with 6 additions and 27 deletions.
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
### Deprecated

### Removed
- Remove stac_version and stac_extensions fields in ItemCollection

### Fixed

Expand Down
4 changes: 2 additions & 2 deletions core/commons.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -600,8 +600,8 @@ components:
example:
stac_version: 1.0.0
stac_extensions:
- eo
- view
- 'https://stac-extensions.github.io/eo/v1.0.0/schema.json'
- 'https://stac-extensions.github.io/view/v1.0.0/schema.json'
- 'https://example.com/cs-extension/1.0/schema.json'
type: Feature
id: CS3-20160503_132131_05
Expand Down
6 changes: 3 additions & 3 deletions fragments/filter/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -627,9 +627,9 @@ A sample STAC Item (excluding `assets`) is:
"type": "Feature",
"stac_version": "1.0.0",
"stac_extensions": [
"eo",
"view",
"proj"
"https://stac-extensions.github.io/eo/v1.0.0/schema.json",
"https://stac-extensions.github.io/view/v1.0.0/schema.json",
"https://stac-extensions.github.io/projection/v1.0.0/schema.json"
],
"id": "S2A_60HWB_20201111_0_L2A",
"bbox": [ 176.9997779369264, -39.83783732066656, 178.14624317719924, -38.842842449352425],
Expand Down
13 changes: 0 additions & 13 deletions fragments/itemcollection/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,23 +21,10 @@ This object describes a STAC ItemCollection. The fields `type` and `features` ar

| Field Name | Type | Description |
| --------------- | --------------------------------------- | ----------- |
| stac_version | string | **REQUIRED.** The STAC version the ItemCollection implements. |
| stac_extensions | \[string\] | A list of extensions the ItemCollection implements. |
| type | string | **REQUIRED.** Always "FeatureCollection" to provide compatibility with GeoJSON. |
| features | [STAC Item](../../stac-spec/item-spec/item-spec.md) | **REQUIRED** A possibly-empty array of Item objects. |
| links | [Link Object](../../stac-spec/item-spec/item-spec.md#link-object) | An array of Links related to this ItemCollection. |

**stac_version**: In general, STAC versions can be mixed, but please keep the [recommended best
practices](../../stac-spec/best-practices.md#mixing-stac-versions) in mind.

**stac_extensions**: A list of STAC content extensions the ItemCollection implements. The list contains URLs to the JSON Schema files it
can be validated against. For official [STAC extensions](https://stac-extensions.github.io/#list-of-stac-extensions), a "shortcut"
can be used. This means you can specify the folder name of the extension, for example `single-file-stac` for the Single File
STAC extension. This does *not* apply for [API extensions](../../extensions.md). If the versions of the extension and the item diverge,
you can specify the URL of the JSON schema file. This list must only contain extensions that extend the ItemCollection itself, see the
the 'Scope' column in the list of extensions. It must not contain extensions that extend the Item objects, these must be specified in the
Item object directly.

## Extensions

- The [Context Extension](../../item-search/README.md#context) adds additional fields to STAC ItemCollection relevant
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,4 @@
{
"stac_version": "1.0.0",
"stac_extensions": [],
"type": "FeatureCollection",
"features": [
{
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,4 @@
{
"stac_version": "1.0.0",
"stac_extensions": [],
"type": "FeatureCollection",
"features": []
}
5 changes: 0 additions & 5 deletions fragments/itemcollection/openapi.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -11,14 +11,9 @@ components:
A GeoJSON FeatureCollection augmented with foreign members that contain values relevant to a STAC entity
type: object
required:
- stac_version
- features
- type
properties:
stac_version:
$ref: '../../core/commons.yaml#/components/schemas/stac_version'
stac_extensions:
$ref: '../../core/commons.yaml#/components/schemas/stac_extensions'
type:
type: string
enum:
Expand Down

0 comments on commit 4c1a5dd

Please sign in to comment.