Skip to content
This repository was archived by the owner on Jul 30, 2024. It is now read-only.

Commit 8a3490c

Browse files
m-mohrm-mohr
committed
clean-up, improve schema and example
1 parent 67150d6 commit 8a3490c

File tree

6 files changed

+56
-87
lines changed

6 files changed

+56
-87
lines changed

‎.github/pull_request_template.md‎

Lines changed: 0 additions & 13 deletions
This file was deleted.

‎.remarkignore‎

Lines changed: 0 additions & 1 deletion
This file was deleted.

‎CHANGELOG.md‎

Lines changed: 4 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
66

77
## [Unreleased]
88

9-
- Added clarification about how collection-level asset object properties do
10-
not remove the need for item-level asset object properties in the `item-assets` extension ([#880](https://github.com/radiantearth/stac-spec/pull/880))
11-
129
### Added
1310

1411
### Changed
@@ -19,11 +16,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
1916

2017
### Fixed
2118

22-
[Unreleased]: <https://github.com/stac-extensions/template/compare/v1.0.0...HEAD>
23-
24-
## [v1.0.0-beta.1] - 2020-05-29
19+
- Clarified that collection-level asset object properties do not remove the need for item-level asset object properties
20+
in the `item-assets` extension ([#880](https://github.com/radiantearth/stac-spec/pull/880))
21+
- Disallow `href` in JSON Schema
2522

26-
### Changed
27-
28-
- `asset` extension renamed to `item-assets` and renamed `assets` field in Collections to `item_assets`
29-
- `item-assets` extension only requires any two fields to be available, not the two specific fields `title` and `type`
23+
[Unreleased]: <https://github.com/stac-extensions/template/compare/v1.0.0...HEAD>

‎README.md‎

Lines changed: 5 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,14 @@
1-
# Item Assets Extension Specification
1+
# Item Assets Definition Extension Specification
22

3-
- **Title:** Item Assets
3+
- **Title:** Item Assets Definition
44
- **Identifier:** <https://stac-extensions.github.io/item-assets/v1.0.0/schema.json>
5-
- **Field Name Prefix:** n/a
5+
- **Field Name Prefix:** -
66
- **Scope:** Collection
77
- **Extension [Maturity Classification](https://github.com/radiantearth/stac-spec/tree/master/extensions/README.md#extension-maturity):** Proposal
88
- **Owner**: @matthewhanson
9+
- **History**: [Prior to March 2, 2021](https://github.com/radiantearth/stac-spec/commits/v1.0.0-rc.1/extensions/item-assets)
910

10-
This document explains the Item Assets Extension to the
11+
This document explains the Item Assets Definition Extension to the
1112
[SpatioTemporal Asset Catalog](https://github.com/radiantearth/stac-spec) (STAC) specification.
1213

1314
This extension serves two purposes:
@@ -60,8 +61,3 @@ serving time from the Collection-level.
6061

6162
At least two fields (e.g. `title` and `type`) are required to be provided, in order for it to adequately describe Item assets.
6263
The two fields must not necessarily be taken from the list above and may include any custom field.
63-
64-
## Implementations
65-
66-
- AWS Public Dataset catalogs, [landsat-8](http://landsat-stac.s3.amazonaws.com/landsat-8-l1/catalog.json)
67-
- and [sentinel-2](http://sentinel-stac.s3.amazonaws.com/sentinel-2-l1c/catalog.json) define an Asset definition at the Collection level.

‎examples/example-landsat8.json‎

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,18 @@
11
{
2-
"id": "landsat-8-l1",
2+
"stac_version": "1.0.0-rc.1",
3+
"stac_extensions": [
4+
"https://stac-extensions.github.io/item-assets/v1.0.0/schema.json",
5+
"eo"
6+
],
37
"type": "Collection",
8+
"id": "landsat-8-l1",
49
"title": "Landsat 8 L1",
510
"description": "Landsat 8 imagery radiometrically calibrated and orthorectified using ground points and Digital Elevation Model (DEM) data to correct relief displacement.",
611
"keywords": [
712
"landsat",
813
"earth observation",
914
"usgs"
1015
],
11-
"stac_version": "1.0.0-rc.1",
12-
"stac_extensions": [
13-
"https://stac-extensions.github.io/item-assets/v1.0.0/schema.json"
14-
],
1516
"extent": {
1617
"spatial": {
1718
"bbox": [

‎json-schema/schema.json‎

Lines changed: 41 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,60 +1,52 @@
11
{
22
"$schema": "http://json-schema.org/draft-07/schema#",
33
"$id": "https://stac-extensions.github.io/item-assets/v1.0.0/schema.json#",
4-
"title": "Item Assets Extension",
5-
"description": "STAC Item Assets Extension for STAC Collections.",
6-
"allOf": [
7-
{
8-
"$ref": "https://schemas.stacspec.org/v1.0.0-rc.1/collection-spec/json-schema/collection.json"
9-
},
10-
{
11-
"$ref": "#/definitions/item_assets"
12-
}
4+
"title": "Item Assets Definition Extension",
5+
"description": "STAC Item Assets Definition Extension for STAC Collections.",
6+
"type": "object",
7+
"required": [
8+
"stac_extensions",
9+
"type",
10+
"item_assets"
1311
],
14-
"definitions": {
15-
"item_assets": {
16-
"title": "Item Assets Definition",
17-
"type": "object",
18-
"required": [
19-
"stac_extensions",
20-
"item_assets"
21-
],
22-
"properties": {
23-
"stac_extensions": {
24-
"type": "array",
25-
"contains": {
26-
"const": "https://stac-extensions.github.io/item-assets/v1.0.0/schema.json"
27-
}
28-
},
29-
"item_assets": {
30-
"type": "object",
31-
"additionalProperties": {
32-
"$ref": "#/definitions/asset"
33-
}
34-
}
12+
"properties": {
13+
"stac_extensions": {
14+
"type": "array",
15+
"contains": {
16+
"const": "https://stac-extensions.github.io/item-assets/v1.0.0/schema.json"
3517
}
3618
},
37-
"asset": {
19+
"type": {
20+
"const": "Collection"
21+
},
22+
"item_assets": {
3823
"type": "object",
39-
"minProperties": 2,
40-
"properties": {
41-
"title": {
42-
"title": "Asset title",
43-
"type": "string"
44-
},
45-
"description": {
46-
"title": "Asset description",
47-
"type": "string"
48-
},
49-
"type": {
50-
"title": "Asset type",
51-
"type": "string"
52-
},
53-
"roles": {
54-
"title": "Asset roles",
55-
"type": "array",
56-
"items": {
24+
"additionalProperties": {
25+
"type": "object",
26+
"minProperties": 2,
27+
"properties": {
28+
"href": {
29+
"title": "Disallow href",
30+
"not": {}
31+
},
32+
"title": {
33+
"title": "Asset title",
34+
"type": "string"
35+
},
36+
"description": {
37+
"title": "Asset description",
38+
"type": "string"
39+
},
40+
"type": {
41+
"title": "Asset type",
5742
"type": "string"
43+
},
44+
"roles": {
45+
"title": "Asset roles",
46+
"type": "array",
47+
"items": {
48+
"type": "string"
49+
}
5850
}
5951
}
6052
}

0 commit comments

Comments
 (0)