Addressing Requirements class 2 (Requirements Class Tileset) of the OGC API Tiles Standard

pygeoapi/api.py

@@ -74,7 +74,8 @@
 from pygeoapi.provider.base import (
     ProviderGenericError, ProviderConnectionError, ProviderNotFoundError,
     ProviderTypeError)
-from pygeoapi.models.provider.base import TilesMetadataFormat
+from pygeoapi.models.provider.base import (TilesMetadataFormat,
+                                           TileMatrixSetEnum)
 
 from pygeoapi.models.cql import CQLModel
 from pygeoapi.util import (dategetter, RequestedProcessExecutionMode,
@@ -751,6 +752,16 @@ def landing_page(self,
             'type': FORMAT_TYPES[F_JSON],
             'title': 'Jobs',
             'href': f"{self.base_url}/jobs"
+        }, {
+            'rel': 'http://www.opengis.net/def/rel/ogc/1.0/tiling-schemes',
+            'type': FORMAT_TYPES[F_JSON],
+            'title': 'The list of supported tiling schemes (as JSON)',
+            'href': f"{self.base_url}/TileMatrixSets?f=json"
+        }, {
+            'rel': 'http://www.opengis.net/def/rel/ogc/1.0/tiling-schemes',
+            'type': FORMAT_TYPES[F_HTML],
+            'title': 'The list of supported tiling schemes (as HTML)',
+            'href': f"{self.base_url}/TileMatrixSets?f=html"
         }]
 
         headers = request.get_response_headers(**self.api_headers)
@@ -858,6 +869,121 @@ def conformance(self,
 
         return headers, HTTPStatus.OK, to_json(conformance, self.pretty_print)
 
+    @gzip
+    @pre_process
+    def tilematrixsets(self,
+                       request: Union[APIRequest, Any]) -> Tuple[dict, int,
+                                                                 str]:
+        """
+        Provide tileMatrixSets definition
+
+        :param request: A request object
+
+        :returns: tuple of headers, status code, content
+        """
+
+        if not request.is_valid():
+            return self.get_format_exception(request)
+
+        headers = request.get_response_headers(**self.api_headers)
+
+        # Retrieve available TileMatrixSets
+        enums = [e.value for e in TileMatrixSetEnum]
+
+        tms = {"tileMatrixSets": []}
+
+        for e in enums:
+            tms['tileMatrixSets'].append({
+                "title": e.title,
+                "id": e.tileMatrixSet,
+                "uri": e.tileMatrixSetURI,
+                "links": [
+                    {
+                       "rel": "self",
+                       "type": "text/html",
+                       "title": f"The HTML representation of the {e.tileMatrixSet} tile matrix set", # noqa
+                       "href": f"{self.base_url}/TileMatrixSets/{e.tileMatrixSet}?f=html" # noqa
+                    },
+                    {
+                       "rel": "self",
+                       "type": "application/json",
+                       "title": f"The JSON representation of the {e.tileMatrixSet} tile matrix set", # noqa
+                       "href": f"{self.base_url}/TileMatrixSets/{e.tileMatrixSet}?f=json" # noqa
+                    }
+                ]
+            })
+
+        tms['links'] = [{
+            "rel": "alternate",
+            "type": "text/html",
+            "title": "This document as HTML",
+            "href": f"{self.base_url}/tileMatrixSets?f=html"
+        }, {
+            "rel": "self",
+            "type": "application/json",
+            "title": "This document",
+            "href": f"{self.base_url}/tileMatrixSets?f=json"
+        }]
+
+        if request.format == F_HTML:  # render
+            content = render_j2_template(self.tpl_config,
+                                         'tilematrixsets/index.html',
+                                         tms, request.locale)
+            return headers, HTTPStatus.OK, content
+
+        return headers, HTTPStatus.OK, to_json(tms, self.pretty_print)
+
+    @gzip
+    @pre_process
+    def tilematrixset(self,
+                      request: Union[APIRequest, Any]) -> Tuple[dict,
+                                                                int, str]:
+        """
+        Provide tile matrix definition
+
+        :param request: A request object
+
+        :returns: tuple of headers, status code, content
+        """
+
+        if not request.is_valid():
+            return self.get_format_exception(request)
+
+        headers = request.get_response_headers(**self.api_headers)
+
+        # Retrieve relevant TileMatrixSet
+        enums = [e.value for e in TileMatrixSetEnum]
+        enum = None
+
+        try:
+            for e in enums:
+                if request.path_info.__contains__(e.tileMatrixSet):
+                    enum = e
+            if not enum:
+                raise ValueError('could not find this tilematrixset')
+        except ValueError as err:
+            return self.get_exception(
+                HTTPStatus.BAD_REQUEST, headers, request.format,
+                'InvalidParameterValue', str(err))
+
+        tms = {
+            "title": enum.tileMatrixSet,
+            "crs": enum.crs,
+            "id": enum.tileMatrixSet,
+            "uri": enum.tileMatrixSetURI,
+            "orderedAxes": enum.orderedAxes,
+            "wellKnownScaleSet": enum.wellKnownScaleSet,
+            "tileMatrices": enum.tileMatrices
+        }
+
+        if request.format == F_HTML:  # render
+            content = render_j2_template(self.tpl_config,
+                                         'tilematrixsets/tilematrixset.html',
+                                         tms, request.locale)
+            return headers, HTTPStatus.OK, content
+
+        return headers, HTTPStatus.OK, to_json(tms, self.pretty_print)
+
     @gzip
     @pre_process
     @jsonldify
@@ -2665,7 +2791,12 @@ def get_collection_tiles(self, request: Union[APIRequest, Any],
                 'dataType': 'vector',
                 'links': []
             }
-            tile_matrix['links'].append(matrix.tileMatrixSetDefinition)
+            tile_matrix['links'].append({
+                'type': FORMAT_TYPES[F_JSON],
+                'rel': 'http://www.opengis.net/def/rel/ogc/1.0/tiling-scheme',
+                'title': f'{matrix.tileMatrixSet} TileMatrixSet definition (as {F_JSON})', # noqa
+                'href': f'{self.base_url}/TileMatrixSets/{matrix.tileMatrixSet}?f={F_JSON}'  # noqa
+            })
             tile_matrix['links'].append({
                 'type': FORMAT_TYPES[F_JSON],
                 'rel': request.get_linkrel(F_JSON),

pygeoapi/flask_app.py

@@ -155,6 +155,36 @@ def conformance():
     return get_response(api_.conformance(request))
 
 
+@BLUEPRINT.route('/TileMatrixSets/WorldCRS84Quad')
+def WorldCRS84Quad():
+    """
+    OGC API WorldCRS84Quad endpoint
+
+    :returns: HTTP response
+    """
+    return get_response(api_.tilematrixset(request))
+
+
+@BLUEPRINT.route('/TileMatrixSets/WebMercatorQuad')
+def WebMercatorQuad():
+    """
+    OGC API WebMercatorQuad endpoint
+
+    :returns: HTTP response
+    """
+    return get_response(api_.tilematrixset(request))
+
+
+@BLUEPRINT.route('/TileMatrixSets')
+def TileMatrixSets():
+    """
+    OGC API TileMatrixSets endpoint
+
+    :returns: HTTP response
+    """
+    return get_response(api_.tilematrixsets(request))
+
+
 @BLUEPRINT.route('/collections')
 @BLUEPRINT.route('/collections/<path:collection_id>')
 def collections(collection_id=None):