From 4c1a5dd916b409624286c9e1d425fa8fce00a9a3 Mon Sep 17 00:00:00 2001 From: Phil Varner Date: Thu, 15 Jul 2021 09:43:30 -0400 Subject: [PATCH] Remove stac version and extensions from item collection (#171) * ItemCollection: remove stac_version and stac_extensions fields --- CHANGELOG.md | 1 + core/commons.yaml | 4 ++-- fragments/filter/README.md | 6 +++--- fragments/itemcollection/README.md | 13 ------------- .../examples/itemcollection-sample-full.json | 2 -- .../examples/itemcollection-sample-minimal.json | 2 -- fragments/itemcollection/openapi.yaml | 5 ----- 7 files changed, 6 insertions(+), 27 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 48e96210..b1a4ce1b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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 diff --git a/core/commons.yaml b/core/commons.yaml index e12b2ce6..0ab1f189 100644 --- a/core/commons.yaml +++ b/core/commons.yaml @@ -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 diff --git a/fragments/filter/README.md b/fragments/filter/README.md index 8f83c539..ea236d0c 100644 --- a/fragments/filter/README.md +++ b/fragments/filter/README.md @@ -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], diff --git a/fragments/itemcollection/README.md b/fragments/itemcollection/README.md index 706c6c48..5b186ccb 100644 --- a/fragments/itemcollection/README.md +++ b/fragments/itemcollection/README.md @@ -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 diff --git a/fragments/itemcollection/examples/itemcollection-sample-full.json b/fragments/itemcollection/examples/itemcollection-sample-full.json index a9aefbff..dad0c18b 100644 --- a/fragments/itemcollection/examples/itemcollection-sample-full.json +++ b/fragments/itemcollection/examples/itemcollection-sample-full.json @@ -1,6 +1,4 @@ { - "stac_version": "1.0.0", - "stac_extensions": [], "type": "FeatureCollection", "features": [ { diff --git a/fragments/itemcollection/examples/itemcollection-sample-minimal.json b/fragments/itemcollection/examples/itemcollection-sample-minimal.json index 63a5d5b5..8b3698fa 100644 --- a/fragments/itemcollection/examples/itemcollection-sample-minimal.json +++ b/fragments/itemcollection/examples/itemcollection-sample-minimal.json @@ -1,6 +1,4 @@ { - "stac_version": "1.0.0", - "stac_extensions": [], "type": "FeatureCollection", "features": [] } diff --git a/fragments/itemcollection/openapi.yaml b/fragments/itemcollection/openapi.yaml index 07347eca..6d0f92df 100644 --- a/fragments/itemcollection/openapi.yaml +++ b/fragments/itemcollection/openapi.yaml @@ -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: