Skip to content

Commit 604ade6

Browse files
philvarnerphilvarner
authoredApr 25, 2023
Merge pull request #424 from radiantearth/pv/1.0.0-release
release prep for 1.0.0
·
v1.0.0
2 parents a792baf + fb82c0f commit 604ade6

15 files changed

+327
-304
lines changed
 

‎CHANGELOG.md

+7-1
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,10 @@ All notable changes to this project will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## [v1.0.0] - 2023-04-24
9+
10+
None
11+
812
## [v1.0.0-rc.4] - 2023-04-13
913

1014
## Changed
@@ -266,7 +270,9 @@ service description must return a 400 Bad Request status code.
266270
See the [stac-spec CHANGELOG](https://github.com/radiantearth/stac-spec/blob/v0.9.0/CHANGELOG.md)
267271
for STAC API releases prior to or equal to version 0.9.0.
268272

269-
[Unreleased]: <https://github.com/radiantearth/stac-api-spec/compare/v1.0.0-rc.3...main>
273+
[Unreleased]: <https://github.com/radiantearth/stac-api-spec/compare/v1.0.0...main>
274+
[v1.0.0]: <https://github.com/radiantearth/stac-api-spec/tree/v1.0.0>
275+
[v1.0.0-rc.4]: <https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.4>
270276
[v1.0.0-rc.3]: <https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.3>
271277
[v1.0.0-rc.2]: <https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.2>
272278
[v1.0.0-rc.1]: <https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.1>

‎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) API specification"
1010
abstract: "An API to make geospatial assets openly searchable and crawlable."
11-
version: 1.0.0-rc.4
11+
version: v1.0.0
1212
year: 2023
13-
date-released: 2023-04-13
13+
date-released: 2023-04-24
1414
license: Apache-2.0
1515
url: https://stacspec.org
1616
repository: https://github.com/radiantearth/stac-api-spec

‎README.md

+4-3
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,8 @@
1515

1616
## Releases (stable)
1717

