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 the available dataset tiles. As with the WMS service, WFS is also only available via a user-preconfigured custom server instance URL.

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: http://services.sentinel-hub.com/ogc/wfs/{INSTANCE_ID}

For eocloud: http://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.

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 parameter info

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) 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

TYPENAMES

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

Data source TYPENAMES for AWS services TYPENAMES 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

DSS6

L8.TILE

LANDSAT 7

/

L7.TILE

LANDSAT 5

/

L5.TILE

MODIS

DSS5

/

ENVISAT MERIS

/

ENV.TILE

BYOC

DSS10-<ByocCollectionID>

/

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

TYPENAMES

See TYPENAMES above.

OUTPUTFORMAT

The MIME format of the returned features.