Geoserver中CQL_FILTER的使用

news2025/10/29 15:01:35

概述

在Geoserver中可通过CQL_FILTER对要素进行过滤，CQL_FILTER即支持属性过滤也支持空间过滤，本文通过实际的例子演示如何使用CQL_FILTER。

简介

CQL(Common Query Language)是为OGC目录规范创建的纯文本语言。GeoServer对其进行了调整，使其更易于使用。GeoServer实际上实现了一个更强大的扩展，称为ECQL(Extended CQL)。在GeoServer中，过滤器可以在多种场景中使用：

WMS请求中通过filter参数选择在地图上展示的要素
WFS请求中通过filter参数过滤返回特定条件的要素
SLD样式文件中通过Filter元素根据不同的条件设置不同的样式

条件可以是一个条件，也可以是多个条件。

规则	说明
Predicate	单个条件
`AND` 或 `OR`	多个组合条件
`NOT`	取反条件
`(\|[` 条件 `]\|)`	通过`(`或`[`控制条件顺序

测试数据

本文中的测试数据是用天地图公共资源中的幼儿园数据，并添加了测试字段，数据和字段情况如下图：

示例

示例通过Geoserver中图层预览进行演示，如下图，是更进去后的状态。

1. 属性过滤

1.1 比较运算

比较运算符有等于=、不等于<>、小于 <、小于等于<=、大于> 、大于等于>=。其中=和<>支持多种数据类型，如varchar、number、boolean、time等，<、<=、>、>=支持number和time类型。

1）等于`=`和不等于`<>`

通过=可过滤值等于某个值的要素，其写法跟sql的语法类似。如下示例中演示了num = 110的结果。

如下示例中演示了name = '阳光民族幼儿园'的结果。

通过<>可过滤值不等于某个值的要素，如下示例中演示了num <> 110的结果。

如下示例中演示了name <> '阳光民族幼儿园'的结果。

2)`<`、`<=`、`>`、`>=`

如下示例演示了number和time类型的比较。如条件为num > 290的结果如下图所示。

1.2 `BETWEEN AND`值域区间

通过BETWEEN AND可过滤number和time类型的字段的值在某个区间，如下示例，通过num BETWEEN 100 AND 110条件过滤了num值在100-150之间的要素

1.3 `LIKE`值匹配

通过LIKE可对varchar和num等类型的字段进行过滤,其写法与SQL类似，如下示例，通过name LIKE '%艺术%'过滤了名称中包含“艺术”儿子的要素。其中：

艺术%,表示以“艺术”开头
%艺术,表示以“艺术”结尾
%艺术%,表示包含“艺术”二字

1.4 `IN`条件

通过IN设置条件在某一组值中，可对varchar和num等类型的字段进行过滤。如下示例通过num in (110, 120)演示了num为110和120的要素。

如下示例通过name in ('阳光民族幼儿园', '起点幼儿园')演示了name为阳光民族幼儿园和起点幼儿园的要素。

1.5 `IS NULL`

通过IS NULL设置条件判断值为空的要素。如下通过name IS NULL演示了name为空的要素，因为数据中没有name为空的，所以结果为一片空白。

1.6 `NOT` 取反

通过NOT 可进行取反操作，如：

name NOT in ('阳光民族幼儿园', '起点幼儿园')
name NOT LIKE '%艺术%'
num NOT BETWEEN 100 AND 110
NOT (num <> 110)，跟num = 110结果一样
name IS NOT NULL

1.7 时间过滤

时间过滤的条件有：

BEFORE ,如time BEFORE '2024-03-31'表示过滤时间在2024-03-31之前的要素
DURING,过滤时间在一个时间段内的要素
AFTER，如time AFTER '2024-03-31'表示过滤时间在2024-03-31之后的要素

1.8 `AND`和`OR`

通过AND和OR可进行多条件组合进行过滤，AND表示多个条件同时满足，OR表示多个条件有一个满足。如name like '%阳光%' and num > 100表示名称包含“阳光”且num大于100的要素。

2.空间过滤

在Geoserver中支持的空间过滤有:

INTERSECTS(Expression , Expression),相交判断，如intersects(the_geom, POLYGON ((106.550313472803 33.6939631715481,111.906007263598 33.5633364937238,111.710067246862 28.8607760920502,106.550313472803 29.3832828033473,106.550313472803 33.6939631715481)))
DISJOINT(Expression , Expression),相离判断，其结果与INTERSECTS相反，如DISJOINT(the_geom, POLYGON ((106.550313472803 33.6939631715481,111.906007263598 33.5633364937238,111.710067246862 28.8607760920502,106.550313472803 29.3832828033473,106.550313472803 33.6939631715481)))
CONTAINS(Expression , Expression),CONTAINS(a, b)表示a包含b，使用使需要注意参数的顺序
WITHIN(Expression , Expression)，WITHIN(a, b)表示a在b里面，使用使需要注意参数的顺序，如WITHIN(the_geom, POLYGON ((106.550313472803 33.6939631715481,111.906007263598 33.5633364937238,111.710067246862 28.8607760920502,106.550313472803 29.3832828033473,106.550313472803 33.6939631715481)))
TOUCHES(Expression , Expression)，边界相交，在边界处至少有一个点相交，但是在内部不相交
CROSSES(Expression , Expression)，交叉判断，多为线要素和其他要素的判断
OVERLAPS(Expression , Expression) ，判断同一类型的要素是否有重叠
RELATE(Expression , Expression , pattern)，相关联
DWITHIN(Expression , Expression , distance , units)，DWITHIN(the_geom, POLYGON ((106.550313472803 33.6939631715481,111.906007263598 33.5633364937238,111.710067246862 28.8607760920502,106.550313472803 29.3832828033473,106.550313472803 33.6939631715481)), 3, meters)表示先将b向外扩3m在做逻辑判断，单位可为feet, meters, statute miles, nautical miles, kilometers
BEYOND(Expression , Expression , distance , units)，语法上跟DWITHIN一样，结果上刚好相反，如BEYOND(the_geom, POLYGON ((106.550313472803 33.6939631715481,111.906007263598 33.5633364937238,111.710067246862 28.8607760920502,106.550313472803 29.3832828033473,106.550313472803 33.6939631715481)), 3, meters)
BBOX(Expression , Number , Number , Number , Number [ , CRS ] )，通过四至进行过滤，其中CRS为非必填参数，如bbox(the_geom, 106.55,28.86, 111.90,33.69)表示过滤四至在106.55,28.86, 111.90,33.69之内的要素。