网络要素服务（WFS）详解

charlee442024-01-21 23:45

目录

  • [1. 概述](#1. 概述)
  • [2. GetCapabilities](#2. GetCapabilities)
  • [3. DescribeFeatureType](#3. DescribeFeatureType)
  • [4. GetFeature](#4. GetFeature)
    • [4.1 Get访问方式](#4.1 Get访问方式)
    • [4.2 Post访问方式](#4.2 Post访问方式)
  • [5. Transaction](#5. Transaction)
    • [5.1 Insert](#5.1 Insert)
    • [5.2 Replace](#5.2 Replace)
    • [5.3 Update](#5.3 Update)
    • [5.4 Delete](#5.4 Delete)
  • [6 注意事项](#6 注意事项)

1. 概述

前置文章：
地图服务器GeoServer的安装与配置
GeoServer发布地图服务（WMS、WFS）
网络地图服务（WMS）详解

WMS是一个返回图片地图的服务，图片本身就是栅格数据的一种，而对于矢量数据则可以进行矢量栅格化；因此，WMS的数据源既可以是栅格数据，也可以是矢量数据。而WFS则不同，它是一个专门针对于矢量数据的服务，其返回的也是矢量要素本身。在Web环境中，图片是很容易进行可视化展示的，甚至图片本身就是GUI中一类很重要的元素。但矢量要素则不同，是不太容易可视化的。例如，如果要在前端的HTML5页面中展示获取的要素，就需要调用HTML5的Canvas元素来进行绘图，这其中涉及到繁复的操作不说，也很有可能会有性能问题。因此，WFS并不关心可视化问题，而是为返回GIS矢量数据而设计的，同时还支持矢量的查询、增加、删除以及修改等事务性操作。

WFS与WMS一样，同样使用HTTP来实现的各种操作，不同的是由于进行请求要求发送复杂的XML数据，简单的Get请求方式可能会受到数据量的限制，这种情况下需要使用Post方式进行请求。而在Web前端环境中，XML数据并不方便使用（最方便的是JSON数据），经常要考虑到繁琐的字符串拼接以及字符转义的问题。另一方面，由于WFS需要传输的参数比较多，在其标准规范《OpenGIS_Web_Map_Service_WMS_Implementation_Specification》使用了XML Schema（描述XML结构的语言）这一复杂的语言来描述需要传递的XML数据；并且一个操作的数据描述还分散在文档不同的地方。官方的参考资料尚且如此复杂，普通GIS从业人员也就很少愿意主动去使用，这无疑限制了造成WFS的应用场景。应该来说，WFS的设计出来的年代比较早，XML格式还是主流，如果使用JSON格式来进行数据传输，应该会方便不少。

目前WFS有2.0.2、2.0.0、1.1.3、1.1.0和1.0.0等多个版本，不过有4种操作是每个版本都有并且比较常见的，如下表1所示。由于有的操作与WMS比较类似，有的操作又比较繁琐，在下面的介绍中就不再对参数进行穷举说明，以实际的例子为主。

【表1 WFS支持的操作】

操作 描述
GetCapabilities 生成元数据文档，描述服务器提供的WFS服务以及有效的WFS操作和参数
DescribeFeatureType 返回WFS服务支持的要素类型的描述
GetFeature 从数据源中返回所选要素，包括几何和属性值
Transaction 通过创建、更新和删除来编辑现有要素类型

2. GetCapabilities

这个操作与WMS的GetCapabilities操作比较类似，都是生成描述服务器提供的WFS服务能力的元数据信息。例如我们在浏览器地址栏中输入如下地址：

复制代码 
http://localhost:8080/geoserver/wfs?
service=wfs&
version=2.0.0&
request=GetCapabilities

此时会返回一个XML文件，如下图所示：

3. DescribeFeatureType

在请求实际数据之前，往往需要知道要请求要素类型的信息，此时可以使用DescribeFeatureType操作。除此之外，该操作还可以获取属性的字段名称，以及字段类型。例如我们获取第8.1.3节发布的矢量要素test:multipolygons的类型，可通过如下地址来进行访问：

复制代码 
http://localhost:8080/geoserver/wfs?
service=wfs&
version=2.0.0&
request=DescribeFeatureType&
typeName=test:multipolygons&
outputFormat=application/json

由于我们设置了输出类型为JSON，因此会返回一个JSON数据，如下图8.34所示：

4. GetFeature

4.1 Get访问方式

接下来就是WFS中最重要的操作GetFeature了，通过该操作可以返回矢量数据源的要素信息，包括几何信息和属性信息。例如，要获取矢量要素的全部信息，可通过如下地址来进行访问：

复制代码 
http://localhost:8080/geoserver/wfs?
service=wfs&
version=2.0.0&
request=GetFeature&
typeNames=test:multipolygons&
outputFormat=application/json

此时返回的是所有的350个要素信息，如下图所示：

很多时候返回所有的要素信息并不是我们想要的，我们希望进行空间查询，例如查找一个矩形范围内要素，那么可以通过在浏览器中输入如下地址来实现：

复制代码 
http://localhost:8080/geoserver/wfs?
service=wfs&
version=2.0.0&
request=GetFeature&
typeNames=test:multipolygons&
outputFormat=application/json&
srsName=EPSG:4326&
bbox=38.8954267799311,-77.039412232917,38.8965224165805,-77.0380063000187

其中srsName表示空间坐标参考，bbox表示具体的四至范围。此时的返回结果如下图所示，可以看到返回的矢量要素只有21个了：

如果我们要进行属性查询，例如查找特定要素ID的特定属性值，可通过在浏览器中输入如下地址来实现：

复制代码 
http://localhost:8080/geoserver/wfs?
service=wfs&
version=2.0.0&
request=GetFeature&
typeNames=test:multipolygons&
outputFormat=application/json&
featureID=multipolygons.2&
propertyName=name,building

featureID表示要素Id，propertyName表示要素字段名。此时返回的结果可以看到该要素具体的属性值，如下图所示：

4.2 Post访问方式

以上几种方式都是通过在浏览器中输入如下地址，也就是通过HTTP协议的Get请求来实现。但是如果进行空间查询的参数数据量特别大，比如查询一个多边形范围内的要素就很麻烦了。虽然仍然可以通过给Get请求的filter参数传递一个XML格式的文本字符串的方式来实现，但是可能会受到URL长度的限制。因此，复杂的空间查询最好通过POST请求来实现。

不过，使用Post访问方式的示例就要麻烦一点。为了避免在访问WFS服务时遇到跨域问题，我们需要发布一个静态网页，通过JavaScript来实现Post请求。具体操作是新建一个test.html文件夹，内容如下例1所示：

【例1 给WFS发送Post请求】

html 复制代码 
<!DOCTYPE html>
<html lang="en">

<head>
  <meta charset="UTF-8">
  <title>test handle response</title>
  <script>
    var url = "http://localhost:8080/geoserver/wfs";
    var xhr = new XMLHttpRequest();
    xhr.open("POST", url);
    //xhr.open("GET", url);
    xhr.setRequestHeader("Content-Type", "text/xml");
    xhr.onload = function (e) {
      if (xhr.readyState === 4) {
        if (xhr.status === 200) {
          console.log(xhr.responseText);
        } else {
          console.error(xhr.statusText);
        }
      }
    };

    xhr.onerror = function (e) {
      console.error(xhr.statusText);
    };

    var xml = `<?xml version='1.0' encoding='UTF-8'?>
<wfs:GetFeature service=\"WFS\" version=\"2.0.0\" outputFormat=\"json\" 
xmlns:wfs=\"http://www.opengis.net/wfs/2.0\" 
xmlns:fes=\"http://www.opengis.net/fes/2.0\" 
xmlns:gml=\"http://www.opengis.net/gml/3.2\" 
xmlns:test=\"https://test\" 
xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" 
xsi:schemaLocation=\"http://www.opengis.net/wfs/2.0 
http://schemas.opengis.net/wfs/2.0/wfs.xsd 
http://www.opengis.net/gml/3.2 
http://schemas.opengis.net/gml/3.2.1/gml.xsd\">
  <wfs:Query typeNames='test:multipolygons'>
    <fes:Filter>
      <fes:Intersects>
        <fes:ValueReference>test:the_geom</fes:ValueReference>
        <gml:Envelope srsName=\"EPSG:4326\">
          <gml:lowerCorner>
            -77.039412232917 38.8954267799311
          </gml:lowerCorner>
          <gml:upperCorner>
            -77.0380063000187 38.8965224165805
          </gml:upperCorner>
        </gml:Envelope>
      </fes:Intersects>
    </fes:Filter>
  </wfs:Query>
</wfs:GetFeature>`;
    xhr.send(xml); 
  </script>
</head>
<body>
</body>
</html>

然后将这个文件放入到一个新的文件夹geoservertest，最后将geoservertest文件夹放入到Tomcat的项目发布目录webapps中，如下图所示：

在这个示例中，使用了XMLHttpRequest来发送Post请求，并且在请求头中标明数据内容是一个XML文件。我们这里使用的是一个XML格式的文本字符串，实际上我们要传输的XML数据内容经过格式化如下所示：

xml 复制代码 
<?xml version='1.0' encoding='UTF-8'?>
<wfs:GetFeature service="WFS" version="2.0.0" outputFormat="json"
  xmlns:wfs="http://www.opengis.net/wfs/2.0"
  xmlns:fes="http://www.opengis.net/fes/2.0"
  xmlns:gml="http://www.opengis.net/gml/3.2"
  xmlns:test="https://test"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opengis.net/wfs/2.0 
http://schemas.opengis.net/wfs/2.0/wfs.xsd 
http://www.opengis.net/gml/3.2 
http://schemas.opengis.net/gml/3.2.1/gml.xsd">
  <wfs:Query typeNames='test:multipolygons'>
    <fes:Filter>
      <fes:Intersects>
        <fes:ValueReference>test:the_geom</fes:ValueReference>
        <gml:Envelope srsName="EPSG:4326">
          <gml:lowerCorner>
            -77.039412232917 38.8954267799311
          </gml:lowerCorner>
          <gml:upperCorner>
            -77.0380063000187 38.8965224165805
          </gml:upperCorner>
        </gml:Envelope>
      </fes:Intersects>
    </fes:Filter>
  </wfs:Query>
</wfs:GetFeature>

我们可以看到XML其中一些属性和属性的值就是之前的参数，例如service="WFS"、version="2.0.0"、outputFormat="json"以及typeNames='test:multipolygons'。而fes:filter正是前面提到的用于设置过滤数据的元素；fes:Intersects则表示相交，test:the_geom表示相交查询要素的几何字段名称；gml:Envelope整个节点则通过GML（Geographic Markup Language，地理标记语言）描述了一个矩形范围。

我们在浏览器输入访问地址：http://localhost:8080/geoservertest/test.html ，打开浏览器调试器，可以看到在浏览器控制台输出了返回的信息。也可以检查该访问请求，查看具体的返回信息，如下图所示。可以看到返回的要素个数和前面Get请求的结果一样，也是21个要素。这是因为我们空间查询输入的四至范围是一样的。不过Post请求可以通过GML构造复杂的几何要素来进行空间查询，这时Get请求不能做到的。

5. Transaction

Transaction操作可以创建、修改和删除WFS发布的要素，加上GetFeature的查询操作，就组成了类似于处理常规数据库数据的"增删改查"操作。区别只在WFS服务的Transaction和GetFeature操作针对的是远端的地理空间数据。这也是将这个操作命名为Transaction（事务）的原因。简要来说，Transaction操作支持四个动作（Action），分别是Insert（插入）、Replace（替换）、Update（更新）和Delete（删除）。由于Transaction操作也比较复杂，通常使用Post请求来实现。

还是使用例1所示的test.html页面来进行WFS的Transaction操作。由于WFS操作Post请求发送的请求的文件头都差不多，区别主要在于发送的内容，也就是XML数据；那么我们就只需要修改发送的XML格式字符串就可以了。因此，Transaction操作所使用的示例与例1相同，这里只列出具体的XML数据。

5.1 Insert

既然我们要插入一个要素，首先就需要描述一个要素信息来进行传输。但是WFS要求请求的要素信息都是GML描述的，比如这里我们的示例矢量数据类型是面要素（multipolygon），那么应该如何去描述呢？最简单的方式是通过GetFeature查看默认格式的要素信息，就可以看到GML描述的要素，如下所示：

xml 复制代码 
<test:multipolygons gml:id="multipolygons.5">
  <gml:name/>
  <test:the_geom>
      <gml:MultiSurface srsName="http://www.opengis.net/gml/srs/epsg.xml#4326" srsDimension="2" gml:id="multipolygons.5.the_geom">
          <gml:surfaceMember>
              <gml:Polygon gml:id="multipolygons.5.the_geom.1">
                  <gml:exterior>
                      <gml:LinearRing>
                          <gml:posList>-77.0383595 38.8960779 -77.0383609 38.8961371 -77.0383618 38.8961764 ... -77.0383595 38.8960779</gml:posList>
                      </gml:LinearRing>
                  </gml:exterior>
                  <gml:interior>
                      <gml:LinearRing>
                          <gml:posList>-77.0386713 38.8958537 -77.0387129 38.8958542 -77.0387253 38.8958338 ... -77.0386713 38.8958537</gml:posList>
                      </gml:LinearRing>
                  </gml:interior>
              </gml:Polygon>
          </gml:surfaceMember>
      </gml:MultiSurface>
  </test:the_geom>
  <test:osm_id>3211113</test:osm_id>
  <test:osm_way_id/>
  <test:type>multipolygon</test:type> 
</test:multipolygons>

这段GML描述，如果我们对矢量比较熟悉的话，理解起来就会非常容易。一个面要素可能有一个外环和多个内环。环是起点和终点为同一个点的线串，线串由一系列连续的点组成。我们可以仿照这个格式，也创建一个GML格式的要素信息，将其嵌入到要传输的XML数据中。具体的插入要素要发送Post请求的XML数据如下所示：

xml 复制代码 
<?xml version="1.0"?>
<wfs:Transaction service="WFS" version="2.0.0"
    xmlns:test="https://test"
    xmlns:fes="http://www.opengis.net/fes/2.0"
    xmlns:gml="http://www.opengis.net/gml/3.2"
    xmlns:wfs="http://www.opengis.net/wfs/2.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opengis.net/wfs/2.0 http://schemas.opengis.net/wfs/2.0/wfs.xsd http://www.opengis.net/gml/3.2 http://schemas.opengis.net/gml/3.2.1/gml.xsd">
    <wfs:Insert>
        <test:multipolygons gml:id="multipolygons.351">
            <test:the_geom>
                <gml:MultiSurface srsName="http://www.opengis.net/gml/srs/epsg.xml#4326" srsDimension="2" gml:id="multipolygons.352.the_geom">
                    <gml:surfaceMember>
                        <gml:Polygon gml:id="multipolygons.351.the_geom.1">
                            <gml:exterior>
                                <gml:LinearRing>
                                    <gml:posList>-77.039412232917 38.8954267799311 -77.039412232917 38.8965224165805 -77.0380063000187 38.8965224165805 -77.0380063000187 38.8954267799311 -77.039412232917 38.8954267799311</gml:posList>
                                </gml:LinearRing>
                            </gml:exterior>
                        </gml:Polygon>
                    </gml:surfaceMember>
                </gml:MultiSurface>
            </test:the_geom>
        </test:multipolygons>
    </wfs:Insert>
</wfs:Transaction>

在这个XML中我们可以看到一些熟悉的配置，例如service="WFS"，version="2.0.0"等。wfs:Insert表示使用wfs的插入操作，test:multipolygons则索引到我们要插入的要素图层名称。test是我们在前文中创建的工作空间，我们同时还创建了对应的命名空间URI：https://test ；工作空间需要与命名空间URI相关联，这也是为什么要写xmlns:test="https://test"。除此之外，剩下的就是通过GML描述的面要素了，可以看到我们构建了一个四边形。

同样的还是在浏览器输入访问地址http://localhost:8080/geoservertest/test.html 来发送Post请求。如果一切顺利的话，再通过GetFeature操作（http://localhost:8080/geoserver/wfs?service=wfs&version=2.0.0&request=GetFeature&typeNames=test:multipolygons&outputFormat=application/json ）就可以看到刚刚插入的新的要素，如下图所示：

5.2 Replace

有了Insert操作作为基础，理解Replace的实现就非常容易了。Replace操作Post请求需要传输的XML数据如下：

xml 复制代码 
<?xml version='1.0' encoding='UTF-8'?>
<wfs:Transaction version="2.0.0" service="WFS"
    xmlns:test="https://test"
    xmlns:fes="http://www.opengis.net/fes/2.0"
    xmlns:wfs="http://www.opengis.net/wfs/2.0"
    xmlns:gml="http://www.opengis.net/gml/3.2"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opengis.net/wfs/2.0
			http://schemas.opengis.net/wfs/2.0/wfs.xsd">
    <wfs:Replace>
        <test:multipolygons gml:id="multipolygons.351">
            <test:the_geom>
                <gml:MultiSurface srsName="http://www.opengis.net/gml/srs/epsg.xml#4326" srsDimension="2" gml:id="multipolygons.352.the_geom">
                    <gml:surfaceMember>
                        <gml:Polygon gml:id="multipolygons.352.the_geom.1">
                            <gml:exterior>
                                <gml:LinearRing>
                                    <gml:posList>-77.039412232917 38.8954267799311 -77.039412232917 38.8965224165805 -77.0380063000187 38.8965224165805 -77.039412232917 38.8954267799311
                                    </gml:posList>
                                </gml:LinearRing>
                            </gml:exterior>
                        </gml:Polygon>
                    </gml:surfaceMember>
                </gml:MultiSurface>
            </test:the_geom>
        </test:multipolygons>
        <fes:Filter>
            <fes:ResourceId rid="multipolygons.351"/>
        </fes:Filter>
    </wfs:Replace>
</wfs:Transaction>

可以看到XML数据内容与Insert操作差不多，不过要注意的是多了一个fes:Filter元素来帮助选定到具体需要替换的要素。最后通过GetFeature操作查询替换的要素如下图所示，可以看到我们将一个四边形要素替换成了三角形：

5.3 Update

前面Insert和Replace操作的对象都是要素的几何信息，其实要素的属性信息也可以修改。例如可以通过Update操作来更新要素的属性信息，其Post请求需要传输的XML数据如下：

xml 复制代码 
<?xml version='1.0' encoding='UTF-8'?>
<wfs:Transaction version="2.0.0" service="WFS"
   xmlns:fes="http://www.opengis.net/fes/2.0"
   xmlns:wfs="http://www.opengis.net/wfs/2.0"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://www.opengis.net/wfs/2.0
                       http://schemas.opengis.net/wfs/2.0.0/wfs.xsd">
   <wfs:Update typeName="test:multipolygons">
      <wfs:Property>
         <wfs:ValueReference>name</wfs:ValueReference>
         <wfs:Value>bound</wfs:Value>
      </wfs:Property>
      <wfs:Property>
         <wfs:ValueReference>other_tags</wfs:ValueReference>
         <wfs:Value>test</wfs:Value>
      </wfs:Property>      
      <fes:Filter>
         <fes:ResourceId rid="multipolygons.351"/>
      </fes:Filter>
   </wfs:Update>
</wfs:Transaction>

可以看到我们为这个新增加并且替换后的要素更新了两个属性字段（name和other_tags）的值，通过GetFeature操作查询要素的结果如下图所示：

5.4 Delete

最后就让我们形成一个回环，将这个新增并且修改的矢量要素删除掉吧，Delete操作的Post请求需要传输的XML数据如下：

xml 复制代码 
<?xml version='1.0' encoding='UTF-8'?>
<wfs:Transaction version="2.0.0" service="WFS"
    xmlns:fes="http://www.opengis.net/fes/2.0"
    xmlns:wfs="http://www.opengis.net/wfs/2.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opengis.net/wfs/2.0
                       http://schemas.opengis.net/wfs/2.0/wfs.xsd">
    <wfs:Delete typeName="test:multipolygons">
        <fes:Filter>
            <fes:ResourceId rid="multipolygons.351"/>
        </fes:Filter>
    </wfs:Delete>
</wfs:Transaction>

经过GetFeature操作查询后，我们发现这个矢量数据的要素个数又回到了350个，如下图所示：

6 注意事项

除了以上四种常用的操作，WFS还有一些其他操作，有的操作还是特定版本特有的，篇幅所限笔者这里就不介绍了。另外，相信读者也能感受到，WFS提供的一些操作确实非常复杂繁琐。对于空间数据的增删改查，直接使用地理数据库+定制的后端接口也许更为方便安全一些。

相关推荐
ct9781 天前
Cesium高级特效与着色器开发全指南
前端·gis·cesium·着色器
葱明撅腚3 天前
shapely空间数据分析
python·pandas·gis·shapely
极海拾贝4 天前
秒加在线底图！天地图、高德地图、星图地球、吉林一号底图一次配齐，收藏这篇就够了！
arcgis·gis·geoscene
ct9785 天前
Cesium 矩阵系统详解
前端·线性代数·矩阵·gis·webgl
两点王爷5 天前
KML文件格式和支持添加的内容
gis
水静川流5 天前
GIS工具、POI数据、DEM数据、NDVI数据等地学大数据
arcgis·gis·poi·dem·地学大数据
GIS遥遥7 天前
2026年地信测绘遥感（3S）专业升学、就业、考证、竞赛专属日历
gis·gis开发·测绘·地图可视化
酬勤-人间道7 天前
XPlote3DGenie 2.1.1.0：实用 3D 数据处理工具，百度网盘可直接安装
c++·3d·gis·编程·计算机软件·岩土
GISBox7 天前
GIS场景透明度贴图全流程指南：模型导入、透明模式设置与3DTiles服务发布
3d·gis·gisbox·透明度贴图·opaque·alphatest·alphablend
热门推荐
01GitHub 镜像站点02Clawdbot 中文汉化版 接入微信、飞书03OpenCode 入门教程：介绍 · 安装 · 配置第三方 API (如 Claude)042026数学建模美赛题目特点与选题建议，常用四大模型汇总05一种新的LCA算法06Claude Code Skills 实用使用手册07UV安装并设置国内源08零门槛部署本地 AI 助手：Clawdbot/Meltbot 部署深度保姆级教程09在Trae中使用Pencil MCP10Linux下V2Ray安装配置指南