18-
- [v1.0.0-rc.4](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.4) (latest)
18+
- [v1.0.0](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0) (latest)
19+
- [v1.0.0-rc.4](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.4)
1920
- [v1.0.0-rc.3](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.3)
2021
- [v1.0.0-rc.2](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.2)
2122
- [v1.0.0-rc.1](https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.1)
@@ -59,13 +60,13 @@ to search STAC catalogs, where the features returned are STAC [Item](stac-spec/i
5960
that have common properties, links to their assets and geometries that represent the footprints of the geospatial assets.
6061

6162
The specification for STAC API is provided as files that follow the [OpenAPI](http://openapis.org/) 3.0 specification,
62-
rendered online into HTML at <https://api.stacspec.org/v1.0.0-rc.4>, in addition to human-readable documentation.
63+
rendered online into HTML at <https://api.stacspec.org/v1.0.0>, in addition to human-readable documentation.
6364

6465
## Stability Note
6566

6667
This specification has evolved over the past couple years, and is used in production in a variety of deployments. It is
6768
currently in a 'beta' state, with no major changes anticipated.
68-
As of v1.0.0-rc.4, we remain fully aligned with
69+
As of v1.0.0, we remain fully aligned with
6970
[OGC API - Features](http://docs.opengeospatial.org/is/17-069r3/17-069r3.html)
7071
Version 1.0, and we are working to stay aligned
7172
as the additional OGC API components mature. This may result in minor changes as things evolve. The STAC API

‎core/README.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -11,17 +11,17 @@
1111

1212
## Summary
1313

14-
- **OpenAPI specification:** [openapi.yaml](openapi.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-rc.4/core)),
14+
- **OpenAPI specification:** [openapi.yaml](openapi.yaml) ([rendered version](https://api.stacspec.org/v1.0.0/core)),
1515
- **Conformance URIs:**
16-
- <https://api.stacspec.org/v1.0.0-rc.4/core>
16+
- <https://api.stacspec.org/v1.0.0/core>
1717
- **[Maturity Classification](../README.md#maturity-classification):** Candidate
1818
- **Dependencies**: None
1919
and [commons.yaml](commons.yaml) is the OpenAPI version of the core [STAC spec](../stac-spec) JSON Schemas.
2020

2121
## Overview
2222

2323
All STAC API implementations must implement the *STAC API - Core* conformance class
24-
<https://api.stacspec.org/v1.0.0-rc.4/core>. This requires a server to return from a root endpoint a valid
24+
<https://api.stacspec.org/v1.0.0/core>. This requires a server to return from a root endpoint a valid
2525
[STAC Catalog](../stac-spec/catalog-spec/catalog-spec.md) "landing page" that also includes a `conformsTo`
2626
attribute with a string array value. Any API implementing this is considered a minimal, valid STAC API.
2727

@@ -149,7 +149,7 @@ different conformance classes and a different set of links.
149149
"description": "This Catalog aims to demonstrate a simple landing page",
150150
"type": "Catalog",
151151
"conformsTo" : [
152-
"https://api.stacspec.org/v1.0.0-rc.4/core"
152+
"https://api.stacspec.org/v1.0.0/core"
153153
],
154154
"links": [
155155
{

‎core/commons.yaml

+77-77
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ openapi: 3.0.3
22
info:
33
title: The SpatioTemporal Asset Catalog API - Commons
44
description: This is the OpenAPI version of the core STAC spec JSON Schemas.
5-
version: 1.0.0-rc.4
5+
version: v1.0.0
66
paths: {}
77
components:
88
responses:
@@ -11,7 +11,7 @@ components:
1111
content:
1212
application/json:
1313
schema:
14-
$ref: '#/components/schemas/exception'
14+
$ref: "#/components/schemas/exception"
1515
schemas:
1616
exception:
1717
type: object
@@ -48,9 +48,9 @@ components:
4848
- links
4949
properties:
5050
stac_version:
51-
$ref: '#/components/schemas/stac_version'
51+
$ref: "#/components/schemas/stac_version"
5252
stac_extensions:
53-
$ref: '#/components/schemas/stac_extensions'
53+
$ref: "#/components/schemas/stac_extensions"
5454
type:
5555
type: string
5656
enum:
@@ -62,7 +62,7 @@ components:
6262
description:
6363
type: string
6464
links:
65-
$ref: '#/components/schemas/links'
65+
$ref: "#/components/schemas/links"
6666
collection:
6767
type: object
6868
required:
@@ -75,9 +75,9 @@ components:
7575
- links
7676
properties:
7777
stac_version:
78-
$ref: '#/components/schemas/stac_version'
78+
$ref: "#/components/schemas/stac_version"
7979
stac_extensions:
80-
$ref: '#/components/schemas/stac_extensions'
80+
$ref: "#/components/schemas/stac_extensions"
8181
type:
8282
type: string
8383
enum:
@@ -102,13 +102,13 @@ components:
102102
items:
103103
type: string
104104
license:
105-
$ref: '#/components/schemas/license'
105+
$ref: "#/components/schemas/license"
106106
extent:
107-
$ref: '#/components/schemas/extent'
107+
$ref: "#/components/schemas/extent"
108108
providers:
109-
$ref: '#/components/schemas/providers'
109+
$ref: "#/components/schemas/providers"
110110
links:
111-
$ref: '#/components/schemas/links'
111+
$ref: "#/components/schemas/links"
112112
summaries:
113113
description: |-
114114
Summaries are either a unique set of all available values *or*
@@ -152,11 +152,11 @@ components:
152152
- type: string
153153
- type: number
154154
example:
155-
stac_version: '1.0.0'
155+
stac_version: "1.0.0"
156156
stac_extensions: []
157157
type: Collection
158158
id: Sentinel-2
159-
title: 'Sentinel-2 MSI: MultiSpectral Instrument, Level-1C'
159+
title: "Sentinel-2 MSI: MultiSpectral Instrument, Level-1C"
160160
description: |
161161
Sentinel-2 is a wide-swath, high-resolution, multi-spectral
162162
imaging mission...
@@ -173,7 +173,7 @@ components:
173173
roles:
174174
- producer
175175
- licensor
176-
url: 'https://sentinel.esa.int/web/sentinel/user-guides/sentinel-2-msi'
176+
url: "https://sentinel.esa.int/web/sentinel/user-guides/sentinel-2-msi"
177177
extent:
178178
spatial:
179179
bbox:
@@ -183,32 +183,32 @@ components:
183183
- 83
184184
temporal:
185185
interval:
186-
- - '2015-06-23T00:00:00Z'
187-
- '2019-07-10T13:44:56Z'
186+
- - "2015-06-23T00:00:00Z"
187+
- "2019-07-10T13:44:56Z"
188188
summaries:
189189
datetime:
190-
min: '2015-06-23T00:00:00Z'
191-
max: '2019-07-10T13:44:56Z'
192-
'sci:citation':
193-
- 'Copernicus Sentinel data [Year]'
194-
'eo:gsd':
190+
min: "2015-06-23T00:00:00Z"
191+
max: "2019-07-10T13:44:56Z"
192+
"sci:citation":
193+
- "Copernicus Sentinel data [Year]"
194+
"eo:gsd":
195195
- 10
196196
- 30
197197
- 60
198-
'platform':
198+
"platform":
199199
- sentinel-2a
200200
- sentinel-2b
201-
'constellation':
201+
"constellation":
202202
- sentinel-2
203-
'instruments':
203+
"instruments":
204204
- msi
205-
'view:off_nadir':
205+
"view:off_nadir":
206206
min: 0
207207
max: 100
208-
'view:sun_elevation':
208+
"view:sun_elevation":
209209
min: 6.78
210210
max: 89.9
211-
'eo:bands':
211+
"eo:bands":
212212
- - name: B1
213213
common_name: coastal
214214
center_wavelength: 4.439
@@ -244,13 +244,13 @@ components:
244244
center_wavelength: 2.2024
245245
links:
246246
- rel: self
247-
href: 'http://cool-sat.com/collections/Sentinel-2'
247+
href: "http://cool-sat.com/collections/Sentinel-2"
248248
type: application/json
249249
- rel: root
250-
href: 'http://cool-sat.com/collections'
250+
href: "http://cool-sat.com/collections"
251251
type: application/json
252252
- rel: license
253-
href: 'https://scihub.copernicus.eu/twiki/pub/SciHubWebPortal/TermsConditions/Sentinel_Data_Terms_and_Conditions.pdf'
253+
href: "https://scihub.copernicus.eu/twiki/pub/SciHubWebPortal/TermsConditions/Sentinel_Data_Terms_and_Conditions.pdf"
254254
title: Legal notice on the use of Copernicus Sentinel Data and Service Information
255255
type: application/pdf
256256
extent:
@@ -334,8 +334,8 @@ components:
334334
additional enum values.
335335
type: string
336336
enum:
337-
- 'http://www.opengis.net/def/crs/OGC/1.3/CRS84'
338-
default: 'http://www.opengis.net/def/crs/OGC/1.3/CRS84'
337+
- "http://www.opengis.net/def/crs/OGC/1.3/CRS84"
338+
default: "http://www.opengis.net/def/crs/OGC/1.3/CRS84"
339339
temporal:
340340
description: |-
341341
The temporal extent of the features in the collection.
@@ -369,7 +369,7 @@ components:
369369
format: date-time
370370
nullable: true
371371
example:
372-
- '2011-11-11T12:22:11Z'
372+
- "2011-11-11T12:22:11Z"
373373
- null
374374
trs:
375375
description: |-
@@ -380,12 +380,12 @@ components:
380380
additional enum values.
381381
type: string
382382
enum:
383-
- 'http://www.opengis.net/def/uom/ISO-8601/0/Gregorian'
384-
default: 'http://www.opengis.net/def/uom/ISO-8601/0/Gregorian'
383+
- "http://www.opengis.net/def/uom/ISO-8601/0/Gregorian"
384+
default: "http://www.opengis.net/def/uom/ISO-8601/0/Gregorian"
385385
links:
386386
type: array
387387
items:
388-
$ref: '#/components/schemas/link'
388+
$ref: "#/components/schemas/link"
389389
link:
390390
title: Link
391391
type: object
@@ -557,7 +557,7 @@ components:
557557
The searchable date and time of the assets, in UTC.
558558
It is formatted according to [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339#section-5.6).
559559
`null` is allowed, but requires `start_datetime` and `end_datetime` from common metadata to be set.
560-
example: '2018-02-12T00:00:00Z'
560+
example: "2018-02-12T00:00:00Z"
561561
stac_version:
562562
title: STAC version
563563
type: string
@@ -587,29 +587,29 @@ components:
587587
- assets
588588
properties:
589589
stac_version:
590-
$ref: '#/components/schemas/stac_version'
590+
$ref: "#/components/schemas/stac_version"
591591
stac_extensions:
592-
$ref: '#/components/schemas/stac_extensions'
592+
$ref: "#/components/schemas/stac_extensions"
593593
id:
594-
$ref: '#/components/schemas/itemId'
594+
$ref: "#/components/schemas/itemId"
595595
bbox:
596-
$ref: '#/components/schemas/bbox'
596+
$ref: "#/components/schemas/bbox"
597597
geometry:
598-
$ref: '#/components/schemas/geometryGeoJSON'
598+
$ref: "#/components/schemas/geometryGeoJSON"
599599
type:
600-
$ref: '#/components/schemas/itemType'
600+
$ref: "#/components/schemas/itemType"
601601
links:
602-
$ref: '#/components/schemas/links'
602+
$ref: "#/components/schemas/links"
603603
properties:
604-
$ref: '#/components/schemas/properties'
604+
$ref: "#/components/schemas/properties"
605605
assets:
606-
$ref: '#/components/schemas/assets'
606+
$ref: "#/components/schemas/assets"
607607
example:
608-
stac_version: '1.0.0'
608+
stac_version: "1.0.0"
609609
stac_extensions:
610-
- 'https://stac-extensions.github.io/eo/v1.0.0/schema.json'
611-
- 'https://stac-extensions.github.io/view/v1.0.0/schema.json'
612-
- 'https://example.com/cs-extension/1.0/schema.json'
610+
- "https://stac-extensions.github.io/eo/v1.0.0/schema.json"
611+
- "https://stac-extensions.github.io/view/v1.0.0/schema.json"
612+
- "https://example.com/cs-extension/1.0/schema.json"
613613
type: Feature
614614
id: CS3-20160503_132131_05
615615
bbox:
@@ -631,45 +631,45 @@ components:
631631
- - -122.308150179
632632
- 37.488035566
633633
properties:
634-
datetime: '2016-05-03T13:22:30.040Z'
634+
datetime: "2016-05-03T13:22:30.040Z"
635635
title: A CS3 item
636636
license: PDDL-1.0
637637
providers:
638638
- name: CoolSat
639639
roles:
640640
- producer
641641
- licensor
642-
url: 'https://cool-sat.com/'
643-
'view:sun_azimuth': 168.7
644-
'eo:cloud_cover': 0.12
645-
'view:off_nadir': 1.4
646-
'platform': coolsat2
647-
'instruments':
642+
url: "https://cool-sat.com/"
643+
"view:sun_azimuth": 168.7
644+
"eo:cloud_cover": 0.12
645+
"view:off_nadir": 1.4
646+
"platform": coolsat2
647+
"instruments":
648648
- cool_sensor_v1
649-
'eo:bands': []
650-
'view:sun_elevation': 33.4
651-
'eo:gsd': 0.512
649+
"eo:bands": []
650+
"view:sun_elevation": 33.4
651+
"eo:gsd": 0.512
652652
collection: CS3
653653
links:
654654
- rel: self
655-
href: 'http://cool-sat.com/collections/CS3/items/20160503_132130_04'
655+
href: "http://cool-sat.com/collections/CS3/items/20160503_132130_04"
656656
type: application/geo+json
657657
- rel: root
658-
href: 'http://cool-sat.com/collections'
658+
href: "http://cool-sat.com/collections"
659659
type: application/json
660660
- rel: parent
661-
href: 'http://cool-sat.com/collections/CS3'
661+
href: "http://cool-sat.com/collections/CS3"
662662
type: application/json
663663
- rel: collection
664-
href: 'http://cool-sat.com/collections/CS3'
664+
href: "http://cool-sat.com/collections/CS3"
665665
type: application/json
666666
assets:
667667
analytic:
668-
href: 'http://cool-sat.com/static-catalog/CS3/20160503_132130_04/analytic.tif'
668+
href: "http://cool-sat.com/static-catalog/CS3/20160503_132130_04/analytic.tif"
669669
title: 4-Band Analytic
670670
type: image/tiff; application=geotiff; profile=cloud-optimized
671671
thumbnail:
672-
href: 'http://cool-sat.com/static-catalog/CS3/20160503_132130_04/thumbnail.png'
672+
href: "http://cool-sat.com/static-catalog/CS3/20160503_132130_04/thumbnail.png"
673673
title: Thumbnail
674674
type: image/png
675675
itemId:
@@ -687,7 +687,7 @@ components:
687687
description: provides the core metadata fields plus extensions
688688
properties:
689689
datetime:
690-
$ref: '#/components/schemas/datetime'
690+
$ref: "#/components/schemas/datetime"
691691
additionalProperties:
692692
description: Any additional properties added in via Item specification or extensions.
693693
assets:
@@ -729,13 +729,13 @@ components:
729729
- thumbnail
730730
geometryGeoJSON:
731731
oneOf:
732-
- $ref: '#/components/schemas/pointGeoJSON'
733-
- $ref: '#/components/schemas/multipointGeoJSON'
734-
- $ref: '#/components/schemas/linestringGeoJSON'
735-
- $ref: '#/components/schemas/multilinestringGeoJSON'
736-
- $ref: '#/components/schemas/polygonGeoJSON'
737-
- $ref: '#/components/schemas/multipolygonGeoJSON'
738-
- $ref: '#/components/schemas/geometrycollectionGeoJSON'
732+
- $ref: "#/components/schemas/pointGeoJSON"
733+
- $ref: "#/components/schemas/multipointGeoJSON"
734+
- $ref: "#/components/schemas/linestringGeoJSON"
735+
- $ref: "#/components/schemas/multilinestringGeoJSON"
736+
- $ref: "#/components/schemas/polygonGeoJSON"
737+
- $ref: "#/components/schemas/multipolygonGeoJSON"
738+
- $ref: "#/components/schemas/geometrycollectionGeoJSON"
739739
geometrycollectionGeoJSON:
740740
type: object
741741
required:
@@ -749,7 +749,7 @@ components:
749749
geometries:
750750
type: array
751751
items:
752-
$ref: '#/components/schemas/geometryGeoJSON'
752+
$ref: "#/components/schemas/geometryGeoJSON"
753753
linestringGeoJSON:
754754
type: object
755755
required:
@@ -875,7 +875,7 @@ components:
875875
features:
876876
type: array
877877
items:
878-
$ref: '#/components/schemas/featureGeoJSON'
878+
$ref: "#/components/schemas/featureGeoJSON"
879879
featureGeoJSON:
880880
type: object
881881
required:
@@ -888,7 +888,7 @@ components:
888888
enum:
889889
- Feature
890890
geometry:
891-
$ref: '#/components/schemas/geometryGeoJSON'
891+
$ref: "#/components/schemas/geometryGeoJSON"
892892
properties:
893893
type: object
894894
nullable: true

‎core/openapi.yaml

+21-21
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,23 @@
11
openapi: 3.0.3
22
info:
33
title: STAC API - Core
4-
version: 1.0.0-rc.4
4+
version: v1.0.0
55
description: >-
66
This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Core
77
specification. Any service that implements this endpoint to allow discovery of
88
spatiotemporal assets can be considered a STAC API.
99
contact:
1010
name: STAC Specification
11-
url: 'http://stacspec.org'
11+
url: "http://stacspec.org"
1212
license:
1313
name: Apache License 2.0
14-
url: 'http://www.apache.org/licenses/LICENSE-2.0'
15-
x-conformance-classes: ['https://api.stacspec.org/v1.0.0-rc.4/core']
14+
url: "http://www.apache.org/licenses/LICENSE-2.0"
15+
x-conformance-classes: ["https://api.stacspec.org/v1.0.0/core"]
1616
tags:
1717
- name: Core
1818
description: essential characteristics of a STAC API
1919
paths:
20-
'/':
20+
"/":
2121
get:
2222
tags:
2323
- Core
@@ -36,18 +36,18 @@ paths:
3636
Extensions may add additional links with new relation types.
3737
operationId: getLandingPage
3838
responses:
39-
'200':
40-
$ref: '#/components/responses/LandingPage'
41-
'4XX':
42-
$ref: 'commons.yaml#/components/responses/Error'
43-
'5XX':
44-
$ref: 'commons.yaml#/components/responses/Error'
39+
"200":
40+
$ref: "#/components/responses/LandingPage"
41+
"4XX":
42+
$ref: "commons.yaml#/components/responses/Error"
43+
"5XX":
44+
$ref: "commons.yaml#/components/responses/Error"
4545
components:
4646
schemas:
4747
landingPage:
4848
allOf:
49-
- $ref: 'commons.yaml#/components/schemas/catalog'
50-
- $ref: 'commons.yaml#/components/schemas/conformanceClasses'
49+
- $ref: "commons.yaml#/components/schemas/catalog"
50+
- $ref: "commons.yaml#/components/schemas/conformanceClasses"
5151
responses:
5252
LandingPage:
5353
description: |-
@@ -56,33 +56,33 @@ components:
5656
content:
5757
application/json:
5858
schema:
59-
$ref: '#/components/schemas/landingPage'
59+
$ref: "#/components/schemas/landingPage"
6060
example:
6161
type: Catalog
62-
stac_version: '1.0.0'
62+
stac_version: "1.0.0"
6363
id: sentinel
6464
title: Copernicus Sentinel Imagery
6565
description: Catalog of Copernicus Sentinel 1 and 2 imagery.
6666
conformsTo:
67-
- 'https://api.stacspec.org/v1.0.0-rc.4/core'
67+
- "https://api.stacspec.org/v1.0.0/core"
6868
links:
69-
- href: 'http://data.example.org/'
69+
- href: "http://data.example.org/"
7070
rel: self
7171
type: application/json
7272
title: this document
73-
- href: 'http://data.example.org/api'
73+
- href: "http://data.example.org/api"
7474
rel: service-desc
7575
type: application/vnd.oai.openapi+json;version=3.0
7676
title: the API definition
77-
- href: 'http://data.example.org/api.html'
77+
- href: "http://data.example.org/api.html"
7878
rel: service-doc
7979
type: text/html
8080
title: the API documentation
81-
- href: 'http://data.example.org/catalogs/sentinel-1'
81+
- href: "http://data.example.org/catalogs/sentinel-1"
8282
rel: child
8383
type: application/json
8484
title: Sentinel 1 Catalog
85-
- href: 'http://data.example.org/catalogs/sentinel-2'
85+
- href: "http://data.example.org/catalogs/sentinel-2"
8686
rel: child
8787
type: application/json
8888
title: Sentinel 2 Catalog

‎fragments/itemcollection/openapi.yaml

+3-3
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ openapi: 3.0.3
22
info:
33
title: The SpatioTemporal Asset Catalog API - Item Collection
44
description: The specification for a set of items, e.g. returned by a search.
5-
version: 1.0.0-rc.4
5+
version: v1.0.0
66
paths: {}
77
components:
88
schemas:
@@ -21,14 +21,14 @@ components:
2121
features:
2222
type: array
2323
items:
24-
$ref: '../../core/commons.yaml#/components/schemas/item'
24+
$ref: "../../core/commons.yaml#/components/schemas/item"
2525
links:
2626
type: array
2727
description: >-
2828
An array of links. Can be used for pagination, e.g. by providing a link
2929
with the `next` relation type.
3030
items:
31-
$ref: '../../core/commons.yaml#/components/schemas/link'
31+
$ref: "../../core/commons.yaml#/components/schemas/link"
3232
example:
3333
- rel: next
3434
type: application/geo+json

‎item-search/README.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -19,17 +19,17 @@
1919

2020
## Summary
2121

22-
- **OpenAPI specification:** [openapi.yaml](openapi.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-rc.4/item-search))
22+
- **OpenAPI specification:** [openapi.yaml](openapi.yaml) ([rendered version](https://api.stacspec.org/v1.0.0/item-search))
2323
- **Conformance URIs:**
24-
- <https://api.stacspec.org/v1.0.0-rc.4/item-search>
24+
- <https://api.stacspec.org/v1.0.0/item-search>
2525
- **[Maturity Classification](../README.md#maturity-classification):** Candidate
2626
- **Dependencies**: [STAC API - Core](../core)
2727
- **Examples**: [examples.md](examples.md)
2828

2929
## Overview
3030

3131
The *STAC API - Item Search* specification defines the *STAC API - Item Search*
32-
conformance class (<https://api.stacspec.org/v1.0.0-rc.4/item-search>), which
32+
conformance class (<https://api.stacspec.org/v1.0.0/item-search>), which
3333
provides the ability to search for STAC [Item](../stac-spec/item-spec/README.md)
3434
objects across collections.
3535
It retrieves a group of Item objects that match the provided parameters, wrapped in an
@@ -275,8 +275,8 @@ the [overview](../overview.md#example-landing-page) document.
275275
"description": "This Catalog aims to demonstrate the a simple landing page",
276276
"type": "Catalog",
277277
"conformsTo" : [
278-
"https://api.stacspec.org/v1.0.0-rc.4/core",
279-
"https://api.stacspec.org/v1.0.0-rc.4/item-search"
278+
"https://api.stacspec.org/v1.0.0/core",
279+
"https://api.stacspec.org/v1.0.0/item-search"
280280
],
281281
"links": [
282282
{

‎item-search/openapi.yaml

+39-39
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,20 @@
11
openapi: 3.0.3
22
info:
33
title: STAC API - Item Search
4-
version: 1.0.0-rc.4
4+
version: v1.0.0
55
description: >-
66
This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Item Search
77
specification.
88
contact:
99
name: STAC Specification
10-
url: 'http://stacspec.org'
10+
url: "http://stacspec.org"
1111
license:
1212
name: Apache License 2.0
13-
url: 'http://www.apache.org/licenses/LICENSE-2.0'
13+
url: "http://www.apache.org/licenses/LICENSE-2.0"
1414
tags:
1515
- name: Item Search
1616
description: essential characteristics of a STAC API
17-
x-conformance-classes: ['https://api.stacspec.org/v1.0.0-rc.4/item-search']
17+
x-conformance-classes: ["https://api.stacspec.org/v1.0.0/item-search"]
1818
paths:
1919
/search:
2020
get:
@@ -33,26 +33,26 @@ paths:
3333
tags:
3434
- Item Search
3535
parameters:
36-
- $ref: '#/components/parameters/bbox'
37-
- $ref: '#/components/parameters/intersects'
38-
- $ref: '#/components/parameters/datetime'
39-
- $ref: '#/components/parameters/limit'
40-
- $ref: '#/components/parameters/ids'
41-
- $ref: '#/components/parameters/collectionsArray'
36+
- $ref: "#/components/parameters/bbox"
37+
- $ref: "#/components/parameters/intersects"
38+
- $ref: "#/components/parameters/datetime"
39+
- $ref: "#/components/parameters/limit"
40+
- $ref: "#/components/parameters/ids"
41+
- $ref: "#/components/parameters/collectionsArray"
4242
responses:
43-
'200':
43+
"200":
4444
description: A feature collection.
4545
content:
4646
application/geo+json:
4747
schema:
48-
$ref: '../fragments/itemcollection/openapi.yaml#/components/schemas/itemCollection'
48+
$ref: "../fragments/itemcollection/openapi.yaml#/components/schemas/itemCollection"
4949
text/html:
5050
schema:
5151
type: string
52-
'4XX':
53-
$ref: '../core/commons.yaml#/components/responses/Error'
54-
'5XX':
55-
$ref: '../core/commons.yaml#/components/responses/Error'
52+
"4XX":
53+
$ref: "../core/commons.yaml#/components/responses/Error"
54+
"5XX":
55+
$ref: "../core/commons.yaml#/components/responses/Error"
5656
post:
5757
summary: Search STAC items with full-featured filtering.
5858
operationId: postItemSearch
@@ -71,21 +71,21 @@ paths:
7171
content:
7272
application/json:
7373
schema:
74-
$ref: '#/components/schemas/searchBody'
74+
$ref: "#/components/schemas/searchBody"
7575
responses:
76-
'200':
76+
"200":
7777
description: A feature collection.
7878
content:
7979
application/geo+json:
8080
schema:
81-
$ref: '../fragments/itemcollection/openapi.yaml#/components/schemas/itemCollection'
81+
$ref: "../fragments/itemcollection/openapi.yaml#/components/schemas/itemCollection"
8282
text/html:
8383
schema:
8484
type: string
85-
'4XX':
86-
$ref: '../core/commons.yaml#/components/responses/Error'
87-
'5XX':
88-
$ref: '../core/commons.yaml#/components/responses/Error'
85+
"4XX":
86+
$ref: "../core/commons.yaml#/components/responses/Error"
87+
"5XX":
88+
$ref: "../core/commons.yaml#/components/responses/Error"
8989
components:
9090
parameters:
9191
ids:
@@ -95,7 +95,7 @@ components:
9595
Array of Item ids to return.
9696
required: false
9797
schema:
98-
$ref: '#/components/schemas/ids'
98+
$ref: "#/components/schemas/ids"
9999
explode: false
100100
collectionsArray:
101101
name: collections
@@ -105,7 +105,7 @@ components:
105105
Only Item objects in one of the provided collections will be searched
106106
required: false
107107
schema:
108-
$ref: '#/components/schemas/collectionsArray'
108+
$ref: "#/components/schemas/collectionsArray"
109109
explode: false
110110
datetime:
111111
name: datetime
@@ -205,20 +205,20 @@ components:
205205
a GeoJSON Geometry rather than a bbox.
206206
required: false
207207
schema:
208-
$ref: '../core/commons.yaml#/components/schemas/geometryGeoJSON'
208+
$ref: "../core/commons.yaml#/components/schemas/geometryGeoJSON"
209209
style: form
210210
explode: false
211211
schemas:
212212
searchBody:
213213
description: The search criteria
214214
type: object
215215
allOf:
216-
- $ref: '#/components/schemas/bboxFilter'
217-
- $ref: '#/components/schemas/datetimeFilter'
218-
- $ref: '#/components/schemas/intersectsFilter'
219-
- $ref: '#/components/schemas/collectionsFilter'
220-
- $ref: '#/components/schemas/idsFilter'
221-
- $ref: '#/components/schemas/limitFilter'
216+
- $ref: "#/components/schemas/bboxFilter"
217+
- $ref: "#/components/schemas/datetimeFilter"
218+
- $ref: "#/components/schemas/intersectsFilter"
219+
- $ref: "#/components/schemas/collectionsFilter"
220+
- $ref: "#/components/schemas/idsFilter"
221+
- $ref: "#/components/schemas/limitFilter"
222222
limit:
223223
type: integer
224224
minimum: 1
@@ -240,7 +240,7 @@ components:
240240
description: Only return items that intersect the provided bounding box.
241241
properties:
242242
bbox:
243-
$ref: '../core/commons.yaml#/components/schemas/bbox'
243+
$ref: "../core/commons.yaml#/components/schemas/bbox"
244244
collectionsArray:
245245
type: array
246246
description: |-
@@ -259,31 +259,31 @@ components:
259259
type: object
260260
properties:
261261
datetime:
262-
$ref: '#/components/schemas/datetime_interval'
262+
$ref: "#/components/schemas/datetime_interval"
263263
intersectsFilter:
264264
type: object
265265
description: Only returns items that intersect with the provided polygon.
266266
properties:
267267
intersects:
268-
$ref: '../core/commons.yaml#/components/schemas/geometryGeoJSON'
268+
$ref: "../core/commons.yaml#/components/schemas/geometryGeoJSON"
269269
limitFilter:
270270
type: object
271271
description: Only returns maximum number of results (page size)
272272
properties:
273273
limit:
274-
$ref: '#/components/schemas/limit'
274+
$ref: "#/components/schemas/limit"
275275
idsFilter:
276276
type: object
277277
description: Only returns items that match the array of given ids
278278
properties:
279279
ids:
280-
$ref: '#/components/schemas/ids'
280+
$ref: "#/components/schemas/ids"
281281
collectionsFilter:
282282
type: object
283283
description: Only returns the collections specified
284284
properties:
285285
collections:
286-
$ref: '#/components/schemas/collectionsArray'
286+
$ref: "#/components/schemas/collectionsArray"
287287
datetime_interval:
288288
type: string
289289
description: |-
@@ -302,4 +302,4 @@ components:
302302
If a feature has multiple temporal properties, it is the decision of the
303303
server whether only a single temporal property is used to determine
304304
the extent or all relevant temporal properties.
305-
example: '2018-02-12T00:00:00Z/2018-03-18T12:31:12Z'
305+
example: "2018-02-12T00:00:00Z/2018-03-18T12:31:12Z"

‎ogcapi-features/README.md

+12-12
Original file line numberDiff line numberDiff line change
@@ -26,11 +26,11 @@
2626
## Summary
2727

2828
- **OpenAPI specifications:**
29-
- [STAC API - Features](openapi-features.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-rc.4/ogcapi-features))
30-
- [STAC API - Collections](openapi-collections.yaml) ([rendered version](https://api.stacspec.org/v1.0.0-rc.4/collections))
29+
- [STAC API - Features](openapi-features.yaml) ([rendered version](https://api.stacspec.org/v1.0.0/ogcapi-features))
30+
- [STAC API - Collections](openapi-collections.yaml) ([rendered version](https://api.stacspec.org/v1.0.0/collections))
3131
- **Conformance Class URIs:**
32-
- <https://api.stacspec.org/v1.0.0-rc.4/ogcapi-features> - Features
33-
- <https://api.stacspec.org/v1.0.0-rc.4/collections> - Collections
32+
- <https://api.stacspec.org/v1.0.0/ogcapi-features> - Features
33+
- <https://api.stacspec.org/v1.0.0/collections> - Collections
3434
- **[Maturity Classification](../README.md#maturity-classification):** Candidate
3535
- **Dependencies**:
3636
- [STAC API - Core](../core)
@@ -51,19 +51,19 @@ entities. As these entities are also GeoJSON types, the GeoJSON conformance clas
5151

5252
While OAFeat defines a single conformance class for its endpoints, STAC API divides these behaviors into two
5353
conformance classes -- Collections and Features. The STAC API - Features
54-
(<https://api.stacspec.org/v1.0.0-rc.4/ogcapi-features>) conformance class includes and extends the behavior
55-
of OAFeat, while the STAC API - Collections (<https://api.stacspec.org/v1.0.0-rc.4/collections>) conformance
54+
(<https://api.stacspec.org/v1.0.0/ogcapi-features>) conformance class includes and extends the behavior
55+
of OAFeat, while the STAC API - Collections (<https://api.stacspec.org/v1.0.0/collections>) conformance
5656
class is the subset of Features that pertains only to Collections.
5757

5858
### STAC API - Features
5959

60-
The *STAC API - Features* (<https://api.stacspec.org/v1.0.0-rc.4/ogcapi-features>) conformance class
60+
The *STAC API - Features* (<https://api.stacspec.org/v1.0.0/ogcapi-features>) conformance class
6161
encompasses all of the behavior described in this specification, as
6262
derived from OAFeat.
6363

6464
### STAC API - Collections
6565

66-
The *STAC API - Collections* (<https://api.stacspec.org/v1.0.0-rc.4/collections>) conformance class
66+
The *STAC API - Collections* (<https://api.stacspec.org/v1.0.0/collections>) conformance class
6767
requires only the subset of the behavior of Features that relates to Collections.
6868

6969
This subset is:
@@ -77,7 +77,7 @@ without needing to implement the entire *STAC API - Features* conformance class.
7777

7878
### OGC API - Features - Part 1: Core
7979

80-
A STAC API implementation that conforms to *STAC API - Features* (<https://api.stacspec.org/v1.0.0-rc.4/ogcapi-features>)
80+
A STAC API implementation that conforms to *STAC API - Features* (<https://api.stacspec.org/v1.0.0/ogcapi-features>)
8181
also conforms to
8282
[OGC API - Features - Part 1 Requirements Class Core](http://docs.opengeospatial.org/is/17-069r3/17-069r3.html#rc_core)
8383
conformance class (<http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core>).
@@ -355,9 +355,9 @@ the [overview](../overview.md#example-landing-page) document.
355355
"description": "This Catalog aims to demonstrate the a simple landing page",
356356
"type": "Catalog",
357357
"conformsTo" : [
358-
"https://api.stacspec.org/v1.0.0-rc.4/core",
359-
"https://api.stacspec.org/v1.0.0-rc.4/ogcapi-features",
360-
"https://api.stacspec.org/v1.0.0-rc.4/collections",
358+
"https://api.stacspec.org/v1.0.0/core",
359+
"https://api.stacspec.org/v1.0.0/ogcapi-features",
360+
"https://api.stacspec.org/v1.0.0/collections",
361361
"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core",
362362
"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30",
363363
"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson"

‎ogcapi-features/openapi-collections.yaml

+38-38
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,24 @@
11
openapi: 3.0.3
22
info:
33
title: STAC API - Collections
4-
version: 1.0.0-rc.4
4+
version: v1.0.0
55
description: >-
66
This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Collections
77
specification. This is a subset of the STAC API - Features specification.
88
contact:
99
name: STAC Specification
10-
url: 'http://stacspec.org'
10+
url: "http://stacspec.org"
1111
license:
1212
name: Apache License 2.0
13-
url: 'http://www.apache.org/licenses/LICENSE-2.0'
14-
x-conformance-classes: ['https://api.stacspec.org/v1.0.0-rc.4/collections']
13+
url: "http://www.apache.org/licenses/LICENSE-2.0"
14+
x-conformance-classes: ["https://api.stacspec.org/v1.0.0/collections"]
1515
tags:
1616
- name: Core
1717
description: essential characteristics of a STAC API
1818
- name: Collections
1919
description: All endpoints related to STAC API - Collections
2020
paths:
21-
'/':
21+
"/":
2222
get:
2323
tags:
2424
- Core
@@ -27,7 +27,7 @@ paths:
2727
The landing page provides links to the sub-resources.
2828
operationId: getLandingPage
2929
responses:
30-
'200':
30+
"200":
3131
description: |-
3232
The landing page provides links to the API definition
3333
(link relations `service-desc` and `service-doc`),
@@ -38,40 +38,40 @@ paths:
3838
content:
3939
application/json:
4040
schema:
41-
$ref: '../core/openapi.yaml#/components/schemas/landingPage'
41+
$ref: "../core/openapi.yaml#/components/schemas/landingPage"
4242
example:
43-
stac_version: '1.0.0'
43+
stac_version: "1.0.0"
4444
type: Catalog
4545
id: sentinel
4646
title: Copernicus Sentinel Imagery
4747
description: Catalog of Copernicus Sentinel 1 and 2 imagery.
4848
conformsTo:
49-
- 'https://api.stacspec.org/v1.0.0-rc.4/core'
50-
- 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core'
51-
- 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30'
52-
- 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson'
49+
- "https://api.stacspec.org/v1.0.0/core"
50+
- "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core"
51+
- "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30"
52+
- "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson"
5353
links:
54-
- href: 'http://data.example.org/'
54+
- href: "http://data.example.org/"
5555
rel: self
5656
type: application/json
5757
title: this document
58-
- href: 'http://data.example.org/api'
58+
- href: "http://data.example.org/api"
5959
rel: service-desc
6060
type: application/vnd.oai.openapi+json;version=3.0
6161
title: the API definition
62-
- href: 'http://data.example.org/api.html'
62+
- href: "http://data.example.org/api.html"
6363
rel: service-doc
6464
type: text/html
6565
title: the API documentation
66-
- href: 'http://data.example.org/conformance'
66+
- href: "http://data.example.org/conformance"
6767
rel: conformance
6868
type: application/json
6969
title: OGC API conformance classes implemented by this server
70-
- href: 'http://data.example.org/collections'
70+
- href: "http://data.example.org/collections"
7171
rel: data
7272
type: application/json
7373
title: Information about the feature collections
74-
'/collections':
74+
"/collections":
7575
get:
7676
tags:
7777
- Collections
@@ -81,13 +81,13 @@ paths:
8181
Request may not return the full set of metadata per Feature Collection.
8282
operationId: getCollections
8383
responses:
84-
'200':
85-
$ref: '#/components/responses/Collections'
86-
'4XX':
87-
$ref: '../core/commons.yaml#/components/responses/Error'
88-
'5XX':
89-
$ref: '../core/commons.yaml#/components/responses/Error'
90-
'/collections/{collectionId}':
84+
"200":
85+
$ref: "#/components/responses/Collections"
86+
"4XX":
87+
$ref: "../core/commons.yaml#/components/responses/Error"
88+
"5XX":
89+
$ref: "../core/commons.yaml#/components/responses/Error"
90+
"/collections/{collectionId}":
9191
get:
9292
tags:
9393
- Collections
@@ -98,16 +98,16 @@ paths:
9898
Request this endpoint to get a full list of metadata for the Feature Collection.
9999
operationId: describeCollection
100100
parameters:
101-
- $ref: '#/components/parameters/collectionId'
101+
- $ref: "#/components/parameters/collectionId"
102102
responses:
103-
'200':
104-
$ref: '#/components/responses/Collection'
105-
'404':
106-
$ref: '#/components/responses/NotFound'
107-
'4XX':
108-
$ref: '../core/commons.yaml#/components/responses/Error'
109-
'5XX':
110-
$ref: '../core/commons.yaml#/components/responses/Error'
103+
"200":
104+
$ref: "#/components/responses/Collection"
105+
"404":
106+
$ref: "#/components/responses/NotFound"
107+
"4XX":
108+
$ref: "../core/commons.yaml#/components/responses/Error"
109+
"5XX":
110+
$ref: "../core/commons.yaml#/components/responses/Error"
111111
components:
112112
parameters:
113113
collectionId:
@@ -125,11 +125,11 @@ components:
125125
- collections
126126
properties:
127127
links:
128-
$ref: '../core/commons.yaml#/components/schemas/links'
128+
$ref: "../core/commons.yaml#/components/schemas/links"
129129
collections:
130130
type: array
131131
items:
132-
$ref: '../core/commons.yaml#/components/schemas/collection'
132+
$ref: "../core/commons.yaml#/components/schemas/collection"
133133
responses:
134134
Collections:
135135
description: |-
@@ -151,7 +151,7 @@ components:
151151
content:
152152
application/json:
153153
schema:
154-
$ref: '#/components/schemas/collections'
154+
$ref: "#/components/schemas/collections"
155155
Collection:
156156
description: |-
157157
Information about the feature collection with id `collectionId`.
@@ -169,7 +169,7 @@ components:
169169
content:
170170
application/json:
171171
schema:
172-
$ref: '../core/commons.yaml#/components/schemas/collection'
172+
$ref: "../core/commons.yaml#/components/schemas/collection"
173173
NotFound:
174174
description: |-
175175
The requested URI was not found.

‎ogcapi-features/openapi-features.yaml

+82-83
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,23 @@
11
openapi: 3.0.3
22
info:
33
title: STAC API - Features
4-
version: 1.0.0-rc.4
4+
version: v1.0.0
55
description: >-
66
This is an OpenAPI definition of the SpatioTemporal Asset Catalog API - Features
77
specification. This extends OGC API - Features - Part 1: Core.
88
contact:
99
name: STAC Specification
10-
url: 'http://stacspec.org'
10+
url: "http://stacspec.org"
1111
license:
1212
name: Apache License 2.0
13-
url: 'http://www.apache.org/licenses/LICENSE-2.0'
14-
x-conformance-classes:
15-
['https://api.stacspec.org/v1.0.0-rc.4/ogcapi-features']
13+
url: "http://www.apache.org/licenses/LICENSE-2.0"
14+
x-conformance-classes: ["https://api.stacspec.org/v1.0.0/ogcapi-features"]
1615
tags:
1716
- name: Features
1817
description: |-
1918
All endpoints related to OGC API - Features - Part 1: Core
2019
paths:
21-
'/':
20+
"/":
2221
get:
2322
tags:
2423
- Features
@@ -27,7 +26,7 @@ paths:
2726
The landing page provides links to the sub-resources.
2827
operationId: getLandingPage
2928
responses:
30-
'200':
29+
"200":
3130
description: |-
3231
The landing page provides links to the API definition
3332
(link relations `service-desc` and `service-doc`),
@@ -38,40 +37,40 @@ paths:
3837
content:
3938
application/json:
4039
schema:
41-
$ref: '../core/openapi.yaml#/components/schemas/landingPage'
40+
$ref: "../core/openapi.yaml#/components/schemas/landingPage"
4241
example:
43-
stac_version: '1.0.0'
42+
stac_version: "1.0.0"
4443
type: Catalog
4544
id: sentinel
4645
title: Copernicus Sentinel Imagery
4746
description: Catalog of Copernicus Sentinel 1 and 2 imagery.
4847
conformsTo:
49-
- 'https://api.stacspec.org/v1.0.0-rc.4/core'
50-
- 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core'
51-
- 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30'
52-
- 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson'
48+
- "https://api.stacspec.org/v1.0.0/core"
49+
- "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core"
50+
- "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30"
51+
- "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson"
5352
links:
54-
- href: 'http://data.example.org/'
53+
- href: "http://data.example.org/"
5554
rel: self
5655
type: application/json
5756
title: this document
58-
- href: 'http://data.example.org/api'
57+
- href: "http://data.example.org/api"
5958
rel: service-desc
6059
type: application/vnd.oai.openapi+json;version=3.0
6160
title: the API definition
62-
- href: 'http://data.example.org/api.html'
61+
- href: "http://data.example.org/api.html"
6362
rel: service-doc
6463
type: text/html
6564
title: the API documentation
66-
- href: 'http://data.example.org/conformance'
65+
- href: "http://data.example.org/conformance"
6766
rel: conformance
6867
type: application/json
6968
title: OGC API conformance classes implemented by this server
70-
- href: 'http://data.example.org/collections'
69+
- href: "http://data.example.org/collections"
7170
rel: data
7271
type: application/json
7372
title: Information about the feature collections
74-
'/conformance':
73+
"/conformance":
7574
get:
7675
tags:
7776
- Features
@@ -81,13 +80,13 @@ paths:
8180
server conforms to.
8281
operationId: getConformanceDeclaration
8382
responses:
84-
'200':
85-
$ref: '#/components/responses/ConformanceDeclaration'
86-
'4XX':
87-
$ref: '../core/commons.yaml#/components/responses/Error'
88-
'5XX':
89-
$ref: '../core/commons.yaml#/components/responses/Error'
90-
'/collections':
83+
"200":
84+
$ref: "#/components/responses/ConformanceDeclaration"
85+
"4XX":
86+
$ref: "../core/commons.yaml#/components/responses/Error"
87+
"5XX":
88+
$ref: "../core/commons.yaml#/components/responses/Error"
89+
"/collections":
9190
get:
9291
tags:
9392
- Features
@@ -97,13 +96,13 @@ paths:
9796
Request may not return the full set of metadata per Feature Collection.
9897
operationId: getCollections
9998
responses:
100-
'200':
101-
$ref: '#/components/responses/Collections'
102-
'4XX':
103-
$ref: '../core/commons.yaml#/components/responses/Error'
104-
'5XX':
105-
$ref: '../core/commons.yaml#/components/responses/Error'
106-
'/collections/{collectionId}':
99+
"200":
100+
$ref: "#/components/responses/Collections"
101+
"4XX":
102+
$ref: "../core/commons.yaml#/components/responses/Error"
103+
"5XX":
104+
$ref: "../core/commons.yaml#/components/responses/Error"
105+
"/collections/{collectionId}":
107106
get:
108107
tags:
109108
- Features
@@ -114,17 +113,17 @@ paths:
114113
Request this endpoint to get a full list of metadata for the Feature Collection.
115114
operationId: describeCollection
116115
parameters:
117-
- $ref: '#/components/parameters/collectionId'
116+
- $ref: "#/components/parameters/collectionId"
118117
responses:
119-
'200':
120-
$ref: '#/components/responses/Collection'
121-
'404':
122-
$ref: '#/components/responses/NotFound'
123-
'4XX':
124-
$ref: '../core/commons.yaml#/components/responses/Error'
125-
'5XX':
126-
$ref: '../core/commons.yaml#/components/responses/Error'
127-
'/collections/{collectionId}/items':
118+
"200":
119+
$ref: "#/components/responses/Collection"
120+
"404":
121+
$ref: "#/components/responses/NotFound"
122+
"4XX":
123+
$ref: "../core/commons.yaml#/components/responses/Error"
124+
"5XX":
125+
$ref: "../core/commons.yaml#/components/responses/Error"
126+
"/collections/{collectionId}/items":
128127
get:
129128
tags:
130129
- Features
@@ -137,20 +136,20 @@ paths:
137136
collection of features of a similar type, based on a common schema.
138137
operationId: getFeatures
139138
parameters:
140-
- $ref: '#/components/parameters/collectionId'
141-
- $ref: '#/components/parameters/limit'
142-
- $ref: '#/components/parameters/bbox'
143-
- $ref: '#/components/parameters/datetime'
139+
- $ref: "#/components/parameters/collectionId"
140+
- $ref: "#/components/parameters/limit"
141+
- $ref: "#/components/parameters/bbox"
142+
- $ref: "#/components/parameters/datetime"
144143
responses:
145-
'200':
146-
$ref: '#/components/responses/Features'
147-
'404':
148-
$ref: '#/components/responses/NotFound'
149-
'4XX':
150-
$ref: '../core/commons.yaml#/components/responses/Error'
151-
'5XX':
152-
$ref: '../core/commons.yaml#/components/responses/Error'
153-
'/collections/{collectionId}/items/{featureId}':
144+
"200":
145+
$ref: "#/components/responses/Features"
146+
"404":
147+
$ref: "#/components/responses/NotFound"
148+
"4XX":
149+
$ref: "../core/commons.yaml#/components/responses/Error"
150+
"5XX":
151+
$ref: "../core/commons.yaml#/components/responses/Error"
152+
"/collections/{collectionId}/items/{featureId}":
154153
get:
155154
tags:
156155
- Features
@@ -160,17 +159,17 @@ paths:
160159
with id `collectionId`.
161160
operationId: getFeature
162161
parameters:
163-
- $ref: '#/components/parameters/collectionId'
164-
- $ref: '#/components/parameters/featureId'
162+
- $ref: "#/components/parameters/collectionId"
163+
- $ref: "#/components/parameters/featureId"
165164
responses:
166-
'200':
167-
$ref: '#/components/responses/Feature'
168-
'404':
169-
$ref: '#/components/responses/NotFound'
170-
'4XX':
171-
$ref: '../core/commons.yaml#/components/responses/Error'
172-
'5XX':
173-
$ref: '../core/commons.yaml#/components/responses/Error'
165+
"200":
166+
$ref: "#/components/responses/Feature"
167+
"404":
168+
$ref: "#/components/responses/NotFound"
169+
"4XX":
170+
$ref: "../core/commons.yaml#/components/responses/Error"
171+
"5XX":
172+
$ref: "../core/commons.yaml#/components/responses/Error"
174173
components:
175174
parameters:
176175
bbox:
@@ -281,30 +280,30 @@ components:
281280
- collections
282281
properties:
283282
links:
284-
$ref: '../core/commons.yaml#/components/schemas/links'
283+
$ref: "../core/commons.yaml#/components/schemas/links"
285284
collections:
286285
type: array
287286
items:
288-
$ref: '../core/commons.yaml#/components/schemas/collection'
287+
$ref: "../core/commons.yaml#/components/schemas/collection"
289288
featureCollectionGeoJSON:
290289
allOf:
291-
- $ref: '../core/commons.yaml#/components/schemas/featureCollectionGeoJSON'
290+
- $ref: "../core/commons.yaml#/components/schemas/featureCollectionGeoJSON"
292291
- type: object
293292
required:
294293
- features
295294
properties:
296295
features:
297296
type: array
298297
items:
299-
$ref: '../core/commons.yaml#/components/schemas/item'
298+
$ref: "../core/commons.yaml#/components/schemas/item"
300299
links:
301-
$ref: '../core/commons.yaml#/components/schemas/links'
300+
$ref: "../core/commons.yaml#/components/schemas/links"
302301
timeStamp:
303-
$ref: '#/components/schemas/timeStamp'
302+
$ref: "#/components/schemas/timeStamp"
304303
numberMatched:
305-
$ref: '#/components/schemas/numberMatched'
304+
$ref: "#/components/schemas/numberMatched"
306305
numberReturned:
307-
$ref: '#/components/schemas/numberReturned'
306+
$ref: "#/components/schemas/numberReturned"
308307
numberMatched:
309308
description: |-
310309
The number of features of the feature type that match the selection
@@ -328,7 +327,7 @@ components:
328327
description: This property indicates the time and date when the response was generated.
329328
type: string
330329
format: date-time
331-
example: '2017-08-17T08:05:32Z'
330+
example: "2017-08-17T08:05:32Z"
332331
responses:
333332
ConformanceDeclaration:
334333
description: |-
@@ -341,12 +340,12 @@ components:
341340
content:
342341
application/json:
343342
schema:
344-
$ref: '../core/commons.yaml#/components/schemas/conformanceClasses'
343+
$ref: "../core/commons.yaml#/components/schemas/conformanceClasses"
345344
example:
346345
conformsTo:
347-
- 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core'
348-
- 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30'
349-
- 'http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson'
346+
- "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core"
347+
- "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30"
348+
- "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson"
350349
Collections:
351350
description: |-
352351
The feature collections shared by this API.
@@ -367,7 +366,7 @@ components:
367366
content:
368367
application/json:
369368
schema:
370-
$ref: '#/components/schemas/collections'
369+
$ref: "#/components/schemas/collections"
371370
Collection:
372371
description: |-
373372
Information about the feature collection with id `collectionId`.
@@ -385,7 +384,7 @@ components:
385384
content:
386385
application/json:
387386
schema:
388-
$ref: '../core/commons.yaml#/components/schemas/collection'
387+
$ref: "../core/commons.yaml#/components/schemas/collection"
389388
Features:
390389
description: |-
391390
The response is a document consisting of features in the collection.
@@ -410,15 +409,15 @@ components:
410409
content:
411410
application/geo+json:
412411
schema:
413-
$ref: '#/components/schemas/featureCollectionGeoJSON'
412+
$ref: "#/components/schemas/featureCollectionGeoJSON"
414413
Feature:
415414
description: |-
416415
fetch the feature with id `featureId` in the feature collection
417416
with id `collectionId`
418417
content:
419418
application/geo+json:
420419
schema:
421-
$ref: '../core/commons.yaml#/components/schemas/item'
420+
$ref: "../core/commons.yaml#/components/schemas/item"
422421
NotFound:
423422
description: |-
424423
The requested URI was not found.

‎overview.md

+13-13
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ point for the more powerful capabilities - it contains a list of URLs with link
2020
'relationships' (`rel`) and descriptions to indicate their functionality. Note that the [STAC Core specification](stac-spec) provides
2121
most of the content of API responses - the STAC API is primarily concerned with the return of STAC
2222
[Item](stac-spec/item-spec/README.md) and [Collection](stac-spec/collection-spec/README.md) objects via a
23-
web API. See the [rendered OpenAPI document](https://api.stacspec.org/v1.0.0-rc.4/core) for more details.
23+
web API. See the [rendered OpenAPI document](https://api.stacspec.org/v1.0.0/core) for more details.
2424

2525
There are then two major sets of functionality that build on the core, [Item Search](item-search) and [Collection and Features](ogcapi-features)
2626
, which are designed to be complementary, letting
@@ -33,7 +33,7 @@ located at a `/search` endpoint. It re-uses all of the OAFeat [query
3333
parameters](http://docs.opengeospatial.org/is/17-069r3/17-069r3.html#_items_) specified in their 'core', and adds a
3434
few more. It does not require a full implementation of OAFeat, but it is instead a simplified construct that can run a
3535
search across any group of STAC [`Item`](stac-spec/item-spec/README.md) objects. See the [rendered OpenAPI
36-
document](https://api.stacspec.org/v1.0.0-rc.4/item-search) for more details.
36+
document](https://api.stacspec.org/v1.0.0/item-search) for more details.
3737

3838
### Collections and Features
3939

@@ -50,7 +50,7 @@ Full compliance involves splitting STAC `Item` objects into
5050
individual `/collections/{collectionId}/items` endpoints that expose querying single collections, as OAFeat does
5151
not currently support cross-collection search. It also adds a few other requirements, which are highlighted in the
5252
[features description](ogcapi-features/), in order to help STAC implementors understand OAFeat without having to
53-
read the full specification from scratch. See the [rendered OpenAPI document](https://api.stacspec.org/v1.0.0-rc.4/ogcapi-features)
53+
read the full specification from scratch. See the [rendered OpenAPI document](https://api.stacspec.org/v1.0.0/ogcapi-features)
5454
for more details.
5555

5656
### Extensions & Fragments
@@ -116,12 +116,12 @@ conformance URIs serve up a rendered HTML version of the corresponding OpenAPI d
116116

117117
### Conformance Class Table
118118

119-
| **Name** | **Specified in** | **Conformance URI** | **Description** |
120-
| ---------------------- | ------------------------------------------- | ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- |
121-
| STAC API - Core | [Core](core) | <https://api.stacspec.org/v1.0.0-rc.4/core> | Specifies the STAC Landing page `/`, communicating conformance and available endpoints. |
122-
| STAC API - Item Search | [Item Search](item-search) | <https://api.stacspec.org/v1.0.0-rc.4/item-search> | Enables search of all STAC Item objects on the server, with the STAC `[/search](#stac-api-endpoints)` endpoint. |
123-
| STAC API - Features | [Collections and Features](ogcapi-features) | <https://api.stacspec.org/v1.0.0-rc.4/ogcapi-features> | Specifies the use of OGC API - Features to serve STAC Item and Collection objects |
124-
| STAC API - Collections | [Collections and Features](ogcapi-features) | <https://api.stacspec.org/v1.0.0-rc.4/collections> | Specifies the use of a subset of STAC API - Features to serve Collection objects |
119+
| **Name** | **Specified in** | **Conformance URI** | **Description** |
120+
| ---------------------- | ------------------------------------------- | ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
121+
| STAC API - Core | [Core](core) | <https://api.stacspec.org/v1.0.0/core> | Specifies the STAC Landing page `/`, communicating conformance and available endpoints. |
122+
| STAC API - Item Search | [Item Search](item-search) | <https://api.stacspec.org/v1.0.0/item-search> | Enables search of all STAC Item objects on the server, with the STAC `[/search](#stac-api-endpoints)` endpoint. |
123+
| STAC API - Features | [Collections and Features](ogcapi-features) | <https://api.stacspec.org/v1.0.0/ogcapi-features> | Specifies the use of OGC API - Features to serve STAC Item and Collection objects |
124+
| STAC API - Collections | [Collections and Features](ogcapi-features) | <https://api.stacspec.org/v1.0.0/collections> | Specifies the use of a subset of STAC API - Features to serve Collection objects |
125125

126126
Additional conformance classes can be specified by [STAC API Extensions](extensions.md).
127127

@@ -143,10 +143,10 @@ The Landing Page will at least have the following `conformsTo` and `links`:
143143
"description": "This Catalog aims to demonstrate the a simple landing page",
144144
"type": "Catalog",
145145
"conformsTo" : [
146-
"https://api.stacspec.org/v1.0.0-rc.4/core",
147-
"https://api.stacspec.org/v1.0.0-rc.4/collections",
148-
"https://api.stacspec.org/v1.0.0-rc.4/ogcapi-features",
149-
"https://api.stacspec.org/v1.0.0-rc.4/item-search",
146+
"https://api.stacspec.org/v1.0.0/core",
147+
"https://api.stacspec.org/v1.0.0/collections",
148+
"https://api.stacspec.org/v1.0.0/ogcapi-features",
149+
"https://api.stacspec.org/v1.0.0/item-search",
150150
"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core",
151151
"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30",
152152
"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson"

‎package-lock.json

+19-2
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎package.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "api-spec",
3-
"version": "1.0.0-rc.4",
3+
"version": "v1.0.0",
44
"description": "STAC API helpers to generate, serve and check the API spec.",
55
"repository": "https://github.com/radiantearth/stac-api-spec",
66
"license": "Apache-2.0",

0 commit comments

Comments
 (0)
Please sign in to comment.