22
33- [ STAC API - Sort Extension Specification] ( #stac-api---sort-extension-specification )
44 - [ Overview] ( #overview )
5- - [ HTTP GET (or POST Form) ] ( #http-get-or-post-form )
5+ - [ HTTP GET] ( #http-get )
66 - [ HTTP POST JSON Entity] ( #http-post-json-entity )
77
88## Overview
99
1010- ** Title:** Sort
1111- ** OpenAPI specification:** [ openapi.yaml] ( openapi.yaml )
1212- ** Conformance Classes:**
13- - ** STAC API - Item Search** binding: < https://api.stacspec.org/v1.0.0-rc.2 /item-search#sort >
14- - ** STAC API - Features** binding: < https://api.stacspec.org/v1.0.0-rc.2 /ogcapi-features#sort >
13+ - ** STAC API - Item Search** binding: < https://api.stacspec.org/v1.0.0/item-search#sort >
14+ - ** STAC API - Features** binding: < https://api.stacspec.org/v1.0.0/ogcapi-features#sort >
1515- ** Scope:** STAC API - Features, STAC API - Item Search
16- - ** [ Extension Maturity Classification] ( https://github.com/radiantearth/stac-api-spec/tree/main/README.md#maturity-classification ) :** Candidate
16+ - ** [ Extension Maturity Classification] ( https://github.com/radiantearth/stac-api-spec/tree/main/README.md#maturity-classification ) :** Stable
1717- ** Dependencies:**
18- - [ STAC API - Item Search] ( https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.2 /item-search )
19- - [ STAC API - Features] ( https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.2 /item-search )
18+ - [ STAC API - Item Search] ( https://github.com/radiantearth/stac-api-spec/tree/v1.0.0/item-search )
19+ - [ STAC API - Features] ( https://github.com/radiantearth/stac-api-spec/tree/v1.0.0/item-search )
2020- ** Owner** : @philvarner
2121
2222This specification defines a new parameter, ` sortby ` , that allows the user to define the fields by which
@@ -34,8 +34,8 @@ fields in Item Properties to be prefixed with `properties.` or not, or support u
3434name, e.g., ` properties.datetime ` or ` datetime ` .
3535
3636Sort behavior may be bound to either or both of
37- [ STAC API - Item Search] ( https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.2 /item-search ) (` /search ` endpoint) or
38- [ STAC API - Features] ( https://github.com/radiantearth/stac-api-spec/tree/v1.0.0-rc.2 /ogcapi-features )
37+ [ STAC API - Item Search] ( https://github.com/radiantearth/stac-api-spec/tree/v1.0.0/item-search ) (` /search ` endpoint) or
38+ [ STAC API - Features] ( https://github.com/radiantearth/stac-api-spec/tree/v1.0.0/ogcapi-features )
3939(` /collections/{collectionId}/items ` endpoint) by advertising the relevant conformance class.
4040
4141Fields may be sorted in ascending or descending order. The syntax between GET requests and POST requests with a JSON
@@ -46,12 +46,12 @@ the data in the order provided (e.g., first by `datetime`, then by `eo:cloud_cov
4646worked on as part of OGC API - Records, see [ this issue] ( https://github.com/opengeospatial/ogcapi-records/issues/22 )
4747for the latest discussion.*
4848
49- ## HTTP GET (or POST Form)
49+ ## HTTP GET
5050
51- When calling a relevant endpoint using GET (or POST with ` Content-Type: application/x-www-form-urlencoded ` or
52- ` Content-Type: multipart/form-data) ` , a single parameter ` sortby ` with a comma-separated list of item field names must
51+ When calling a relevant endpoint using GET, a single parameter ` sortby ` with a comma-separated list of item field names must
5352be provided. The field names may be prefixed with either "+" for ascending, or "-" for descending. If no sign is
54- provided before the field name, it will be assumed to be "+".
53+ provided before the field name, it will be assumed to be "+". Note that ` + ` is used commonly
54+ by URL encoding as a space, so some tools may require escaping this literal ` + ` with a URL encoding of ` %2B ` .
5555
5656Examples of ` sortby ` parameter:
5757
0 commit comments