Functions to construct a CQL expression to be used
to filter results from bcdc_query_geodata()
.
See the geoserver CQL documentation for details.
The sf object is automatically converted in a
bounding box to reduce the complexity of the Web Feature Service call. Subsequent in-memory
filtering may be needed to achieve exact results.
EQUALS(geom)DISJOINT(geom)
INTERSECTS(geom)
TOUCHES(geom)
CROSSES(geom)
WITHIN(geom)
CONTAINS(geom)
OVERLAPS(geom)
BBOX(coords, crs = NULL)
DWITHIN(
geom,
distance,
units = c("meters", "feet", "statute miles", "nautical miles", "kilometers")
)
a CQL expression to be passed on to the WFS call
an sf
/sfc
/sfg
or bbox
object (from the sf
package)
the coordinates of the bounding box as four-element numeric
vector c(xmin, ymin, xmax, ymax)
, a bbox
object from the sf
package (the result of running sf::st_bbox()
on an sf
object), or
an sf
object which then gets converted to a bounding box on the fly.
(Optional) A numeric value or string containing an SRS code. If
coords
is a bbox
object with non-empty crs, it is taken from that.
(For example, 'EPSG:3005'
or just 3005
. The default is to use the CRS of
the queried layer)
numeric value for distance tolerance
units that distance is specified in. One of
"feet"
, "meters"
, "statute miles"
, "nautical miles"
, "kilometers"