mirror of
				https://github.com/qgis/QGIS.git
				synced 2025-11-04 00:04:25 -05:00 
			
		
		
		
	The goals are: * To have better result in the GetCapabilities URL without having to fill it in the Project configuration * Be able to be set by an integrator with environment variable or by providing headers from a proxy The server resolution will use the following order: - Value defined in the project per service. - The ``<service>_SERVICE_URL`` environment variable. - The ``SERVICE_URL`` environment variable. - The custom ``X-Qgis-<service>-Servcie-Url`` header. - The custom ``X-Qgis-Service-Url`` header. - Build form the standard ``Forwarded`` header. - Build form the pseudo standard ``X-Forwarded-Host`` and ``X-Forwarded-Proto`` headers. - Build form the standard ``Host`` header and the server protocol. - Build form the server name and the server protocol.
		
			
				
	
	
		
			532 lines
		
	
	
		
			14 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			532 lines
		
	
	
		
			14 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
/************************************************************************
 | 
						|
 * This file has been generated automatically from                      *
 | 
						|
 *                                                                      *
 | 
						|
 * src/server/qgsserverprojectutils.h                                   *
 | 
						|
 *                                                                      *
 | 
						|
 * Do not edit manually ! Edit header and run scripts/sipify.pl again   *
 | 
						|
 ************************************************************************/
 | 
						|
 | 
						|
 | 
						|
 | 
						|
 | 
						|
 | 
						|
 | 
						|
%ModuleHeaderCode
 | 
						|
#include "qgsserverprojectutils.h"
 | 
						|
%End
 | 
						|
 | 
						|
 | 
						|
