GetCapabilities
Exploring the WFS capabilities
Last updated
Exploring the WFS capabilities
Last updated
Back in the jungle, it would be a good idea to get an overview!
Especially what the WFS you want to use is able to deliver.
I myself didn't pay much attention to the GetCapabilities-Request in the past.
But the GetCapabilities-document contains really useful information!
So let's explore it.
I'll use the cadastral parcel service of North Rhine-Westphalia subsequently.
It's GetCapabilities-URL is:
If you don't know the GetCapabilities-URL of the WFS you're using, add a OGC WFS (Web Feature Service) Reader to your FME Workbench.
Then open [Parameters ...], paste the WFS-URL in [URL], select a [Feature Type] and set [Max Features] to a small number, e.g. like this:
Next [Run Just This].
FME sends a request to the service and will get the number of features you specified before.
Now, remember your friend: the Translation Log
Scroll upwards!
You'll see some blue colored URLs. We need the <WFS> Capabilities URL.
Double click or copy & paste it to your browser.
Now we will collect some relevant information.
AcceptVersions tells you, which WFS versions are supported. Other WFS may support more than one version, e.g.
To know the WFS version is important, because you have to use the corresponding filter expression version! We will have a look at it later.
Generally you should use version 2.0.0 if your WFS supports it.
Next, have a look at CountDefault.
The WFS 2.0 specification says about it: "If the server does have a server configured count limit, that limit shall be advertised in the server's capabilities document using the CountDefault constraint."
In case of our WFS just try it: set Max Feature to nothing and run it.
Result: the WFS returns exactly 100.000 features (approx. 180 MB).
Next scroll down to the section named FeatureTypeList and the FeatureType you want to use, here CadastralParcel:
Write down the DefaultCRS (Coordinate Reference System)!
It will be relevant when we deal with spatial filters.
Continue scrolling down until you see
There are many intersting things, but we will focus on these three!
Comparison Operators are the same as you may know using SQL:
PropertyIsEqualTo means "="
PropertyIsNotEqualTo means "!="
PropertyIsLessThan means "<"
and so on
You guess it!
Spatial Operators may be more interesting:
I suggest, that you're familiar with spatial operations!?
We will focus on some of them, especially the Bounding Box (BBOX).
Using Logical Operators like AND, OR and NOT, you'll be able to combine two or more of the above operators, i.e.
attribute with attribute comparisons
attribute with spatial comparisons
Unfortunately, not all WFS support logical operators. You have to try (and error)!
Wrap it up!
Let's practice ...
As we're dealing with metadata, would it be interesting for you to know the total number of features in one Feature Type for example CadastralParcels? (Not the total quantity/sum of all features in different Feature Types a WFS holds available).
Yes?
Caution: the keyword resultType is case sensitive!
As a result
becomes to
Open this new URL in your favorite browser, safe and open the returned XML document.
You can see, that on September, ninth, there are 9.359.425 cadastral parcel features.
<
<>
<>
If so, grab the GetFeature URL from the Translation Log (will be explained in detail in ), delete anything starting with "&NAMESPACES=xmlns..." and replace it by "&resultType=hits" (make sure to keep your Feature Type which is defined in TYPENAMES).
