7-data retrieval: Split multi-done retrieval into separate conformanc…

…e class
opengeospatial · Nov 10, 2022 · 06a4260 · 06a4260
1 parent 215fb11
commit 06a4260
Show file tree

Hide file tree

Showing 6 changed files with 29 additions and 5 deletions.
diff --git a/...EQ_data-retrieval_multi-zone-data-op.adoc → ...EQ_data-retrieval_multi-zone-data-op.adoc b/...EQ_data-retrieval_multi-zone-data-op.adoc → ...EQ_data-retrieval_multi-zone-data-op.adoc
diff --git a/...a-retrieval_multi-zone-data-response.adoc → ...a-retrieval_multi-zone-data-response.adoc b/...a-retrieval_multi-zone-data-response.adoc → ...a-retrieval_multi-zone-data-response.adoc
diff --git a/...ts/requirements_class_data_retrieval.adoc → ...ts/requirements_class_data-retrieval.adoc b/...ts/requirements_class_data_retrieval.adoc → ...ts/requirements_class_data-retrieval.adoc
@@ -2,7 +2,7 @@
 [requirements_class]
 ====
 [%metadata]
-label:: http://www.opengis.net/spec/ogcapi-dggs/0.0/req/data-retrieval
+label:: http://www.opengis.net/spec/ogcapi-dggs-1/0.0/req/data-retrieval
 subject:: DGGS Data Retrieval
 inherit:: link:http://www.opengis.net/spec/ogcapi-common-1/1.0/req/core[http://www.opengis.net/spec/ogcapi-common-1/1.0/req/core]
 ====
diff --git a/core/requirements/requirements_class_multi-zone-data-retrieval.adoc b/core/requirements/requirements_class_multi-zone-data-retrieval.adoc
@@ -0,0 +1,8 @@
+[[rc_multi-zone-data-retrieval]]
+[requirements_class]
+====
+[%metadata]
+label:: http://www.opengis.net/spec/ogcapi-dggs-1/0.0/req/multi-zone-data-retrieval
+subject:: DGGS Multi-Zone Data Retrieval
+inherit:: link:http://www.opengis.net/spec/ogcapi-common-1/1.0/req/core[http://www.opengis.net/spec/ogcapi-common-1/1.0/req/core]
+====
diff --git a/...ements/requirements_class_zone_query.adoc → ...ements/requirements_class_zone-query.adoc b/...ements/requirements_class_zone_query.adoc → ...ements/requirements_class_zone-query.adoc
diff --git a/core/sections/clause_7_dggs_data_retrieval.adoc b/core/sections/clause_7_dggs_data_retrieval.adoc
@@ -1,4 +1,4 @@
-== DGGS - Data Retrieval Conformance Class
+== DGGS - Data Retrieval Conformance Classes
 
 === Requirement Class DGGS - Data Retrieval
 
@@ -14,7 +14,7 @@ for a particular collection of geospatial data, for a dataset as a whole, or
 in connection with _OGC API - Processes - Part 3: Workflows & Chaining_, the output of
 a processing workflow.
 
-include::../requirements/requirements_class_data_retrieval.adoc[]
+include::../requirements/requirements_class_data-retrieval.adoc[]
 
 ==== Retrieve data from single zone
 
@@ -29,15 +29,31 @@ include::../requirements/data-retrieval/REQ_data-retrieval_single-zone-data-op.a
 
 include::../requirements/data-retrieval/REQ_data-retrieval_single-zone-data-response.adoc[]
 
+=== Requirement Class DGGS - Multi-Zone Data Retrieval
+
+The Multi-Zone Data Retrieval conformance class allows to retrieve data from a specific
+Discrete Global Grid System (DGGS) in a particular indexing scheme from a list of zones
+referenced by ID.
+It describes an HTTP GET operation, as well as its response.
+The selected DGGS is listed as available and described in the Core conformance class,
+and conforms to OGC Topic 21.
+The conformance makes use of URI templates for a variable representing the Zone ID.
+The data retrieved from a Web API using this conformance class can either be
+for a particular collection of geospatial data, for a dataset as a whole, or
+in connection with _OGC API - Processes - Part 3: Workflows & Chaining_, the output of
+a processing workflow.
+
+include::../requirements/requirements_class_multi-zone-data-retrieval.adoc[]
+
 ==== Retrieve data from multiple zones
 
 The following requirements describe how a client can retrieve data from a single DGGS zone
 at the resource path `.../dggs/{dggsId}/data?zones={zoneId},...`.
 
 ===== Operation
 
-include::../requirements/data-retrieval/REQ_data-retrieval_multi-zone-data-op.adoc[]
+include::../requirements/multi-zone-data-retrieval/REQ_data-retrieval_multi-zone-data-op.adoc[]
 
 ===== Response
 
-include::../requirements/data-retrieval/REQ_data-retrieval_multi-zone-data-response.adoc[]
+include::../requirements/multi-zone-data-retrieval/REQ_data-retrieval_multi-zone-data-response.adoc[]