Home > Develop > Documentation > API > OGC API > WFS request

WFS request

WFS request

The Sentinel WFS (Web Feature Service) service conforms to the WFS standard. It provides access to the geometric (vector) metadata about Sentinel-2 tiles. As with the WMS service, WFS is also only available via a user-preconfigured custom server instance URL.

The base URL for the WFS service:

http://services.sentinel-hub.com/ogc/wfs/{INSTANCE_ID}

The service supports many vector formats, including GML, XML, JSON and also raw HTML and plain text. Check GetCapabilities for a list of all supported formats. It supports WFS versions 1.0.0 and 2.0.0.

WFS URL parameters

Standard common WFS URL parameters (parameter names are case insensitive):

WFS parameter info

SERVICE

Required, must be "WFS".

VERSION

WFS version standard. Optional, default: "2.0.0". Supported values: "1.0.0" and "2.0.0".

REQUEST

What is requested, valid values: DescribeFeatureType, GetFeature or GetCapabilities. Required.

TIME

(when REQUEST = GetFeature) The time or time range for which to return the results, in ISO8601 format (year-month-date, for example: 2016-01-01). When a single time is specified the service will return data until the specified time. If a time range is specified the result is based on all scenes between the specified dates conforming to the cloud coverage criteria and stacked based on priority setting - e.g. most recent on top. The time range is written as two time values separated by a slash, followed by a second slash and a period parameter (which must be P1D). Optional, default: none (the last valid image is returned). Examples: "TIME=2016-01-01", "TIME=2016-01-01/2016-02-01/P1D".

In addition to the standard WFS request parameters the WFS service also supports many custom URL parameters. See Custom service URL parameters for details.

Standard GetFeature request URL parameters:

WFS parameter info

TYPENAME

When version = 1.0.0, the name of the data to be returned. Valid value: "TILE" as only the tile's metadata is returned.

TYPENAMES

When version = 2.0.0, the name of the data to be returned. Valid value: "TILE" as only the tile's metadata is returned.

MAXFEATURES

The maximum number of features to be returned by a single request. Default value: 100. Valid range: 0..100.

BBOX

The bounding box area for which to return the features.

SRSNAME

The CRS in which the BBOX is specified.

FEATURE_OFFSET

Offset controls the starting point within the returned features.

OUTPUTFORMAT

The MIME format of the returned features.

Standard DescribeFeatureType request URL parameters:

WFS parameter info

TYPENAME

When version=1.0.0, the name of the data to be returned. Valid value: "TILE", as only the tile's metadata is returned.

TYPENAMES

When version=2.0.0, the name of the data to be returned. Valid value: "TILE", as only the tile's metadata is returned.

OUTPUTFORMAT

The MIME format of the returned features.