3.1. 基础知识

本节介绍服务相互共享的概念和参数。其中一些是标准的，并在OGC规范中定义，而另一些则非常特定于QGIS服务器。

标准概念：

概念

描述

SERVICE

服务的名称

REQUEST

请求的名称

供应商概念：

概念

描述

MAP

QGIS工程文件

FILE_NAME

下载的文件的文件名

Short name

简称定义

3.1.1. SERVICE

此标准参数允许指定要用于特定 request 并且必须形成如下形式 SERVICE=NAME 。

的URL示例 WMS 服务：

http://localhost/qgisserver?
SERVICE=WMS
&...

备注

不可用于基于REST的服务，如 WFS3 (OGC API Features) 。

3.1.2. REQUEST

此标准参数允许指定要为特定的 service 并且必须形成如下形式 REQUEST=RequestName 。

的URL示例 GetCapabilities 请求：

http://localhost/qgisserver?
REQUEST=GetCapabilities
&...

备注

不可用于基于REST的服务，如 WFS3 (OGC API Features) 。

3.1.3. MAP

该供应商参数允许定义要使用的QGIS项目文件。它可以是绝对路径，也可以是相对于服务器可执行文件位置的路径 qgis_mapserv.fcgi 。 MAP 默认情况下是强制的，因为请求需要QGIS项目才能实际工作。然而， QGIS_PROJECT_FILE 环境变量可用于定义默认的QGIS项目。在这个特定的案例中， MAP 不再是必需的参数。有关更多信息，请参阅 高级配置 第二章。

URL示例：

http://localhost/qgisserver?
MAP=/tmp/QGIS-Training-Data/exercise_data/qgis-server-tutorial-data/world.qgs
&...

3.1.4. FILE_NAME

如果设置了此供应商参数，则服务器响应将作为具有指定文件名的文件附件发送到客户端。

保存XML的URL示例 GetCapabilities 文档：

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetCapabilities
&FILE_NAME=wms_capabilities.xml
&...

备注

不可用于基于REST的服务，如 WFS3 (OGC API Features) 。

3.1.5. 简称

许多元素都具有 short name 以及一个 title 。简称是用于机器对机器通信的文本字符串，而标题是为了人类的利益。例如，数据集可能具有描述性标题 “Maximum Atmospheric Temperature” 并使用缩写的缩写名称被请求 “ATMAX” 。您可以为以下内容设置标题、简称和摘要：

  • Layers ：在一个层上单击鼠标右键并选择 Properties... ► QGIS Server ► Description 。

  • Groups ：右键单击组并选择 Set Group WMS data

  • Project ：转至 Project ► Properties... ► QGIS Server ► Service Capabilities 。

../../../_images/set_group_wms_data.png

图 3.1 Set Group WMS Data(设置组WMS数据)对话框

因此，在与QGIS服务器交互时，可以使用短名称来标识这些项。例如，使用标准 LAYERS 参数：

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&LAYERS=shortname1,shortname2
&...