diff --git a/en/ogc/ogc_api.txt b/en/ogc/ogc_api.txt index 269c660925f..eda89eb41e9 100644 --- a/en/ogc/ogc_api.txt +++ b/en/ogc/ogc_api.txt @@ -193,29 +193,33 @@ Metadata .. table:: :align: left - +------------------------+---------------------+---------------------------------------------------------------------------------------------+ - | Key | Level | Meaning | - +========================+=====================+=============================================================================================+ - | onlineresource | Map | API root url, can't reuse WxS values | - +------------------------+---------------------+---------------------------------------------------------------------------------------------+ - | html_template_directory| Map | full path or relative (to mapfile) of html template directory | - +------------------------+---------------------+---------------------------------------------------------------------------------------------+ - | description | Map | service description, fall back to ows/wfs_abstract | - +------------------------+---------------------+---------------------------------------------------------------------------------------------+ - | links | Map, Layer | comma delimited list of link keys - references to other metadata | - +------------------------+---------------------+---------------------------------------------------------------------------------------------+ - | link_{key}_title | Map, Layer | link title | - +------------------------+---------------------+---------------------------------------------------------------------------------------------+ - | link_{key}_href | Map, Layer | link href (url) | - +------------------------+---------------------+---------------------------------------------------------------------------------------------+ - | html_tags | Map | comma delimited list of tag keys to expose to HTML templates - references to other metadata | - +------------------------+---------------------+---------------------------------------------------------------------------------------------+ - | tag_{key} | Map | value associated with the tag, added to JSON data in template.tags object | - +------------------------+---------------------+---------------------------------------------------------------------------------------------+ - | keywords | Layer | comma delimited list of keywords, fall back to ows/wfs_keywordlist | - +------------------------+---------------------+---------------------------------------------------------------------------------------------+ - | max_limit | Map, Layer | map or layer-level maximum limit value (integer) | - +------------------------+---------------------+---------------------------------------------------------------------------------------------+ + +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+ + | Key | Level | Meaning | + +======================================+=====================+=============================================================================================+ + | onlineresource | Map | API root url, can't reuse WxS values | + +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+ + | html_template_directory | Map | full path or relative (to mapfile) of html template directory | + +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+ + | description | Map | service description, fall back to ows/wfs_abstract | + +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+ + | links | Map, Layer | comma delimited list of link keys - references to other metadata | + +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+ + | link_{key}_title | Map, Layer | link title | + +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+ + | link_{key}_href | Map, Layer | link href (url) | + +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+ + | html_tags | Map | comma delimited list of tag keys to expose to HTML templates - references to other metadata | + +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+ + | tag_{key} | Map | value associated with the tag, added to JSON data in template.tags object | + +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+ + | keywords | Layer | comma delimited list of keywords, fall back to ows/wfs_keywordlist | + +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+ + | max_limit | Map, Layer | map or layer-level maximum limit value (integer) | + +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+ + | use_default_extent_for_getfeature | Layer | (since 8.4) Use ``MAP`` ``EXTENT`` as a spatial filter if no bbox is in the request. | + | (optional) | | Setting to ``"false"`` can improve performance. | + | | | See also :ref:`wfs_use_default_extent_for_getfeature`. | + +--------------------------------------+---------------------+---------------------------------------------------------------------------------------------+ Example OGC API Server Mapfile ****************************** @@ -280,6 +284,7 @@ Example OGC API Server Mapfile "ows_abstract" "Oceans, NaturalEarth dataset, 2020" "gml_include_items" "all" #REQUIRED "gml_featureid" "ne_id" #REQUIRED + "oga_use_default_extent_for_getfeature" # Optional. Can improve performance. END TYPE POLYGON STATUS ON diff --git a/en/ogc/wfs_server.txt b/en/ogc/wfs_server.txt index 434118e2844..1fd830af69a 100644 --- a/en/ogc/wfs_server.txt +++ b/en/ogc/wfs_server.txt @@ -1365,13 +1365,16 @@ Layer Object .. index:: triple: WFS; METADATA; wfs_use_default_extent_for_getfeature +.. _wfs_use_default_extent_for_getfeature: + **wfs_use_default_extent_for_getfeature** (Optional, since MapServer 7.0.4) Whether the MAP.EXTENT should be used in request to datasources in the absence of other spatial filter. This is the default behaviour, but this might affect performance in some use cases. In - those cases, setting this item to "false" will avoid he default spatial filter to - be appended to the request. This is only implemented for OGR datasources (since 7.0.4) - and MSSQL2008 connections (since 7.6) + those cases, setting this item to "false" will avoid the default spatial filter to + be appended to the request. This is only implemented for OGR datasources (since 7.0.4), + MSSQL2008 (since 7.6), and PostGIS connections (since 8.4). + Use **ows_use_default_extent_for_getfeature** to set for both WFS and :ref:`ogcapi`. Layer Metadata API ----------------------