From 4e342d0d14193a2b4f8e4c727ed6ad6319f5168d Mon Sep 17 00:00:00 2001 From: Panagiotis Vretanos Date: Mon, 28 Oct 2024 01:55:11 -0400 Subject: [PATCH 1/4] Extend list of format codes. --- core/sections/clause_8_ogc-process-description.adoc | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/core/sections/clause_8_ogc-process-description.adoc b/core/sections/clause_8_ogc-process-description.adoc index 25468f09..ad4b9611 100644 --- a/core/sections/clause_8_ogc-process-description.adoc +++ b/core/sections/clause_8_ogc-process-description.adoc @@ -106,7 +106,7 @@ include::../recommendations/ogc-process-description/REC_format-key.adoc[] Processes that perform geo-spatial processing can be expected to have geometric and feature input types. In JSON, geometries, features and collections of feature are commonly encoded using https://datatracker.ietf.org/doc/html/rfc7946[GeoJSON]. Rather the requiring processes descriptions to embed or reference the full schemas for https://datatracker.ietf.org/doc/html/rfc7946[GeoJSON] geometries, features or feature collections, this Standard defines a common set of convenience tokens that can be used instead. -The <> defines a https://json-schema.org/draft/2020-12/json-schema-validation.html#rfc.section.7[set of values] for the `format` key. This Standard extends this list by defining the following additional key values for use specifically in OGC process descriptions for defining geometric, feature or feature collection inputs or outputs. +The <> defines a https://json-schema.org/draft/2020-12/json-schema-validation.html#rfc.section.7[set of values] for the `format` key. This Standard extends this list by defining the following additional key values for use specifically in OGC process descriptions. [[format-key-values]] .Additional values for the JSON schema format key for OGC Process Description @@ -118,6 +118,11 @@ The <> defines a https://json-sc |http://www.opengis.net/def/format/ogcapi-processes/0/geojson-feature |geojson-feature |Indicates that the object is an instance of a GeoJSON feature http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/featureGeoJSON.yaml[(featureGeoJSON.yaml)]. |http://www.opengis.net/def/format/ogcapi-processes/0/geojson-geometry |geojson-geometry |Indicates that the object is an instance of a GeoJSON geometry http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/geometryGeoJSON.yaml[(geometryGeoJSON.yaml)]. |http://www.opengis.net/def/format/ogcapi-processes/0/ogc-bbox |ogc-bbox |Indicates that the object is an instance of an OGC bounding box https://raw.githubusercontent.com/opengeospatial/ogcapi-processes/master/openapi/schemas/processes-core/bbox.yaml[(bbox.yaml)]. +|http://www.opengis.net/def/format/ogcapi-processes/0/epgc-code |epsg-code |Indicates that the value is a code from the https://epsg.io/[EPSG registry]. +|http://www.opengis.net/def/format/ogcapi-processes/0/wkt2-def |wkt2-def |Indicates that the string value is a https://docs.ogc.org/is/18-010r11/18-010r11.pdf[well-known text representation of a coordinate reference system]. +|http://www.opengis.net/def/format/ogcapi-processes/0/cql2-text-filter |cql2-text |Indicates that the string value is a filter expression encoded using the text representation of the https://docs.ogc.org/is/21-065r2/21-065r2.html[Common Query Language (CQL2)]. +|http://www.opengis.net/def/format/ogcapi-processes/0/cql2-json-filter |cql2-json |Indicates that the string value is a filter expression encoded using the JSON representation of the https://docs.ogc.org/is/21-065r2/21-065r2.html[Common Query Language (CQL2)]. +|http://www.opengis.net/def/format/ogcapi-processes/0/collection-id |collection-id |Indicates that the string value is a https://docs.ogc.org/DRAFTS/20-024.html#collection-description[collection identifier] (e.g. a feature collection identifier). |=== NOTE: This list of values has been submitted to the https://www.ogc.org/projects/groups/ogcnasc[OGC Naming Authority] for registration in their definition server. From de7f3a99ea9be1c5b1503bf331c5d138fd3ded08 Mon Sep 17 00:00:00 2001 From: Panagiotis Vretanos Date: Tue, 26 Nov 2024 18:02:27 -0500 Subject: [PATCH 2/4] Add more format values. --- core/sections/clause_8_ogc-process-description.adoc | 3 +++ 1 file changed, 3 insertions(+) diff --git a/core/sections/clause_8_ogc-process-description.adoc b/core/sections/clause_8_ogc-process-description.adoc index ad4b9611..baa32202 100644 --- a/core/sections/clause_8_ogc-process-description.adoc +++ b/core/sections/clause_8_ogc-process-description.adoc @@ -123,6 +123,9 @@ The <> defines a https://json-sc |http://www.opengis.net/def/format/ogcapi-processes/0/cql2-text-filter |cql2-text |Indicates that the string value is a filter expression encoded using the text representation of the https://docs.ogc.org/is/21-065r2/21-065r2.html[Common Query Language (CQL2)]. |http://www.opengis.net/def/format/ogcapi-processes/0/cql2-json-filter |cql2-json |Indicates that the string value is a filter expression encoded using the JSON representation of the https://docs.ogc.org/is/21-065r2/21-065r2.html[Common Query Language (CQL2)]. |http://www.opengis.net/def/format/ogcapi-processes/0/collection-id |collection-id |Indicates that the string value is a https://docs.ogc.org/DRAFTS/20-024.html#collection-description[collection identifier] (e.g. a feature collection identifier). +|http://www.opengis.net/def/format/ogcapi-processes/0/stac-collection |stac-collection |Indicates that the string value is a https://github.com/radiantearth/stac-spec/blob/master/collection-spec/collection-spec.md[STAC collection]. +|http://www.opengis.net/def/format/ogcapi-processes/0/ogc-feature-collection |ogc-feature-collection |Indicates that the string value is an https://docs.ogc.org/is/17-069r4/17-069r4.html#_collection_[OGC feature collection]. +|http://www.opengis.net/def/format/ogcapi-processes/0/ogc-coverage-collection |ogc-coverage-collection |Indicates that the string value is an https://docs.ogc.org/DRAFTS/19-087.html#_extended_collection_description_response_collectionscollectionid[OGC coverage collection]. |=== NOTE: This list of values has been submitted to the https://www.ogc.org/projects/groups/ogcnasc[OGC Naming Authority] for registration in their definition server. From e39fce37cf0e48810b43dc0545873a83dd59030d Mon Sep 17 00:00:00 2001 From: Panagiotis Vretanos Date: Sun, 5 Jan 2025 14:35:25 -0500 Subject: [PATCH 3/4] Add more format values. --- .../clause_8_ogc-process-description.adoc | 20 ++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/core/sections/clause_8_ogc-process-description.adoc b/core/sections/clause_8_ogc-process-description.adoc index baa32202..3f2cfbf4 100644 --- a/core/sections/clause_8_ogc-process-description.adoc +++ b/core/sections/clause_8_ogc-process-description.adoc @@ -113,19 +113,21 @@ The <> defines a https://json-sc [options="header"] |=== ^|Key value ^|Short code ^|Description - -|http://www.opengis.net/def/format/ogcapi-processes/0/geojson-feature-collection |geojson-feature-collection |Indicates that the object is an instance of a GeoJSON feature collection http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/featureCollectionGeoJSON.yaml[(featureCollectionGeoJSON.yaml)]. -|http://www.opengis.net/def/format/ogcapi-processes/0/geojson-feature |geojson-feature |Indicates that the object is an instance of a GeoJSON feature http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/featureGeoJSON.yaml[(featureGeoJSON.yaml)]. -|http://www.opengis.net/def/format/ogcapi-processes/0/geojson-geometry |geojson-geometry |Indicates that the object is an instance of a GeoJSON geometry http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/geometryGeoJSON.yaml[(geometryGeoJSON.yaml)]. -|http://www.opengis.net/def/format/ogcapi-processes/0/ogc-bbox |ogc-bbox |Indicates that the object is an instance of an OGC bounding box https://raw.githubusercontent.com/opengeospatial/ogcapi-processes/master/openapi/schemas/processes-core/bbox.yaml[(bbox.yaml)]. -|http://www.opengis.net/def/format/ogcapi-processes/0/epgc-code |epsg-code |Indicates that the value is a code from the https://epsg.io/[EPSG registry]. +|http://www.opengis.net/def/format/ogcapi-processes/0/geojson-feature-collection |geojson-feature-collection |Indicates that the value is an instance of a GeoJSON feature collection http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/featureCollectionGeoJSON.yaml[(featureCollectionGeoJSON.yaml)]. +|http://www.opengis.net/def/format/ogcapi-processes/0/geojson-feature |geojson-feature |Indicates that the value is an instance of a GeoJSON feature http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/featureGeoJSON.yaml[(featureGeoJSON.yaml)]. +|http://www.opengis.net/def/format/ogcapi-processes/0/geojson-geometry |geojson-geometry |Indicates that the value is an instance of a GeoJSON geometry http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/geometryGeoJSON.yaml[(geometryGeoJSON.yaml)]. +|http://www.opengis.net/def/format/ogcapi-processes/0/ogc-bbox |ogc-bbox |Indicates that the value is an instance of an OGC bounding box https://raw.githubusercontent.com/opengeospatial/ogcapi-processes/master/openapi/schemas/processes-core/bbox.yaml[(bbox.yaml)]. +|http://www.opengis.net/def/format/ogcapi-processes/0/epgc-code |epsg-code |Indicates that the string value is a code from the https://epsg.io/[EPSG registry]. |http://www.opengis.net/def/format/ogcapi-processes/0/wkt2-def |wkt2-def |Indicates that the string value is a https://docs.ogc.org/is/18-010r11/18-010r11.pdf[well-known text representation of a coordinate reference system]. |http://www.opengis.net/def/format/ogcapi-processes/0/cql2-text-filter |cql2-text |Indicates that the string value is a filter expression encoded using the text representation of the https://docs.ogc.org/is/21-065r2/21-065r2.html[Common Query Language (CQL2)]. |http://www.opengis.net/def/format/ogcapi-processes/0/cql2-json-filter |cql2-json |Indicates that the string value is a filter expression encoded using the JSON representation of the https://docs.ogc.org/is/21-065r2/21-065r2.html[Common Query Language (CQL2)]. |http://www.opengis.net/def/format/ogcapi-processes/0/collection-id |collection-id |Indicates that the string value is a https://docs.ogc.org/DRAFTS/20-024.html#collection-description[collection identifier] (e.g. a feature collection identifier). -|http://www.opengis.net/def/format/ogcapi-processes/0/stac-collection |stac-collection |Indicates that the string value is a https://github.com/radiantearth/stac-spec/blob/master/collection-spec/collection-spec.md[STAC collection]. -|http://www.opengis.net/def/format/ogcapi-processes/0/ogc-feature-collection |ogc-feature-collection |Indicates that the string value is an https://docs.ogc.org/is/17-069r4/17-069r4.html#_collection_[OGC feature collection]. -|http://www.opengis.net/def/format/ogcapi-processes/0/ogc-coverage-collection |ogc-coverage-collection |Indicates that the string value is an https://docs.ogc.org/DRAFTS/19-087.html#_extended_collection_description_response_collectionscollectionid[OGC coverage collection]. +|http://www.opengis.net/def/format/ogcapi-processes/0/stac-collection |stac-collection |Indicates that the value is an instance of a https://github.com/radiantearth/stac-spec/blob/master/collection-spec/collection-spec.md[STAC collection]. +|http://www.opengis.net/def/format/ogcapi-processes/0/stac-catalog |stac-catalog |Indicates that the value is an instance of a https://github.com/radiantearth/stac-spec/blob/master/catalog-spec/catalog-spec.md[STAC catalog]. +|http://www.opengis.net/def/format/ogcapi-processes/0/stac-itemCollection |stac-itemCollection |Indicates that the value is a https://github.com/radiantearth/stac-spec/blob/master/item-spec/item-spec.md[collection of STAC items]. +|http://www.opengis.net/def/format/ogcapi-processes/0/stac-itemCollection |stac-item |Indicates that the value is an instance of a https://github.com/radiantearth/stac-spec/blob/master/item-spec/item-spec.md[STAC item]. +|http://www.opengis.net/def/format/ogcapi-processes/0/ogc-feature-collection |ogc-feature-collection |Indicates that the value is an instance of an https://docs.ogc.org/is/17-069r4/17-069r4.html#_collection_[OGC feature collection]. +|http://www.opengis.net/def/format/ogcapi-processes/0/ogc-coverage-collection |ogc-coverage-collection |Indicates that the value is an instance of an https://docs.ogc.org/DRAFTS/19-087.html#_extended_collection_description_response_collectionscollectionid[OGC coverage collection]. |=== NOTE: This list of values has been submitted to the https://www.ogc.org/projects/groups/ogcnasc[OGC Naming Authority] for registration in their definition server. From f83addaec0b800526a03c1f7164959b964a3ec62 Mon Sep 17 00:00:00 2001 From: Panagiotis Vretanos Date: Sun, 5 Jan 2025 14:42:25 -0500 Subject: [PATCH 4/4] Fix typo. --- core/sections/clause_8_ogc-process-description.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/core/sections/clause_8_ogc-process-description.adoc b/core/sections/clause_8_ogc-process-description.adoc index 3f2cfbf4..5cc8ce8c 100644 --- a/core/sections/clause_8_ogc-process-description.adoc +++ b/core/sections/clause_8_ogc-process-description.adoc @@ -125,7 +125,7 @@ The <> defines a https://json-sc |http://www.opengis.net/def/format/ogcapi-processes/0/stac-collection |stac-collection |Indicates that the value is an instance of a https://github.com/radiantearth/stac-spec/blob/master/collection-spec/collection-spec.md[STAC collection]. |http://www.opengis.net/def/format/ogcapi-processes/0/stac-catalog |stac-catalog |Indicates that the value is an instance of a https://github.com/radiantearth/stac-spec/blob/master/catalog-spec/catalog-spec.md[STAC catalog]. |http://www.opengis.net/def/format/ogcapi-processes/0/stac-itemCollection |stac-itemCollection |Indicates that the value is a https://github.com/radiantearth/stac-spec/blob/master/item-spec/item-spec.md[collection of STAC items]. -|http://www.opengis.net/def/format/ogcapi-processes/0/stac-itemCollection |stac-item |Indicates that the value is an instance of a https://github.com/radiantearth/stac-spec/blob/master/item-spec/item-spec.md[STAC item]. +|http://www.opengis.net/def/format/ogcapi-processes/0/stac-item |stac-item |Indicates that the value is an instance of a https://github.com/radiantearth/stac-spec/blob/master/item-spec/item-spec.md[STAC item]. |http://www.opengis.net/def/format/ogcapi-processes/0/ogc-feature-collection |ogc-feature-collection |Indicates that the value is an instance of an https://docs.ogc.org/is/17-069r4/17-069r4.html#_collection_[OGC feature collection]. |http://www.opengis.net/def/format/ogcapi-processes/0/ogc-coverage-collection |ogc-coverage-collection |Indicates that the value is an instance of an https://docs.ogc.org/DRAFTS/19-087.html#_extended_collection_description_response_collectionscollectionid[OGC coverage collection]. |===