Programming Guide - WeatherSentry® Web Feature Service

Version 10


    Overview

     

    WeatherSentry® Web Feature Service (WFS) is a version 1.0.0 and 1.1.0 OGC WFS. WFS has three primary functions:

     

    • GetCapabilities: Returns an XML document cataloging available weather content. The catalog provides a Title and Abstract to describe each feature type (analogous to layer in WMS) in more detail. GetCapabilities contains only the feature types available for the package(s) you’ve purchased.
    • DescribeFeatureType: Returns an XML document describing the attributes of a feature type. In addition, every feature type is described in the next section of this document, followed by a description of its attributes.
    • GetFeature: Returns an XML document containing data for the feature type or feature types you’ve requested.

     

    Release Management

    As features and enhancements are added, new revisions will become available. If the change causes a reverse compatibility issue, we will release it under a new major revision. An example of this would be a layer name change or removal.

     

    Major revisions are part of the url. e.g. http://weather-services.telventdtn.com/digest/wfs_v{X} where {X} is the major revision number. (e.g. http://weather-services.telventdtn.com/digest/wfs_v1) Only the two latest major revisions are supported at any given time. Therefore, when we release a major revision, we will remove the link to the oldest major revision, which we will no longer support.

     

    For example: If version 1 and 2 currently exist, at the release of version 3 we will remove all the links to version 1 and will no longer support that version.

     

    Back to top

     

    Authentication

     

    Using our WFS requires an account. If you don't have an account, contact Sales toll-free at (800) 610-0777, or +34 91 714-7002 outside of North America.

     

    Currently HTTP Basic over SSL, HTTP Digest, and OAuth1 are supported. Other authentication protocols will be coming in subsequent releases.

     

    Back to top

     

    Base URL

     

    A WFS request consists of a base URL, followed by request parameters.

     

    Base WFS URL:

    For HTTP Basic: https://weather-services.telventdtn.com/basic/wfs_v1/wfs.wsgi?

    For HTTP Digest: http://weather-services.telventdtn.com/digest/wfs_v1/wfs.wsgi?

    For OAuth 1.0a: http://weather-services.telventdtn.com/oauth/wfs_v1/wfs.wsgi?

     

    Accessing the Capabilities Document

    Once you have a login to the service you can make a request for GetCapabilities.

     

    The GetCapabilities request provides an XML catalog file of all the layers and inforamtion available through the service - including feature specific data availability information.

     

    Visit the GetCapabilities link at:

    http://weather-services.telventdtn.com/digest/wfs_v1/wfs.wsgi?REQUEST=GetCapabilities&VERSION=1.0.0

     

    DescribeFeatureType Request

    You can get attribute and data type information about a feature type by making a DescribeFeatureType request. A DescribeFeatureType request consists of a base URL, followed by request parameters.

     

    Example DescribeFeatureType request:

    http://weather-services.telventdtn.com/digest/wfs_v1/wfs.wsgi?VERSION=1.0.0&SERVICE=WFS&REQUEST=DescribeFeatureType&TYPENAME=CURRENT_OBSERVATIONS

     

     

    ParameterDescriptionRequired/OptionalValid ValuesDefault Value
    SERVICE=WFSThe name of the service. In this case, Web Feature Service.RequiredWFS
    REQUEST=DescribeFeatureTypeType of WFS request.RequiredGetFeature
    VERSION=versionThe version of the requested WFS service.Optional1.0.0 or 1.1.01.0.0
    TYPENAME=featuretype_listComma-separated list of feature types.RequiredIndividually listed in the capabilities file.

    Table 1: DescribeFeatureType Request Parameters

     

    GetFeature Request

    You can get features within a geographic and/or temporal area by using the GetFeature request. A GetFeature request consists of a base URL, followed by request parameters.

     

    Example GetFeature request:

    http://weather-services.telventdtn.com/digest/wfs_v1/wfs.wsgi?VERSION=1.0.0&SERVICE=WFS&REQUEST=GetFeature&TYPENAME=CURRENT_OBSERVATIONS&BBOX=-93.5,44.7,-93.1,45.1,EPSG:4326&EXCEPTIONS=XML&MAXFEATURES=1

     

     

    ParameterDescriptionRequired/OptionalValid ValuesDefault Value
    SERVICE=WFSThe name of the service. In this case, Web Feature Service.RequiredWFS
    REQUEST=GetFeatureType of WFS request.RequiredGetFeature
    VERSION=versionThe version of the requested WFS service.Optional1.0.0 or 1.1.01.0.0
    TYPENAME=featuretype_listComma-separated list of feature types.RequiredIndividually listed in the capabilities file.
    BBOX=minx,miny,maxx,maxy,csruriBounding box corners (lower left, upper right) in units specified by csruri.OptionalFour comma-delimited numeric values, plus optional CRS URI.
    FILTER=valueXML filter describing set of features to operate on.OptionalSee Filter Encoding Specification.Feature type specific.
    EXCEPTIONS=XMLThe format in which exceptions are reported.OptionalXMLXML
    STARTINDEX=NThis parameter indicates the index within the result set from which the server shall begin presenting results in the response.OptionalInteger1
    MAXFEATURES=NA positive integer indicating the maximum number of features that the WFS should return in response to a query. If no value is specified then only 10,000 features will be returned.OptionalInteger10000

    Table 2: GetFeature Request Parameters

     

    Exceptions and Errors

    When a request experiences errors, an error message will indicate what happened according to the format of the Exceptions type.

     

    Back to top