Skip to content

Commit ec002bb

Browse files
m-mohrm-mohr
authored
Merge pull request #1324 from radiantearth/dev
Release v1.1.0
2 parents 2e6947d + faddb22 commit ec002bb

31 files changed

+188
-66
lines changed

‎.gitignore

+1
Original file line numberDiff line numberDiff line change
@@ -67,3 +67,4 @@ typings/
6767

6868
# Folder created when CI puhlishes JSON Schemas
6969
schemas/
70+
.$STAC-UML.drawio.bkp

‎CHANGELOG.md

+14
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,19 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
88

99
## [Unreleased]
1010

11+
## [v1.1.0] - 2024-09-10
12+
13+
### Added
14+
15+
- Add to best-practices mime types for COPC, Geoparquet, 3dTiles, pmtiles ([#1321](https://github.com/radiantearth/stac-spec/issues/1321))
16+
17+
### Fixed
18+
19+
- `item_assets` is not required
20+
- Better describe the Statistics Object ([#1318](https://github.com/radiantearth/stac-spec/issues/1318))
21+
- bands as entity in UML model
22+
- Editorial edits
23+
1124
## [v1.1.0-beta.1] - 2024-08-08
1225

1326
### Added
@@ -504,6 +517,7 @@ See the [milestone 0.4.0 in the issue tracker](https://github.com/radiantearth/s
504517
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.
505518

506519
[Unreleased]: <https://github.com/radiantearth/stac-spec/compare/master...dev>
520+
[v1.1.0]: <https://github.com/radiantearth/stac-spec/compare/v1.1.0-beta.1...v1.1.0>
507521
[v1.1.0-beta.1]: <https://github.com/radiantearth/stac-spec/compare/v1.0.0..v1.1.0-beta.1>
508522
[v1.0.0]: <https://github.com/radiantearth/stac-spec/compare/v1.0.0-rc.4..v1.0.0>
509523
[v1.0.0-rc.4]: <https://github.com/radiantearth/stac-spec/compare/v1.0.0-rc.3..v1.0.0-rc.4>

‎CITATION.cff

+2-2
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,9 @@ preferred-citation:
88
type: standard
99
title: "SpatioTemporal Asset Catalog (STAC) specification"
1010
abstract: "Making geospatial assets openly searchable and crawlable."
11-
version: 1.1.0-beta.1
11+
version: 1.1.0
1212
year: 2024
13-
date-released: 2024-08-08
13+
date-released: 2024-09-10
1414
license: Apache-2.0
1515
url: https://stacspec.org
1616
repository: https://github.com/radiantearth/stac-spec

‎README.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ with additional web service endpoints and object attributes.
4848
## Current version and branches
4949

5050
The [master branch](https://github.com/radiantearth/stac-spec/tree/master) is the 'stable'
51-
version of the spec. It is currently version **1.1.0-beta.1** of the specification. The STAC specification
51+
version of the spec. It is currently version **1.1.0** of the specification. The STAC specification
5252
follows [Semantic Versioning](https://semver.org/), so any breaking change will require the spec to
5353
go to 2.0.0.
5454

‎STAC-UML.drawio

+93-27
Large diffs are not rendered by default.

‎STAC-UML.pdf

-32 KB
Binary file not shown.

‎best-practices.md

+5-1
Original file line numberDiff line numberDiff line change
@@ -348,6 +348,10 @@ following table lists some of the most common ones you may encounter or use.
348348
| `application/geopackage+sqlite3` | [GeoPackage](https://www.geopackage.org/) |
349349
| `application/x-hdf5` | Hierarchical Data Format version 5 |
350350
| `application/x-hdf` | Hierarchical Data Format versions 4 and earlier. |
351+
| `application/vnd.laszip+copc` | [COPC](https://copc.io/) Cloud optimized PointCloud |
352+
| `application/vnd.apache.parquet` | Apache [Geoparquet](https://geoparquet.org/) |
353+
| `application/3dtiles+json` | [OGC 3D Tiles](https://www.ogc.org/standard/3dtiles/) |
354+
| `application/vnd.pmtiles` | Protomaps [PMTiles](https://github.com/protomaps/PMTiles/blob/main/spec/v3/spec.md) |
351355

352356
*Deprecation notice: GeoTiff previously used the media type `image/vnd.stac.geotiff` and
353357
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:
619623
"bands": [
620624
{
621625
"name": "r",
622-
"eo:common_name": "red",
626+
"eo:common_name": "red"
623627
},
624628
{
625629
"name": "g",

‎catalog-spec/json-schema/catalog.json

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"$schema": "http://json-schema.org/draft-07/schema#",
3-
"$id": "https://schemas.stacspec.org/v1.1.0-beta.1/catalog-spec/json-schema/catalog.json",
3+
"$id": "https://schemas.stacspec.org/v1.1.0/catalog-spec/json-schema/catalog.json",
44
"title": "STAC Catalog Specification",
55
"description": "This object represents Catalogs in a SpatioTemporal Asset Catalog.",
66
"allOf": [
@@ -27,7 +27,7 @@
2727
"stac_version": {
2828
"title": "STAC version",
2929
"type": "string",
30-
"const": "1.1.0-beta.1"
30+
"const": "1.1.0"
3131
},
3232
"stac_extensions": {
3333
"title": "STAC extensions",

‎collection-spec/collection-spec.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ specified in [*OGC API - Features*](https://ogcapi.ogc.org/features/), but they
6161
| 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). |
6262
| links | \[[Link Object](#links)] | **REQUIRED.** A list of references to other documents. |
6363
| assets | Map<string, [Asset Object](#assets)> | Dictionary of asset objects that can be downloaded, each with a unique key. |
64-
| item_assets | Map<string, [Item Asset Definition Object](#item-asset-definition-object)> | **REQUIRED.** A dictionary of assets that can be found in member Items. |
64+
| item_assets | Map<string, [Item Asset Definition Object](#item-asset-definition-object)> | A dictionary of assets that can be found in member Items. |
6565

6666
### stac_version
6767

‎collection-spec/json-schema/collection.json

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"$schema": "http://json-schema.org/draft-07/schema#",
3-
"$id": "https://schemas.stacspec.org/v1.1.0-beta.1/collection-spec/json-schema/collection.json",
3+
"$id": "https://schemas.stacspec.org/v1.1.0/collection-spec/json-schema/collection.json",
44
"title": "STAC Collection Specification",
55
"description": "This object represents Collections in a SpatioTemporal Asset Catalog.",
66
"allOf": [
@@ -30,7 +30,7 @@
3030
"stac_version": {
3131
"title": "STAC version",
3232
"type": "string",
33-
"const": "1.1.0-beta.1"
33+
"const": "1.1.0"
3434
},
3535
"stac_extensions": {
3636
"title": "STAC extensions",

‎commons/common-metadata.md

+12-1
Original file line numberDiff line numberDiff line change
@@ -223,7 +223,7 @@ and for WorldView-3 the Multispectral 20° off-nadir value of 1.38.
223223
| bands | \[[Band Object](#band-object)] | An array of available bands where each object is a [Band Object](#band-object). |
224224

225225
The `bands` array is used to describe the available bands in a STAC entity or Asset.
226-
This fields describes the general construct of a band or layer, which doesn't necessarily need to be a spectral band.
226+
This field describes the general construct of a band or layer, which doesn't necessarily need to be a spectral band.
227227
By adding fields from extensions you can indicate that a band, for example, is
228228

229229
- 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:
290290

291291
### Statistics Object
292292

293+
Statistics usually specify the range of values by providing the `minimum` and `maximum` values,
294+
but can optionally be accompanied by additional statistical values.
295+
Some additional statistical sizes are listed below,
296+
but the object can also be extended with other statistical sizes that are not listed below.
297+
For example, it could list additional coverages such as vegetation cover, land cover, etc.
298+
If statistics are provided in the Item Properties ([example](../examples/extended-item.json)),
299+
it is recommended to list the statistical sizes with a JSON Schema in the Collection Summaries
300+
to better describe the sizes ([example](../examples/collection.json)).
301+
Please note that some statistical sizes such as cloud cover have explicit fields in other extensions such as the EO extension.
302+
It is recommended to use the fields standardized in extensions in favor of providing them in the Statistics Object.
303+
293304
| Field Name | Type | Description |
294305
| ------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------- |
295306
| 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-2
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"id": "examples",
33
"type": "Catalog",
44
"title": "Example Catalog",
5-
"stac_version": "1.1.0-beta.1",
5+
"stac_version": "1.1.0",
66
"description": "This catalog is a simple demonstration of an example catalog that is used to organize a hierarchy of collections and their items.",
77
"links": [
88
{
@@ -36,7 +36,7 @@
3636
},
3737
{
3838
"rel": "self",
39-
"href": "https://raw.githubusercontent.com/radiantearth/stac-spec/v1.1.0-beta.1/examples/catalog.json",
39+
"href": "https://raw.githubusercontent.com/radiantearth/stac-spec/v1.1.0/examples/catalog.json",
4040
"type": "application/json"
4141
}
4242
]

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

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
2-
"stac_version": "1.1.0-beta.1",
2+
"stac_version": "1.1.0",
33
"stac_extensions": [
4-
"https://stac-extensions.github.io/eo/v2.0.0-beta.1/schema.json",
4+
"https://stac-extensions.github.io/eo/v2.0.0/schema.json",
55
"https://stac-extensions.github.io/sat/v1.0.0/schema.json",
66
"https://stac-extensions.github.io/view/v1.0.0/schema.json"
77
],

‎examples/collection-only/collection.json

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
{
22
"type": "Collection",
3-
"stac_version": "1.1.0-beta.1",
3+
"stac_version": "1.1.0",
44
"stac_extensions": [
5-
"https://stac-extensions.github.io/eo/v2.0.0-beta.1/schema.json",
5+
"https://stac-extensions.github.io/eo/v2.0.0/schema.json",
66
"https://stac-extensions.github.io/projection/v2.0.0/schema.json",
77
"https://stac-extensions.github.io/view/v1.0.0/schema.json"
88
],

‎examples/collection.json

+23-3
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22
"id": "simple-collection",
33
"type": "Collection",
44
"stac_extensions": [
5-
"https://stac-extensions.github.io/eo/v2.0.0-beta.1/schema.json",
5+
"https://stac-extensions.github.io/eo/v2.0.0/schema.json",
66
"https://stac-extensions.github.io/projection/v2.0.0/schema.json",
77
"https://stac-extensions.github.io/view/v1.0.0/schema.json"
88
],
9-
"stac_version": "1.1.0-beta.1",
9+
"stac_version": "1.1.0",
1010
"description": "A simple collection demonstrating core catalog fields with links to a couple of items",
1111
"title": "Simple Example Collection",
1212
"keywords": [
@@ -80,6 +80,26 @@
8080
"view:sun_azimuth": {
8181
"minimum": 135.7,
8282
"maximum": 135.7
83+
},
84+
"statistics": {
85+
"type": "object",
86+
"properties": {
87+
"vegetation": {
88+
"description": "Percentage of pixels that are detected as vegetation, e.g. forests, grasslands, etc.",
89+
"minimum": 0,
90+
"maximum": 100
91+
},
92+
"water": {
93+
"description": "Percentage of pixels that are detected as water, e.g. rivers, oceans and ponds.",
94+
"minimum": 0,
95+
"maximum": 100
96+
},
97+
"urban": {
98+
"description": "Percentage of pixels that detected as urban, e.g. roads and buildings.",
99+
"minimum": 0,
100+
"maximum": 100
101+
}
102+
}
83103
}
84104
},
85105
"links": [
@@ -109,7 +129,7 @@
109129
},
110130
{
111131
"rel": "self",
112-
"href": "https://raw.githubusercontent.com/radiantearth/stac-spec/v1.1.0-beta.1/examples/collection.json",
132+
"href": "https://raw.githubusercontent.com/radiantearth/stac-spec/v1.1.0/examples/collection.json",
113133
"type": "application/json"
114134
}
115135
]

‎examples/collectionless-item.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
2-
"stac_version": "1.1.0-beta.1",
2+
"stac_version": "1.1.0",
33
"stac_extensions": [
44
"https://stac-extensions.github.io/view/v1.0.0/schema.json"
55
],

‎examples/core-item.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
2-
"stac_version": "1.1.0-beta.1",
2+
"stac_version": "1.1.0",
33
"stac_extensions": [],
44
"type": "Feature",
55
"id": "20201211_223832_CS2",

‎examples/extended-item.json

+9-3
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
2-
"stac_version": "1.1.0-beta.1",
2+
"stac_version": "1.1.0",
33
"stac_extensions": [
4-
"https://stac-extensions.github.io/eo/v2.0.0-beta.1/schema.json",
4+
"https://stac-extensions.github.io/eo/v2.0.0/schema.json",
55
"https://stac-extensions.github.io/projection/v2.0.0/schema.json",
66
"https://stac-extensions.github.io/scientific/v1.0.0/schema.json",
77
"https://stac-extensions.github.io/view/v1.0.0/schema.json",
@@ -59,6 +59,12 @@
5959
],
6060
"gsd": 0.66,
6161
"eo:cloud_cover": 1.2,
62+
"eo:snow_cover": 0,
63+
"statistics": {
64+
"vegetation": 12.57,
65+
"water": 1.23,
66+
"urban": 26.2
67+
},
6268
"proj:code": "EPSG:32659",
6369
"proj:shape": [
6470
5558,
@@ -201,4 +207,4 @@
201207
"title": "Satellite Ephemeris Metadata"
202208
}
203209
}
204-
}
210+
}

‎examples/extensions-collection/collection.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"id": "extensions-collection",
33
"type": "Collection",
4-
"stac_version": "1.1.0-beta.1",
4+
"stac_version": "1.1.0",
55
"description": "A heterogeneous collection containing deeper examples of various extensions",
66
"links": [
77
{

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

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"type": "Feature",
3-
"stac_version": "1.1.0-beta.1",
3+
"stac_version": "1.1.0",
44
"id": "proj-example",
55
"properties": {
66
"datetime": "2018-10-01T01:08:32.033000Z",
@@ -278,7 +278,7 @@
278278
60.63437
279279
],
280280
"stac_extensions": [
281-
"https://stac-extensions.github.io/eo/v2.0.0-beta.1/schema.json",
281+
"https://stac-extensions.github.io/eo/v2.0.0/schema.json",
282282
"https://stac-extensions.github.io/projection/v2.0.0/schema.json"
283283
],
284284
"collection": "landsat-8-l1"

‎examples/simple-item.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
2-
"stac_version": "1.1.0-beta.1",
2+
"stac_version": "1.1.0",
33
"stac_extensions": [],
44
"type": "Feature",
55
"id": "20201211_223832_CS2",

‎item-spec/json-schema/bands.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"$schema": "http://json-schema.org/draft-07/schema#",
3-
"$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/bands.json",
3+
"$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/bands.json",
44
"title": "Bands Field",
55
"type": "object",
66
"properties": {

‎item-spec/json-schema/basics.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"$schema": "http://json-schema.org/draft-07/schema#",
3-
"$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/basics.json",
3+
"$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/basics.json",
44
"title": "Basic Descriptive Fields",
55
"type": "object",
66
"properties": {

‎item-spec/json-schema/common.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"$schema": "http://json-schema.org/draft-07/schema#",
3-
"$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/commonjson",
3+
"$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/commonjson",
44
"title": "STAC Common Metadata",
55
"type": "object",
66
"description": "This schema includes all common metadata fields.",

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

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"$schema": "http://json-schema.org/draft-07/schema#",
3-
"$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/data-values.json#",
3+
"$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/data-values.json#",
44
"title": "Fields related to data values",
55
"type": "object",
66
"properties": {

‎item-spec/json-schema/datetime.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"$schema": "http://json-schema.org/draft-07/schema#",
3-
"$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/datetime.json",
3+
"$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/datetime.json",
44
"title": "Date and Time Fields",
55
"type": "object",
66
"dependencies": {

‎item-spec/json-schema/instrument.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"$schema": "http://json-schema.org/draft-07/schema#",
3-
"$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/instrument.json",
3+
"$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/instrument.json",
44
"title": "Instrument Fields",
55
"type": "object",
66
"properties": {

‎item-spec/json-schema/item.json

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"$schema": "http://json-schema.org/draft-07/schema#",
3-
"$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/item.json",
3+
"$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/item.json",
44
"title": "STAC Item",
55
"type": "object",
66
"description": "This object represents the metadata for an item in a SpatioTemporal Asset Catalog.",
@@ -74,7 +74,7 @@
7474
"stac_version": {
7575
"title": "STAC version",
7676
"type": "string",
77-
"const": "1.1.0-beta.1"
77+
"const": "1.1.0"
7878
},
7979
"stac_extensions": {
8080
"title": "STAC extensions",

‎item-spec/json-schema/licensing.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"$schema": "http://json-schema.org/draft-07/schema#",
3-
"$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/licensing.json",
3+
"$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/licensing.json",
44
"title": "Licensing Fields",
55
"type": "object",
66
"properties": {

‎item-spec/json-schema/provider.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"$schema": "http://json-schema.org/draft-07/schema#",
3-
"$id": "https://schemas.stacspec.org/v1.1.0-beta.1/item-spec/json-schema/provider.json",
3+
"$id": "https://schemas.stacspec.org/v1.1.0/item-spec/json-schema/provider.json",
44
"title": "Provider Fields",
55
"type": "object",
66
"properties": {

‎package.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "stac-spec",
3-
"version": "1.1.0-beta.1",
3+
"version": "1.1.0",
44
"description": "STAC spec helpers to check the spec.",
55
"repository": "https://github.com/radiantearth/stac-spec",
66
"license": "Apache-2.0",

0 commit comments

Comments
 (0)