From 28579926d9e51dc227867d176976e1399b8f2f37 Mon Sep 17 00:00:00 2001
From: Even Rouault <even.rouault@spatialys.com>
Date: Wed, 25 Feb 2026 23:03:23 +0100
Subject: [PATCH] Document new layer metadata items for OGC API Features Part 3
 and 5

Documents:
- https://github.com/MapServer/MapServer/pull/7433
- https://github.com/MapServer/MapServer/pull/7436
- https://github.com/MapServer/MapServer/pull/7440
- https://github.com/MapServer/MapServer/pull/7443
---
 en/ogc/ogc_api.txt     | 78 ++++++++++++++++++++++++++++++++++++++++++
 en/ogc/ogc_support.txt |  7 +++-
 2 files changed, 84 insertions(+), 1 deletion(-)

diff --git a/en/ogc/ogc_api.txt b/en/ogc/ogc_api.txt
index 561ea763c1d..306a12fca23 100644
--- a/en/ogc/ogc_api.txt
+++ b/en/ogc/ogc_api.txt
@@ -200,6 +200,9 @@ for an OGC API server:**
   - ows_title
   - gml_include_items
   - gml_featureid
+  - oga_queryable_items
+  - oga_sortable_items
+  - oga_geometry_type
   
 - LAYER TEMPLATE "VOID"
 
@@ -304,6 +307,9 @@ Example OGC API Server Mapfile
         "gml_include_items" "all" #REQUIRED
         "gml_featureid"     "ne_id" #REQUIRED
         "oga_use_default_extent_for_getfeature" # Optional. Can improve performance.
+        "oga_queryable_items" "all"  # required to allow filtering
+        "oga_geometry_type" "Polygon"
+        "oga_sortable_items" "area"
       END
       TYPE POLYGON
       STATUS ON
@@ -532,3 +538,75 @@ Web Object Metadata
   the family of OGC API JSON Schema files are located. This must be a valid URL
   where the actual .yaml files are located if you want your OpenAPI description
   to be valid. Default is *http://schemas.opengis.net*
+
+.. index::
+   triple: OGCAPI; METADATA; oga_queryable_items
+
+**oga_queryable_items**
+
+  .. versionadded:: 8.8.0
+
+- *Description:* (Optional) Comma separated list of items that can be used for
+  filtering at the /items endpoint (either as <item>=<value> query parameters
+  and/or through the filter=<cql2-text>|<cql2-json> query parameter).
+  "all" can also be used as a special value to indicate that all items can be
+  queried. If not specified, no items are queryable.
+  The list of queryable items is returned at the /collections/{collid}/queryables
+  URL.
+
+- Example Mapfile:
+
+  .. code-block:: mapfile
+
+    LAYER
+      METADATA
+        "oga_queryable_items" "name,count"
+      END
+    END
+
+.. index::
+   triple: OGCAPI; METADATA; oga_sortable_items
+
+**oga_sortable_items**
+
+  .. versionadded:: 8.8.0
+
+- *Description:* (Optional) Comma separated list of items that can be used for
+  sorting at the /items endpoint (through the sortby=[+-]?item query parameter).
+  "all" can also be used as a special value to indicate that all items can be
+  used as sorting key. If not specified, no items can be used as sorting keys.
+  The list of queryable items is returned at the /collections/{collid}/sortables
+  URL.
+
+- Example Mapfile:
+
+  .. code-block:: mapfile
+
+    LAYER
+      METADATA
+        "oga_sortable_items" "name,count"
+      END
+    END
+
+.. index::
+   triple: OGCAPI; METADATA; oga_geometry_type
+
+**oga_geometry_type**
+
+  .. versionadded:: 8.8.0
+
+- *Description:* (Optional) Value among "geometry-point", "geometry-multipoint",
+  "geometry-linestring", "geometry-multilinestring", "geometry-polygon",
+  "geometry-multipolygon", "geometry-geometrycollection", "geometry-any" (default value),
+  "geometry-point-or-multipoint", "geometry-linestring-or-multilinestring" 
+  and "geometry-polygon-or-multipolygon"
+
+- Example Mapfile:
+
+  .. code-block:: mapfile
+
+    LAYER
+      METADATA
+        "oga_geometry_type" "geometry-polygon-or-multipolygon"
+      END
+    END
diff --git a/en/ogc/ogc_support.txt b/en/ogc/ogc_support.txt
index 7544ed40312..d219e512f81 100755
--- a/en/ogc/ogc_support.txt
+++ b/en/ogc/ogc_support.txt
@@ -19,4 +19,9 @@ MapServer  OGC Specification support
 * Observations and Measurements (OGC:OM) 1.0.0
 * SWE Common (OGC:SWE) 1.0.1
 * OWS Common (OGC:OWS) 1.0.0, 1.1.0, 2.0.0
-* OGC API: Features (OGCAPI:Features) 1.0.0
+* OGC API: Features (OGCAPI:Features) 1.0.0, server part
+   - Part 1: Core
+   - Part 2: CRS by Reference
+   - Part 3: Filtering (CQL2 Text and JSON)
+   - Part 5: Schemas (draft)
+   - Part 8: Sortables (draft)