Connect to a WFS service
A Web Feature Service (WFS) is a web service for querying spatial data that has a standardized API that is defined by the Open Geospatial Consortium (OGC). The WfsClient
class in the spatial IO module lets developers connect to a WFS service and query data from the service.
The following features are supported by the WfsClient
class:
Supported versions:
1.0.0
,1.1.0
, and2.0.0
Supported filter operators: binary comparisons, logic, math, value, and
bbox
.Requests are made using
HTTP GET
only.Supported operations:
Operation Description GetCapabilities Generates a metadata document with valid WFS operations and parameters GetFeature Returns a selection of features from a data source DescribeFeatureType Returns the supported feature types
Using the WFS client
The atlas.io.ogc.WfsClient
class in the spatial IO module makes it easy to query a WFS service and convert the responses into GeoJSON objects. This GeoJSON object can then be used for other mapping purposes.
The following code queries a WFS service and renders the returned features on the map.
Supported filters
The specification for the WFS standard makes use of OGC filters. The filters below are supported by the WFS client, assuming that the service being called also supports these filters. Custom filter strings can be passed into the CustomFilter
class.
Logical operators
And
Or
Not
Value operators
GmlObjectId
ResourceId
Math operators
Add
Sub
Mul
Div
Comparison operators
PropertyIsEqualTo
PropertyIsNotEqualTo
PropertyIsLessThan
PropertyIsGreaterThan
PropertyIsLessThanOrEqualTo
PropertyIsGreaterThanOrEqualTo
PropertyIsLike
PropertyIsNull
PropertyIsNil
PropertyIsBetween
The following code demonstrates the use of different filters with the WFS client.
WFS service explorer
The following code uses the WFS client to explore WFS services. Select a property type layer within the service and see the associated legend.
To access WFS services hosted on non-CORS enabled endpoints, a CORS enabled proxy service can be passed into the proxyService
option of the WFS client as shown below.
//Create the WFS client to access the service and use the proxy service settings
client = new atlas.io.ogc.WfsClient({
url: url,
proxyService: window.location.origin + '/YourCorsEnabledProxyService.ashx?url='
});
Next steps
Learn more about the classes and methods used in this article:
See the following articles for more code samples to add to your maps:
Feedback
Submit and view feedback for