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/v1/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.

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.