Merge pull request #1324 from radiantearth/dev

Release v1.1.0

.gitignore

@@ -67,3 +67,4 @@ typings/
 
 # Folder created when CI puhlishes JSON Schemas
 schemas/
+.$STAC-UML.drawio.bkp

CHANGELOG.md

@@ -8,6 +8,19 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [Unreleased]
 
+## [v1.1.0] - 2024-09-10
+
+### Added
+
+- Add to best-practices mime types for COPC, Geoparquet, 3dTiles, pmtiles ([#1321](https://github.com/radiantearth/stac-spec/issues/1321))
+
+### Fixed
+
+- `item_assets` is not required
+- Better describe the Statistics Object ([#1318](https://github.com/radiantearth/stac-spec/issues/1318))
+- bands as entity in UML model
+- Editorial edits
+
 ## [v1.1.0-beta.1] - 2024-08-08
 
 ### Added
@@ -504,6 +517,7 @@ See the [milestone 0.4.0 in the issue tracker](https://github.com/radiantearth/s
 Thanks @hgs-msmith, @matthewhanson, @hgs-trutherford, @rouault, @joshfix, @alkamin, @hemphillda, @jeffnaus  and @fredliporace for contributing to the spec directly, and to [everyone](https://github.com/opengeospatial/wfs3hackathon/blob/master/notes/introductions.md#participants) who participated in the [Ft Collins sprint](https://github.com/radiantearth/community-sprints/tree/master/03072018-ft-collins-co) and brought great ideas.
 
 [Unreleased]: <https://github.com/radiantearth/stac-spec/compare/master...dev>
+[v1.1.0]: <https://github.com/radiantearth/stac-spec/compare/v1.1.0-beta.1...v1.1.0>
 [v1.1.0-beta.1]: <https://github.com/radiantearth/stac-spec/compare/v1.0.0..v1.1.0-beta.1>
 [v1.0.0]: <https://github.com/radiantearth/stac-spec/compare/v1.0.0-rc.4..v1.0.0>
 [v1.0.0-rc.4]: <https://github.com/radiantearth/stac-spec/compare/v1.0.0-rc.3..v1.0.0-rc.4>

CITATION.cff

@@ -8,9 +8,9 @@ preferred-citation:
   type: standard
   title: "SpatioTemporal Asset Catalog (STAC) specification"
   abstract: "Making geospatial assets openly searchable and crawlable."
-  version: 1.1.0-beta.1
+  version: 1.1.0
   year: 2024
-  date-released: 2024-08-08
+  date-released: 2024-09-10
   license: Apache-2.0
   url: https://stacspec.org
   repository: https://github.com/radiantearth/stac-spec

README.md

@@ -48,7 +48,7 @@ with additional web service endpoints and object attributes.
 ## Current version and branches
 
 The [master branch](https://github.com/radiantearth/stac-spec/tree/master) is the 'stable' 
-version of the spec. It is currently version **1.1.0-beta.1** of the specification. The STAC specification 
+version of the spec. It is currently version **1.1.0** of the specification. The STAC specification 
 follows [Semantic Versioning](https://semver.org/), so any breaking change will require the spec to 
 go to 2.0.0. 
 

best-practices.md

@@ -348,6 +348,10 @@ following table lists some of the most common ones you may encounter or use.
 | `application/geopackage+sqlite3`                           | [GeoPackage](https://www.geopackage.org/)                                                                                                                                                                                                 |
 | `application/x-hdf5`                                       | Hierarchical Data Format version 5                                                                                                                                                                                                        |
 | `application/x-hdf`                                        | Hierarchical Data Format versions 4 and earlier.                                                                                                                                                                                          |
+| `application/vnd.laszip+copc`                              | [COPC](https://copc.io/) Cloud optimized PointCloud                                                                                                                                                                                       |
+| `application/vnd.apache.parquet`                           | Apache [Geoparquet](https://geoparquet.org/)                                                                                                                                                                                              |
+| `application/3dtiles+json`                                 | [OGC 3D Tiles](https://www.ogc.org/standard/3dtiles/)                                                                                                                                                                                     |
+| `application/vnd.pmtiles`                                  | Protomaps [PMTiles](https://github.com/protomaps/PMTiles/blob/main/spec/v3/spec.md)                                                                                                                                                       |
 
 *Deprecation notice: GeoTiff previously used the media type `image/vnd.stac.geotiff` and
 Cloud Optimized GeoTiffs used `image/vnd.stac.geotiff; profile=cloud-optimized`.
@@ -619,7 +623,7 @@ After migrating to STAC 1.1 this is ideally provided as follows:
       "bands": [
         {
           "name": "r",
-          "eo:common_name": "red",
+          "eo:common_name": "red"
         },
         {
           "name": "g",

catalog-spec/json-schema/catalog.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schemas.stacspec.org/v1.1.0-beta.1/catalog-spec/json-schema/catalog.json",
+  "$id": "https://schemas.stacspec.org/v1.1.0/catalog-spec/json-schema/catalog.json",
   "title": "STAC Catalog Specification",
   "description": "This object represents Catalogs in a SpatioTemporal Asset Catalog.",
   "allOf": [
@@ -27,7 +27,7 @@
         "stac_version": {
           "title": "STAC version",
           "type": "string",
-          "const": "1.1.0-beta.1"
+          "const": "1.1.0"
         },
         "stac_extensions": {
           "title": "STAC extensions",

collection-spec/collection-spec.md

@@ -61,7 +61,7 @@ specified in [*OGC API - Features*](https://ogcapi.ogc.org/features/), but they
 | summaries       | Map<string, \[\*]\|[Range Object](#range-object)\|[JSON Schema Object](#json-schema-object)> | STRONGLY RECOMMENDED. A map of property summaries, either a set of values, a range of values or a [JSON Schema](https://json-schema.org).                                 |
 | links           | \[[Link Object](#links)]                                                                     | **REQUIRED.** A list of references to other documents.                                                                                                                    |
 | assets          | Map<string, [Asset Object](#assets)>                                                         | Dictionary of asset objects that can be downloaded, each with a unique key.                                                                                               |
-| item_assets     | Map<string, [Item Asset Definition Object](#item-asset-definition-object)>                   | **REQUIRED.** A dictionary of assets that can be found in member Items.                                                                                                   |
+| item_assets     | Map<string, [Item Asset Definition Object](#item-asset-definition-object)>                   | A dictionary of assets that can be found in member Items.                                                                                                                 |
 
 ### stac_version
 

collection-spec/json-schema/collection.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schemas.stacspec.org/v1.1.0-beta.1/collection-spec/json-schema/collection.json",
+  "$id": "https://schemas.stacspec.org/v1.1.0/collection-spec/json-schema/collection.json",
   "title": "STAC Collection Specification",
   "description": "This object represents Collections in a SpatioTemporal Asset Catalog.",
   "allOf": [
@@ -30,7 +30,7 @@
         "stac_version": {
           "title": "STAC version",
           "type": "string",
-          "const": "1.1.0-beta.1"
+          "const": "1.1.0"
         },
         "stac_extensions": {
           "title": "STAC extensions",

commons/common-metadata.md

@@ -223,7 +223,7 @@ and for WorldView-3 the Multispectral 20° off-nadir value of 1.38.
 | bands      | \[[Band Object](#band-object)] | An array of available bands where each object is a [Band Object](#band-object). |
 
 The `bands` array is used to describe the available bands in a STAC entity or Asset.
-This fields describes the general construct of a band or layer, which doesn't necessarily need to be a spectral band.
+This field describes the general construct of a band or layer, which doesn't necessarily need to be a spectral band.
 By adding fields from extensions you can indicate that a band, for example, is
 
 - a spectral band ([EO extension](https://github.com/stac-extensions/eo)),
@@ -290,6 +290,17 @@ It is STRONGLY RECOMMENDED to provide units in one of the following two formats:
 
 ### Statistics Object
 
+Statistics usually specify the range of values by providing the `minimum` and `maximum` values,
+but can optionally be accompanied by additional statistical values.
+Some additional statistical sizes are listed below,
+but the object can also be extended with other statistical sizes that are not listed below.
+For example, it could list additional coverages such as vegetation cover, land cover, etc.
+If statistics are provided in the Item Properties ([example](../examples/extended-item.json)),
+it is recommended to list the statistical sizes with a JSON Schema in the Collection Summaries
+to better describe the sizes ([example](../examples/collection.json)).
+Please note that some statistical sizes such as cloud cover have explicit fields in other extensions such as the EO extension.
+It is recommended to use the fields standardized in extensions in favor of providing them in the Statistics Object.
+
 | Field Name    | Type    | Description                                                                                                                            |
 | ------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------- |
 | minimum       | number  | minimum value of the values in the band. If not present, the minimum value of the given data type or negative infinity can be assumed. |

examples/catalog.json

@@ -2,7 +2,7 @@
   "id": "examples",
   "type": "Catalog",
   "title": "Example Catalog",
-  "stac_version": "1.1.0-beta.1",
+  "stac_version": "1.1.0",
   "description": "This catalog is a simple demonstration of an example catalog that is used to organize a hierarchy of collections and their items.",
   "links": [
     {
@@ -36,7 +36,7 @@
     },
     {
       "rel": "self",
-      "href": "https://raw.githubusercontent.com/radiantearth/stac-spec/v1.1.0-beta.1/examples/catalog.json",
+      "href": "https://raw.githubusercontent.com/radiantearth/stac-spec/v1.1.0/examples/catalog.json",
       "type": "application/json"
     }
   ]

examples/collection-only/collection-with-schemas.json

@@ -1,7 +1,7 @@
 {
-  "stac_version": "1.1.0-beta.1",
+  "stac_version": "1.1.0",
   "stac_extensions": [
-    "https://stac-extensions.github.io/eo/v2.0.0-beta.1/schema.json",
+    "https://stac-extensions.github.io/eo/v2.0.0/schema.json",
     "https://stac-extensions.github.io/sat/v1.0.0/schema.json",
     "https://stac-extensions.github.io/view/v1.0.0/schema.json"
   ],

examples/collection-only/collection.json

@@ -1,8 +1,8 @@
 {
   "type": "Collection",
-  "stac_version": "1.1.0-beta.1",
+  "stac_version": "1.1.0",
   "stac_extensions": [
-    "https://stac-extensions.github.io/eo/v2.0.0-beta.1/schema.json",
+    "https://stac-extensions.github.io/eo/v2.0.0/schema.json",
     "https://stac-extensions.github.io/projection/v2.0.0/schema.json",
     "https://stac-extensions.github.io/view/v1.0.0/schema.json"
   ],

examples/collection.json

@@ -2,11 +2,11 @@
   "id": "simple-collection",
   "type": "Collection",
   "stac_extensions": [
-    "https://stac-extensions.github.io/eo/v2.0.0-beta.1/schema.json",
+    "https://stac-extensions.github.io/eo/v2.0.0/schema.json",
     "https://stac-extensions.github.io/projection/v2.0.0/schema.json",
     "https://stac-extensions.github.io/view/v1.0.0/schema.json"
   ],
-  "stac_version": "1.1.0-beta.1",
+  "stac_version": "1.1.0",
   "description": "A simple collection demonstrating core catalog fields with links to a couple of items",
   "title": "Simple Example Collection",
   "keywords": [
@@ -80,6 +80,26 @@
     "view:sun_azimuth": {
       "minimum": 135.7,
       "maximum": 135.7
+    },
+    "statistics": {
+      "type": "object",
+      "properties": {
+        "vegetation": {
+          "description": "Percentage of pixels that are detected as vegetation, e.g. forests, grasslands, etc.",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "water": {
+          "description": "Percentage of pixels that are detected as water, e.g. rivers, oceans and ponds.",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "urban": {
+          "description": "Percentage of pixels that detected as urban, e.g. roads and buildings.",
+          "minimum": 0,
+          "maximum": 100
+        }
+      }
     }
   },
   "links": [
@@ -109,7 +129,7 @@
     },
     {
       "rel": "self",
-      "href": "https://raw.githubusercontent.com/radiantearth/stac-spec/v1.1.0-beta.1/examples/collection.json",
+      "href": "https://raw.githubusercontent.com/radiantearth/stac-spec/v1.1.0/examples/collection.json",
       "type": "application/json"
     }
   ]

examples/collectionless-item.json

@@ -1,5 +1,5 @@
 {
-  "stac_version": "1.1.0-beta.1",
+  "stac_version": "1.1.0",
   "stac_extensions": [
     "https://stac-extensions.github.io/view/v1.0.0/schema.json"
   ],

examples/core-item.json

@@ -1,5 +1,5 @@
 {
-  "stac_version": "1.1.0-beta.1",
+  "stac_version": "1.1.0",
   "stac_extensions": [],
   "type": "Feature",
   "id": "20201211_223832_CS2",

examples/extended-item.json

@@ -1,7 +1,7 @@
 {
-  "stac_version": "1.1.0-beta.1",
+  "stac_version": "1.1.0",
   "stac_extensions": [
-    "https://stac-extensions.github.io/eo/v2.0.0-beta.1/schema.json",
+    "https://stac-extensions.github.io/eo/v2.0.0/schema.json",
     "https://stac-extensions.github.io/projection/v2.0.0/schema.json",
     "https://stac-extensions.github.io/scientific/v1.0.0/schema.json",
     "https://stac-extensions.github.io/view/v1.0.0/schema.json",
@@ -59,6 +59,12 @@
     ],
     "gsd": 0.66,
     "eo:cloud_cover": 1.2,
+    "eo:snow_cover": 0,
+    "statistics": {
+      "vegetation": 12.57,
+      "water": 1.23,
+      "urban": 26.2
+    },
     "proj:code": "EPSG:32659",
     "proj:shape": [
       5558,
@@ -201,4 +207,4 @@
       "title": "Satellite Ephemeris Metadata"
     }
   }
-}
+}

examples/extensions-collection/collection.json

@@ -1,7 +1,7 @@
 {
   "id": "extensions-collection",
   "type": "Collection",
-  "stac_version": "1.1.0-beta.1",
+  "stac_version": "1.1.0",
   "description": "A heterogeneous collection containing deeper examples of various extensions",
   "links": [
     {

examples/extensions-collection/proj-example/proj-example.json

@@ -1,6 +1,6 @@
 {
   "type": "Feature",
-  "stac_version": "1.1.0-beta.1",
+  "stac_version": "1.1.0",
   "id": "proj-example",
   "properties": {
     "datetime": "2018-10-01T01:08:32.033000Z",
@@ -278,7 +278,7 @@
     60.63437
   ],
   "stac_extensions": [
-    "https://stac-extensions.github.io/eo/v2.0.0-beta.1/schema.json",
+    "https://stac-extensions.github.io/eo/v2.0.0/schema.json",
     "https://stac-extensions.github.io/projection/v2.0.0/schema.json"
   ],
   "collection": "landsat-8-l1"

examples/simple-item.json

@@ -1,5 +1,5 @@
 {
-  "stac_version": "1.1.0-beta.1",
+  "stac_version": "1.1.0",
   "stac_extensions": [],
   "type": "Feature",
   "id": "20201211_223832_CS2",

item-spec/json-schema/bands.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/bands.json",
+  "$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/bands.json",
   "title": "Bands Field",
   "type": "object",
   "properties": {

item-spec/json-schema/basics.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/basics.json",
+  "$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/basics.json",
   "title": "Basic Descriptive Fields",
   "type": "object",
   "properties": {

item-spec/json-schema/common.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/commonjson",
+  "$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/commonjson",
   "title": "STAC Common Metadata",
   "type": "object",
   "description": "This schema includes all common metadata fields.",

item-spec/json-schema/data-values.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/data-values.json#",
+  "$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/data-values.json#",
   "title": "Fields related to data values",
   "type": "object",
   "properties": {

item-spec/json-schema/datetime.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/datetime.json",
+  "$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/datetime.json",
   "title": "Date and Time Fields",
   "type": "object",
   "dependencies": {

item-spec/json-schema/instrument.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/instrument.json",
+  "$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/instrument.json",
   "title": "Instrument Fields",
   "type": "object",
   "properties": {

item-spec/json-schema/item.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/item.json",
+  "$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/item.json",
   "title": "STAC Item",
   "type": "object",
   "description": "This object represents the metadata for an item in a SpatioTemporal Asset Catalog.",
@@ -74,7 +74,7 @@
             "stac_version": {
               "title": "STAC version",
               "type": "string",
-              "const": "1.1.0-beta.1"
+              "const": "1.1.0"
             },
             "stac_extensions": {
               "title": "STAC extensions",

item-spec/json-schema/licensing.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/licensing.json",
+  "$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/licensing.json",
   "title": "Licensing Fields",
   "type": "object",
   "properties": {

item-spec/json-schema/provider.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/provider.json",
+  "$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/provider.json",
   "title": "Provider Fields",
   "type": "object",
   "properties": {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "stac-spec",
-  "version": "1.1.0-beta.1",
+  "version": "1.1.0",
   "description": "STAC spec helpers to check the spec.",
   "repository": "https://github.com/radiantearth/stac-spec",
   "license": "Apache-2.0",