SIGN IN

WFS Request

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

See our OGC API Webinar, which will guide you through different OGC services, including WFS, help you understand the structure, show you how to run the requests in different environments and how they can be integrated with QGIS, ArcGIS and web applications.

There are two available server sites, that can be accessed via WFS requests; "services" and "eocloud". When making WFS requests, it is important to realize which one is being used, since data IDs, called TYPENAMES, url paths and INSTANCE_ID’s differ.

The base URL for the WFS service:

For AWS services: https://services.sentinel-hub.com/ogc/wfs/{INSTANCE_ID}

For eocloud: https://eocloud.sentinel-hub.com/v1/wfs/{INSTANCE_ID}

For AWS services, Instance ID should be obtained from the account in main dashboard.

For eocloud, Instance ID should be obtained from the account in eocloud wms configurator. Contact us to create an account.

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 version 2.0.0.

WFS URL Parameters

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

WFS parameterinfo

SERVICE

Required, must be "WFS".

VERSION

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

REQUEST

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

TIME

(when REQUEST = GetFeature or DescribeFeatureType) The time or time range for which to return the results, in ISO8601 format (year-month-dateThours:minutes:seconds, for example: 2016-01-01T10:05:23Z). 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. Optional, default: none (the last valid image is returned). Examples: "TIME=2016-01-01T10:05:23Z", "TIME=2016-01-01/2016-02-01".

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 parameterinfo

TYPENAMES

The name of the data to be returned. Valid values for different data collections, as only the tile's metadata is returned:

data collectionTYPENAMES for AWS servicesTYPENAMES for eocloud

SENTINEL-2 L1C

DSS1

S2.TILE

SENTINEL-2 L2A

DSS2

/

SENTINEL-1 IW

DSS3

S1.TILE

SENTINEL-1 EW

DSS3

S1_EW.TILE

SENTINEL-1 EW SH

DSS3

S1_EW_SH.TILE

SENTINEL 3 OLCI

DSS8

S3.TILE

SENTINEL 3 SLSTR

DSS9

/

SENTINEL 5P

DSS7

S5p_L2.TILE

LANDSAT 8 L1 (from Collection 2)*

DSS12

/

LANDSAT 8 L2 (from Collection 2)

DSS13

/

LANDSAT 4-5 TM Level 1

DSS15

/

LANDSAT 4-5 TM Level 2

DSS16

/

LANDSAT 7 ETM Level 1

DSS17

/

LANDSAT 7 ETM Level 2

DSS18

/

LANDSAT 1-5 MSS Level 1

DSS14

/

LANDSAT 7**

/

L7.TILE

LANDSAT 5**

/

L5.TILE

MODIS

DSS5

/

ENVISAT MERIS

/

ENV.TILE

BYOC

byoc-<collectionId>

/

BATCH

batch-<collectionId>

/

*Note that Landsat 8 Level 1 from collection 1, known as L8L1C with a typename DSS6, has been deprecated and removed from the table. Use Landsat 8 level 1 from collection 2 instead.

**Note that Landsat 5 is a different collection than the Landsat 4-5TM. The former is only supported in OGC, while the newer Landsat 4-5TM collections, with a full archive from USGS, are supported in process API as well. Same is true for the older Landsat 7 collection and newer Landsat 7 ETM collections.

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 parameterinfo

TYPENAMES

See TYPENAMES above.

OUTPUTFORMAT

The MIME format of the returned features.