namespace QgsServerProjectUtils
 | 
						|
{
 | 
						|
 | 
						|
 | 
						|
 | 
						|
  bool owsServiceCapabilities( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns if owsService capabilities are enabled.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: if owsService capabilities are enabled.
 | 
						|
%End
 | 
						|
 | 
						|
  QString owsServiceTitle( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the owsService title defined in project.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the owsService title if defined in project with project title as fallback, "Untitled" otherwise.
 | 
						|
%End
 | 
						|
 | 
						|
  QString owsServiceAbstract( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the owsService abstract defined in project.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the owsService abstract if defined in project.
 | 
						|
%End
 | 
						|
 | 
						|
  QStringList owsServiceKeywords( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the owsService keywords defined in project.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the owsService keywords if defined in project.
 | 
						|
%End
 | 
						|
 | 
						|
  QString owsServiceOnlineResource( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the owsService online resource defined in project.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the owsService online resource if defined in project.
 | 
						|
%End
 | 
						|
 | 
						|
  QString owsServiceContactOrganization( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the owsService contact organization defined in project.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the owsService contact organization if defined in project.
 | 
						|
%End
 | 
						|
 | 
						|
  QString owsServiceContactPosition( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the owsService contact position defined in project.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the owsService contact position if defined in project.
 | 
						|
%End
 | 
						|
 | 
						|
  QString owsServiceContactPerson( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the owsService contact person defined in project.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the owsService contact person if defined in project.
 | 
						|
%End
 | 
						|
 | 
						|
  QString owsServiceContactMail( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the owsService contact mail defined in project.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the owsService contact mail if defined in project.
 | 
						|
%End
 | 
						|
 | 
						|
  QString owsServiceContactPhone( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the owsService contact phone defined in project.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the owsService contact phone if defined in project.
 | 
						|
%End
 | 
						|
 | 
						|
  QString owsServiceFees( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the owsService fees defined in project.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the owsService fees if defined in project.
 | 
						|
%End
 | 
						|
 | 
						|
  QString owsServiceAccessConstraints( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the owsService access constraints defined in project.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the owsService access constraints if defined in project.
 | 
						|
%End
 | 
						|
 | 
						|
  int wmsMaxWidth( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the maximum width for WMS images defined in a QGIS project.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: width if defined in project, -1 otherwise.
 | 
						|
%End
 | 
						|
 | 
						|
  int wmsMaxHeight( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the maximum height for WMS images defined in a QGIS project.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: height if defined in project, -1 otherwise.
 | 
						|
%End
 | 
						|
 | 
						|
  int wmsImageQuality( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the quality for WMS images defined in a QGIS project.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: quality if defined in project, -1 otherwise.
 | 
						|
%End
 | 
						|
 | 
						|
  int wmsTileBuffer( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the tile buffer in pixels for WMS images defined in a QGIS project.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: tile buffer if defined in project, 0 otherwise.
 | 
						|
 | 
						|
.. versionadded:: 3.10
 | 
						|
%End
 | 
						|
 | 
						|
  bool wmsRenderMapTiles( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns ``True`` if WMS requests should use the :py:class:`QgsMapSettings`.RenderMapTile flag,
 | 
						|
so that no visible artifacts are visible between adjacent tiles.
 | 
						|
 | 
						|
This flag can slow down rendering considerably, so it is only used if the corresponding
 | 
						|
setting is enabled in the project.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: ``True`` if the flag should be used, or ``False`` if not.
 | 
						|
 | 
						|
.. versionadded:: 3.18
 | 
						|
%End
 | 
						|
 | 
						|
  int wmsMaxAtlasFeatures( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the maximum number of atlas features which can be printed in a request
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the number of atlas features
 | 
						|
%End
 | 
						|
 | 
						|
  double wmsDefaultMapUnitsPerMm( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the default number of map units per millimeters in case of the scale is not given
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the default number of map units per millimeter
 | 
						|
 | 
						|
.. versionadded:: 3.4
 | 
						|
%End
 | 
						|
 | 
						|
  bool wmsUseLayerIds( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns if layer ids are used as name in WMS.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: if layer ids are used as name.
 | 
						|
%End
 | 
						|
 | 
						|
  bool wmsInfoFormatSia2045( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns if the info format is SIA20145.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: if the info format is SIA20145.
 | 
						|
%End
 | 
						|
 | 
						|
  bool wmsFeatureInfoAddWktGeometry( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns if the geometry is displayed as Well Known Text in GetFeatureInfo request.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: if the geometry is displayed as Well Known Text in GetFeatureInfo request.
 | 
						|
%End
 | 
						|
 | 
						|
  bool wmsFeatureInfoUseAttributeFormSettings( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns if feature form settings should be considered for the format of the feature info response
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: true if the feature form settings shall be considered for the feature info response
 | 
						|
%End
 | 
						|
 | 
						|
  bool wmsFeatureInfoSegmentizeWktGeometry( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns if the geometry has to be segmentize in GetFeatureInfo request.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: if the geometry has to be segmentize in GetFeatureInfo request.
 | 
						|
%End
 | 
						|
 | 
						|
  int wmsFeatureInfoPrecision( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the geometry precision for GetFeatureInfo request.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the geometry precision for GetFeatureInfo request.
 | 
						|
%End
 | 
						|
 | 
						|
  QString wmsFeatureInfoDocumentElement( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the document element name for XML GetFeatureInfo request.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the document element name for XML GetFeatureInfo request.
 | 
						|
%End
 | 
						|
 | 
						|
  QString wmsFeatureInfoDocumentElementNs( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the document element namespace for XML GetFeatureInfo request.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the document element namespace for XML GetFeatureInfo request.
 | 
						|
%End
 | 
						|
 | 
						|
  QString wmsFeatureInfoSchema( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the schema URL for XML GetFeatureInfo request.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the schema URL for XML GetFeatureInfo request.
 | 
						|
%End
 | 
						|
 | 
						|
  QHash<QString, QString> wmsFeatureInfoLayerAliasMap( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the mapping between layer name and wms layer name for GetFeatureInfo request.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the mapping between layer name and wms layer name for GetFeatureInfo request.
 | 
						|
%End
 | 
						|
 | 
						|
  bool wmsInspireActivate( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns if Inspire is activated.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: if Inspire is activated.
 | 
						|
%End
 | 
						|
 | 
						|
  QString wmsInspireLanguage( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the Inspire language.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the Inspire language if defined in project.
 | 
						|
%End
 | 
						|
 | 
						|
  QString wmsInspireMetadataUrl( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the Inspire metadata URL.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the Inspire metadata URL if defined in project.
 | 
						|
%End
 | 
						|
 | 
						|
  QString wmsInspireMetadataUrlType( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the Inspire metadata URL type.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the Inspire metadata URL type if defined in project.
 | 
						|
%End
 | 
						|
 | 
						|
  QString wmsInspireTemporalReference( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the Inspire temporal reference.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the Inspire temporal reference if defined in project.
 | 
						|
%End
 | 
						|
 | 
						|
  QString wmsInspireMetadataDate( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the Inspire metadata date.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the Inspire metadata date if defined in project.
 | 
						|
%End
 | 
						|
 | 
						|
  QStringList wmsRestrictedComposers( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the restricted composer list.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the restricted composer list if defined in project.
 | 
						|
%End
 | 
						|
 | 
						|
  QString wmsServiceUrl( const QgsProject &project, const QgsServerRequest &request = QgsServerRequest(), const QgsServerSettings &settings = QgsServerSettings() );
 | 
						|
%Docstring
 | 
						|
Returns the WMS service url.
 | 
						|
The URL defined in the project or if not defined the URL from serviceUrl.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
:param request: the request
 | 
						|
:param settings: the server settings
 | 
						|
 | 
						|
:return: url to use for this service
 | 
						|
%End
 | 
						|
 | 
						|
  QString wmsRootName( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the WMS root layer name defined in a QGIS project.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: root layer name to use for this service
 | 
						|
%End
 | 
						|
 | 
						|
  QStringList wmsRestrictedLayers( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the restricted layer name list.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the restricted layer name list if defined in project.
 | 
						|
%End
 | 
						|
 | 
						|
  QStringList wmsOutputCrsList( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the WMS output CRS list.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the WMS output CRS list.
 | 
						|
%End
 | 
						|
 | 
						|
  QgsRectangle wmsExtent( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the WMS Extent restriction.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the WMS Extent restriction.
 | 
						|
%End
 | 
						|
 | 
						|
  QString wfsServiceUrl( const QgsProject &project, const QgsServerRequest &request = QgsServerRequest(), const QgsServerSettings &settings = QgsServerSettings() );
 | 
						|
%Docstring
 | 
						|
Returns the WFS service url.
 | 
						|
The URL defined in the project or if not defined the URL from serviceUrl.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
:param request: the request
 | 
						|
:param settings: the server settings
 | 
						|
 | 
						|
:return: url to use for this service
 | 
						|
%End
 | 
						|
 | 
						|
  QStringList wfsLayerIds( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the Layer ids list defined in a QGIS project as published in WFS.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the Layer ids list.
 | 
						|
%End
 | 
						|
 | 
						|
 | 
						|
  int wfsLayerPrecision( const QgsProject &project, const QString &layerId );
 | 
						|
%Docstring
 | 
						|
Returns the Layer precision defined in a QGIS project for the WFS GetFeature.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
:param layerId: the layer id in the project
 | 
						|
 | 
						|
:return: the layer precision for WFS GetFeature.
 | 
						|
%End
 | 
						|
 | 
						|
  QStringList wfstUpdateLayerIds( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the Layer ids list defined in a QGIS project as published as WFS-T with update capabilities.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the Layer ids list.
 | 
						|
%End
 | 
						|
 | 
						|
  QStringList wfstInsertLayerIds( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the Layer ids list defined in a QGIS project as published as WFS-T with insert capabilities.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the Layer ids list.
 | 
						|
%End
 | 
						|
 | 
						|
  QStringList wfstDeleteLayerIds( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the Layer ids list defined in a QGIS project as published as WFS-T with delete capabilities.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the Layer ids list.
 | 
						|
%End
 | 
						|
 | 
						|
  QString wcsServiceUrl( const QgsProject &project, const QgsServerRequest &request = QgsServerRequest(), const QgsServerSettings &settings = QgsServerSettings() );
 | 
						|
%Docstring
 | 
						|
Returns the WCS service url.
 | 
						|
The URL defined in the project or if not defined the URL from serviceUrl.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
:param request: the request
 | 
						|
:param settings: the server settings
 | 
						|
 | 
						|
:return: url to use for this service
 | 
						|
%End
 | 
						|
 | 
						|
  QStringList wcsLayerIds( const QgsProject &project );
 | 
						|
%Docstring
 | 
						|
Returns the Layer ids list defined in a QGIS project as published in WCS.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
 | 
						|
:return: the Layer ids list.
 | 
						|
%End
 | 
						|
 | 
						|
  QString wmtsServiceUrl( const QgsProject &project, const QgsServerRequest &request = QgsServerRequest(), const QgsServerSettings &settings = QgsServerSettings() );
 | 
						|
%Docstring
 | 
						|
Returns the WMTS service url.
 | 
						|
The URL defined in the project or if not defined the URL from serviceUrl.
 | 
						|
 | 
						|
:param project: the QGIS project
 | 
						|
:param request: the request
 | 
						|
:param settings: the server settings
 | 
						|
 | 
						|
:return: url to use for this service
 | 
						|
 | 
						|
.. versionadded:: 3.4
 | 
						|
%End
 | 
						|
 | 
						|
  QString serviceUrl( const QString &service, const QgsServerRequest &request, const QgsServerSettings &settings );
 | 
						|
%Docstring
 | 
						|
Returns the service url defined in the environment variable or with HTTP header.
 | 
						|
The is calculated from, in the order:
 | 
						|
 | 
						|
- Value defined in the project per service.
 | 
						|
- The ``<service>_SERVICE_URL`` environment variable.
 | 
						|
- The ``SERVICE_URL`` environment variable.
 | 
						|
- The custom ``X-Qgis-<service>-Servcie-Url`` header.
 | 
						|
- The custom ``X-Qgis-Service-Url`` header.
 | 
						|
- Build form the standard ``Forwarded`` header.
 | 
						|
- Build form the pseudo standard ``X-Forwarded-Host`` and ``X-Forwarded-Proto`` headers.
 | 
						|
- Build form the standard ``Host`` header and the server protocol.
 | 
						|
- Build form the server name and the server protocol.
 | 
						|
 | 
						|
:param request: the request
 | 
						|
:param service: the used service
 | 
						|
:param settings: the server settings
 | 
						|
 | 
						|
:return: url to use for this service
 | 
						|
 | 
						|
.. versionadded:: 3.20
 | 
						|
%End
 | 
						|
};
 | 
						|
 | 
						|
/************************************************************************
 | 
						|
 * This file has been generated automatically from                      *
 | 
						|
 *                                                                      *
 | 
						|
 * src/server/qgsserverprojectutils.h                                   *
 | 
						|
 *                                                                      *
 | 
						|
 * Do not edit manually ! Edit header and run scripts/sipify.pl again   *
 | 
						|
 ************************************************************************/
 |