mirror of
				https://github.com/qgis/QGIS.git
				synced 2025-10-31 00:06:02 -04: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   *
 | |
|  ************************************************************************/
 |