WMS/WFS API
The Cocon Fiber WMS/WFS API exposes assets using the WMS/WFS standard. The features currently exposed via the WMS/WFS API are listed below.
API Security
The WMS/WFS APIs currently use a different mechanism for authentication than the other APIs; HTTP Basic Authentication. This means that for these APIs a username and password have to be supplied, instead of the regular authentication headers.
So in order for a consuming system to authenticate itself to the WMS/WFS APIs, it has to provide authentication information via the following HTTP request header parameter:
- Authorization (containing username and password according to the BasicAuth header format)
Values for both parameters are provided by Speer IT.
Usage Guidelines
There are certain specifics with regard to the use of the WMS/WFS API, which are described below.
General usage
The general structure of a WFS request is as follows:
GET wmswfsapi/ows?service=WFS&version=1.0.0&request=GetFeature&typeName={feature_name}&bbox={bounding_box}&maxFeatures={max_number_of_features}&outputFormat=application/json|
The general structure of a WMS request is as follows:
GET wmswfsapi/wms?service=WMS&version=1.1.0&request=GetMap&layers={feature_name}&bbox={bounding_box}&width=380&height=768&srs=EPSG%3A3044&styles=&format=image%2Fpng|
Refer to https://geoserver.org/ for more information about the available options for WMS and WFS requests.
Available WMS/WFS features
The WMS/WFS API exposes the following features:
| Feature | Geometry type(s) | Attributes | WMS/WFS | Notes |
|---|---|---|---|---|
| Accesspoint | Point | Id (text) Name (text) Type (text) Stage (number) ProjectName (text) | WFS | |
| Building | Polygon | Id (text) Name (text) ComplexName (text) Type (text) Stage (number) ProjectName (text) | WMS & WFS | |
| Cable | Line | Id (text) Name (text) Type (text) Stage (number) ProjectName (text) NumberOfFibers (number) NumberOfAvailableFibers (number) Length (number) EndpointNames (text) | WFS | The EndpointNames are the names of the endpoints on which this cable ends, concatenated by a comma & space. |
| Drilling | Line | Id (text) Name (text) Type (text) Stage (number) ProjectName (text) ExternalOwner (text) | WMS & WFS | |
| Duct | Line | Id (text) Name (text) DuctTypeName (text) NumberOfAvailableInnerducts (number) Length (number) ProjectName (text) LocationNames (text) | WFS | The LocationNames property contains the names of the locations the duct is connected to, concatenated by a comma & space. |
| Enclosure | Point | Id (text) Name (text) Type (text) LocationName (text) Stage (number) ProjectName (text) | WFS | |
| Frame | Point & Polygon | Id (text) Name (text) Type (text) LocationName (text) Stage (number) ProjectName (text) | WFS | Frames contained in Accesspoints will be represented with a Point geometry. Frames contained in Buildings will be represented with a Polygon geometry. |
| LegalInterest | Line | WMS & WFS | Just geometry. |
Availability of features and format (WMS or WFS) may depend on API subscription limitations.