Merge pull request #564 from opengeospatial/cube-bbox-clarification

Clarify the definition of bbox for items and cube queries

core/standard/openapi/parameters/core/cube-bbox.yaml

@@ -0,0 +1,32 @@
+name: bbox
+in: query
+description: |-
+  Only features that have a geometry that intersects the bounding box are selected.
+  The bounding box is provided as four numbers:
+  * Lower left corner, coordinate axis 1
+  * Lower left corner, coordinate axis 2
+  * Upper right corner, coordinate axis 1
+  * Upper right corner, coordinate axis 2
+
+  For WGS 84 longitude/latitude the values are in most cases the sequence of
+  minimum longitude, minimum latitude, maximum longitude and maximum latitude.
+  However, in cases where the box spans the antimeridian the first value
+  (west-most box edge) is larger than the third value (east-most box edge).
+  If a feature has multiple spatial geometry properties, it is the decision of the
+  server whether only a single spatial geometry property is used to determine
+  the extent or all relevant geometries.
+required: true
+schema:
+  oneOf:
+    - items:
+        type: number
+      type: array
+      minItems: 4
+      maxItems: 4
+    - items:
+        type: number
+      type: array
+      minItems: 6
+      maxItems: 6
+style: form
+explode: false

core/standard/openapi/paths/queries/cube.yaml

@@ -7,7 +7,7 @@ get:
   operationId: GetDataForCube
   parameters:
     - $ref: ../../parameters/collections/collectionId.yaml
-    - $ref: ../../parameters/core/bbox.yaml
+    - $ref: ../../parameters/core/cube-bbox.yaml
     - $ref: ../../parameters/core/cube-z.yaml
     - $ref: https://beta.schemas.opengis.net/ogcapi/common/part2/0.1/collections/openapi/parameters/datetime.yaml
     - $ref: ../../parameters/core/parameter-name.yaml

core/standard/requirements/edr/query_type/item.adoc

@@ -26,7 +26,7 @@ a| **bbox**
 
 * <<req_core_rc-bbox-definition,definition>> 
 
-* <<req_core_rc-bbox-response,rules>>|String|**Yes** a| The coordinates are defined by a BBOX string. Only data that has a geometry that intersects the <<area-definition,area>> defined by the <<req_core_rc-bbox-definition,bbox>>
+* <<req_core_rc-bbox-response,rules>>|String|**No** a| The coordinates are defined by a BBOX string. Only data that has a geometry that intersects the <<area-definition,area>> defined by the <<req_core_rc-bbox-definition,bbox>>
 are selected.
 
 * Lower left corner, coordinate axis 1