feat: add filter / sort stac query parameters [GDD-3825]

Author: jverrydt

titiler/stacapi/dependencies.py

@@ -164,22 +164,22 @@ def STACSearchParams(
         Query(description="Spatial Filter."),
     ] = None,
     datetime: Annotated[Optional[str], Query(description="Temporal Filter.")] = None,
-    # sortby: Annotated[
-    #     Optional[str],
-    #     Query(
-    #         description="Column Sort the items by Column (ascending (default) or descending).",
-    #     ),
-    # ] = None,
-    # query: Annotated[
-    #     Optional[str], Query(description="CQL2 Filter", alias="filter")
-    # ] = None,
-    # filter_lang: Annotated[
-    #     Optional[Literal["cql2-text", "cql2-json"]],
-    #     Query(
-    #         description="CQL2 Language (cql2-text, cql2-json). Defaults to cql2-text.",
-    #         alias="filter-lang",
-    #     ),
-    # ] = None,
+    sortby: Annotated[
+        Optional[str],
+        Query(
+            description="Column Sort the items by Column (ascending (default) or descending).",
+        ),
+    ] = None,
+    query: Annotated[
+        Optional[str], Query(description="CQL2 Filter", alias="filter")
+    ] = None,
+    filter_lang: Annotated[
+        Optional[Literal["cql2-text", "cql2-json"]],
+        Query(
+            description="CQL2 Language (cql2-text, cql2-json). Defaults to cql2-text.",
+            alias="filter-lang",
+        ),
+    ] = None,
     limit: Annotated[
         Optional[int],
         Query(description="Limit the number of items per page search (default: 10)"),
@@ -195,9 +195,9 @@ def STACSearchParams(
         "ids": ids.split(",") if ids else None,
         "bbox": list(map(float, bbox.split(","))) if bbox else None,
         "datetime": datetime,
-        # "sortby": sortby,
-        # "filter": query,
-        # "filter-lang": filter_lang,
+        "sortby": sortby,
+        "filter": query,
+        "filter-lang": filter_lang,
         "limit": limit or 10,
         "max_items": max_items or 100,
     }

titiler/stacapi/factory.py

@@ -723,6 +723,8 @@ class OGCWMTSFactory(BaseTilerFactory):
 
     path_dependency: Callable[..., APIParams] = STACApiParams
 
+    search_dependency: Callable[..., Dict] = STACSearchParams
+
     # In this factory, `reader` should be a Mosaic Backend
     # https://developmentseed.org/cogeo-mosaic/advanced/backends/
     reader: Type[BaseBackend] = STACAPIBackend
@@ -803,9 +805,8 @@ def get_tile(  # noqa: C901
             ###########################################################
             # STAC Query parameter provided by the the render extension and QueryParameters
             ###########################################################
-            search_query: Dict[str, Any] = {
-                "collections": [layer["collection"]],
-            }
+            query_params = copy(layer.get("render")) or {}
+            query_params["collections"] = [layer["collection"]]
 
             if req_time:
                 start_datetime = python_datetime.datetime.strptime(
@@ -814,16 +815,20 @@ def get_tile(  # noqa: C901
                 ).replace(tzinfo=python_datetime.timezone.utc)
                 end_datetime = start_datetime + python_datetime.timedelta(days=1)
 
-                search_query[
+                query_params[
                     "datetime"
                 ] = f"{start_datetime.strftime('%Y-%m-%dT%H:%M:%SZ')}/{end_datetime.strftime('%Y-%m-%dT%H:%M:%SZ')}"
 
-            query_params = copy(layer.get("render")) or {}
             if "color_formula" in req:
                 query_params["color_formula"] = req["color_formula"]
             if "expression" in req:
                 query_params["expression"] = req["expression"]
 
+            search_query = get_dependency_params(
+                dependency=self.search_dependency,
+                query_params=query_params,
+            )
+
             layer_params = get_dependency_params(
                 dependency=self.layer_dependency,
                 query_params=query_params,