Added support to tileindexing on MapScript provider (#1931)

* - Added support to tileindexing on MapScript provider

* - updated MapScript provider to use str2bool to extract boolean from string

* - remove comment

* - fixed typos and styling in MapScript documentation

* - simplified condition

* - removed brackets on import

Author: doublebyte1

docs/source/data-publishing/ogcapi-maps.rst

@@ -73,6 +73,26 @@ Projections are supported through EPSG codes (`options.projection`):
 
 This parameter is optional, defaulting to WGS84 (4236).
 
+This provider also supports `tile indexing <https://mapserver.org/optimization/tileindex.html>`_,
+which lets MapScript create a mosaic on the fly, piecing together a set of files. 
+In order to enable it, set `options.tileindex` to `True` and set the location of the index file on the `data` path.
+
+.. code-block:: yaml
+
+        providers:
+          - type: map
+            name: MapScript
+            data: /data/index.shp
+            options:
+                type: MS_LAYER_RASTER
+                tileindex: True
+                layer: index
+            format:
+                name: png
+                mimetype: image/png
+
+The `options.tileindex` parameter is optional, defaulting to `False`.
+
 WMSFacade
 ^^^^^^^^^
 

pygeoapi/provider/mapscript_.py

@@ -35,6 +35,7 @@
 
 from pygeoapi.provider.base import (BaseProvider, ProviderConnectionError,
                                     ProviderQueryError)
+from pygeoapi.util import str2bool
 
 LOGGER = logging.getLogger(__name__)
 
@@ -74,13 +75,17 @@ def __init__(self, provider_def):
 
             file_extension = self.data.split('.')[-1]
 
-            if file_extension in ['shp', 'tif']:
-                LOGGER.debug('Setting built-in MapServer driver')
-                self._layer.data = self.data
+            if str2bool(self.options.get('tileindex', False)):
+                LOGGER.debug('Setting tileindex')
+                self._layer.tileindex = self.data
             else:
-                LOGGER.debug('Setting OGR driver')
-                self._layer.setConnectionType(mapscript.MS_OGR, 'OGR')
-                self._layer.connection = self.data
+                if file_extension in ['shp', 'tif']:
+                    LOGGER.debug('Setting built-in MapServer driver')
+                    self._layer.data = self.data
+                else:
+                    LOGGER.debug('Setting OGR driver')
+                    self._layer.setConnectionType(mapscript.MS_OGR, 'OGR')
+                    self._layer.connection = self.data
 
             self._layer.type = getattr(mapscript, self.options['type'])