Web Coverage Service (WCS)

A Web Coverage Service (WCS) offers multi-dimensional coverage data for access over the Internet.

The standard can be obtained from the Open Geospatial Consortiums homepage.

The following tables provide an overview over the available WCS request parameters for each operation supported by EOxServer.

GetCapabilities

Table: “WCS GetCapabilities Request Parameters” below lists all parameters that are available with Capabilities requests.

WCS GetCapabilities Request Parameters

Parameter

Description / Subparameter

Allowed value(s) / Example

Mandatory (M) / Optional (O)

service

Requested service

WCS

M

request

Type of request

GetCapabilities

M

acceptVersions [1]

Prioritized sequence of one or more specification versions accepted by the client, with preferred versions listed first (first supported version will be used) version1[,version2[,…]]

2.0.1, 1.1.2, 1.0.0

O

sections

Comma-separated unordered list of zero or more names of zero or more names of sections of service metadata document to be returned in service metadata document. Request only certain sections of Capabilities Document section1[,section2[,…]]

  • DatasetSeriesSummary

  • CoverageSummary

  • Contents

  • All

  • ServiceIdentification

  • ServiceProvider

  • OperationsMetadata

  • Languages

O

updateSequence

Date of last issued GetCapabilities request; to receive new document only if it has changed since

“2013-05-08”

O

DescribeCoverage

Table: “WCS DescribeCoverage Request Parameters” below lists all parameters that are available with DescribeCoverage requests.

WCS DescribeCoverage Request Parameters

Parameter

Description / Subparameter

Allowed value(s) / Example

Mandatory (M) / Optional (O)

service

Requested service

WCS

M

request

Type of request

DescribeCoverage

M

version [1]

Version number

2.0.1

M

coverageId

NCName(s):

  • valid coverageID of a Dataset

  • valid coverageID of a StichedMosaic

M

DescribeEOCoverageSet

Table: “EO-WCS DescribeEOCoverageSet Request Parameters” below lists all parameters that are available with DescribeEOCoverageSet requests.

EO-WCS DescribeEOCoverageSet Request Parameters

Parameter

Description / Subparameter

Allowed value(s) / Example

Mandatory (M) / Optional (O)

service

Requested service

WCS

M

request

Type of request

DescribeEOCoverageSet

M

version [1]

Version number

2.0.1

M

eoId

Valid eoId:

  • using the coverageId of a Datatset

  • using the eoId of a DatatsetSeries

  • using the coverageId of a StitchedMosaic

M

subset

Allows to constrain the request in each dimensions and define how these parameters are applied.

The spatial constraint is expressed in WGS84, the temporal constraint in ISO 8601.

Spatial trimming: Name of an coverage axis (Long or Lat) Temporal trimming: phenomenonTime Plus optional either:

  • containment = overlaps (default)

  • containment = contains

Any combination thereof (but each value only once per request)

  • Lat(32,47)

  • Long(11,33)

  • phenomenonTime(“2006-08-01”, “2006-08-22T09:22:00Z”)

  • Lat(32,47)&Long(11,33)& phenomenonTime(“2006-08-01”& “2006-08-22T09:22:00Z”)& containment=contains

O

containment

see subset parameter

  • overlaps (default)

  • contains

O

section

see GetCapabilities

  • DatasetSeriesSummary

  • CoverageSummary

  • All

O

count

Limits the maximum number of DatasetDescriptions returned in the EOCoverageSetDescription.

10

O

GetCoverage

Table: “EO-WCS GetCoverage Request Parameters” below lists all parameters that are available with GetCoverage requests.

EO-WCS GetCoverage Request Parameters

Parameter

Description / Subparameter

Allowed value(s) / Example

Mandatory (M) / Optional (O)

service

Requested service

WCS

M

request

Type of request

GetCoverage

M

version [1]

Version number

2.0.1

M

coverageId

NCName(s):

  • valid coverageID of a Dataset

  • valid coverageID of a StichedMosaic

M

format

Requested format of coverage to be returned. By default the coverage is returned in its original format.

image/tiff

O

mediatype

Coverage delivered directly as image file or enclosed in GML structure

  • not present or

  • multipart/mixed

multipart/mixed

O

subset

Trimming of coverage dimension (no slicing allowed!)

  • the label of a coverage axis

    • The meaning of the subset can be altered by the subsettingCrs parameter.

  • x(400,200)

  • Lat(12,14)

  • Long(17,17.4)

O

subsettingCrs

The CRS the subsets are expressed in. This also defines the output CRS, if no further outputCrs is specified. If no subsettingCrs is given, pixel coordinates are assumed.

http://www.opengis.net/def/crs/ EPSG/0/4326

O

outputCrs

CRS for the requested output coverage

  • not present or

  • CRS

http://www.opengis.net/def/crs/ EPSG/0/3035

O

rangesubset

Subsetting in the range domain (e.g. Band-Subsetting).

  • Blue,Green,Red

  • Band1:Band3,Band5,Band7:Band9

O

scaleFactor

Scale the output by this factor. The ‘scaleFactor’ parameter requires MapServer v7.0.

  • 0.5

  • 1.25

O

  • scaleAxes

  • scaleSize

  • scaleExtent

Mutually exclusive per axis, either:

  • a scale factor (per axis)

  • absolute pixel size as integer (per axis)

  • the size given as extent (per axis). This is internally translated to a ‘scaleSize’

The ‘scaleAxes’ parameter requires MapServer v7.0.

  • scaleAxes=x(1.5),y(0.5)

  • scaleSize=x(50),y(100)

  • scaleExtent=long(50:100)

O

interpolation [2]

Interpolation method to be used

  • http://www.opengis.net/def/interpolation/OGC/1/ nearest-neighbour (default)

  • http://www.opengis.net/def/interpolation/OGC/1/ average

  • http://www.opengis.net/def/interpolation/OGC/1/ bilinear

bilinear

O

geotiff:compression [3]

The internal compression method used. One of:

  • None

  • PackBits

  • Huffman

  • LZW

  • JPEG

  • Deflate

LZW

O

geotiff:jpeg_quality [3]

The quality of the JPEG compression when this compression method is used. Must be an integer between 1 and 100.

75

O

geotiff:predictor [3]

The predictor method used for the Deflate or LZW compression. One of:

  • None

  • Horizontal

  • FloatingPoint

Horizontal

O

geotiff:interleave [3]

Defines how the output image shall be interleaved. One of:

  • Pixel

  • Band

Horizontal

O

geotiff:tiling [3]

Defines whether or not the image shall be internally tiled. Must be a boolean value (true/false). If this is set to ‘true’, also a tilewidth and tileheight must be specified.

true

O

geotiff:tilewidth [3]

Defines the width of the internal tiles. Must be an integer and a multiple of 16.

256

O

geotiff:tileheight [3]

Defines the height of the internal tiles. Must be an integer and a multiple of 16.

128

O