EO-WCS Request Parameters¶
Table of Contents
The following tables provide an overview over the available EO-WCS request parameters for each operation supported by EOxServer.
Please see EOxServer’s Demonstration for complete sample requests.
GetCapabilities¶
Table: “EO-WCS GetCapabilities Request Parameters” below lists all parameters that are available with Capabilities requests.
Parameter | Description / Subparameter | Allowed value(s) / Example | Mandatory (M) / Optional (O) |
---|---|---|---|
→ service | Requested service | WCS | M |
→ request | Type of request | GetCapabilities | M |
→ version [1] | Version number | 2.0.1 | O |
→ 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[,...]] |
|
O |
→ updateSequence | Date of last issued GetCapabilities request; to receive new document only if it has changed since | “2013-05-08” | O |
DescribeCoverage¶
Table: “EO-WCS DescribeCoverage Request Parameters” below lists all parameters that are available with DescribeCoverage requests.
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):
|
M |
DescribeEOCoverageSet¶
Table: “EO-WCS DescribeEOCoverageSet Request Parameters” below lists all parameters that are available with DescribeEOCoverageSet requests.
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:
|
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:
Any combination thereof (but each value only once per request) |
|
O |
→ containment | see subset parameter |
|
O |
→ section | see GetCapabilities |
|
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.
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):
|
M | |
→ format | Requested format of coverage to be returned, currently:
|
image/tiff | M |
→ mediatype | Coverage delivered directly as image file or enclosed in GML structure
|
multipart/mixed | O |
→ subset | Trimming of coverage dimension (no slicing allowed!)
|
|
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
|
http://www.opengis.net/def/crs/ EPSG/0/3035 | O |
→ rangesubset | Subsetting in the range domain (e.g. Band-Subsetting). |
|
O |
→ scaleFactor | Scale the output by this factor. The ‘scaleFactor’ parameter requires MapServer v7.0. |
|
O |
|
Mutually exclusive per axis, either:
The ‘scaleAxes’ parameter requires MapServer v7.0. |
|
O |
→ interpolation [2] | Interpolation method to be used
|
bilinear | O |
→ geotiff:compression [3] | The internal compression method used. One of:
|
LZW | O |
|
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:
|
Horizontal | O |
→ geotiff:interleave [3] | Defines how the output image shall be interleaved. One of:
|
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 |
[1] | (1, 2, 3, 4, 5) Version, acceptVersions: Support for EO-WCS is available only together with WCS version 2.0.1. |
[2] | Interpolation: (Note: Resampling options other than NEAREST can dramatically slow down raster processing). The default (and fastest) is NEAREST. Replaces the target pixel with its NEAREST Neighbor. AVERAGE will compute the average pixel value of all pixels in the region of the disk file being mapped to the output pixel (or possibly just a sampling of them). Generally AVERAGE can be desirable for reducing noise in dramatically downsampled data, and can give something approximating anti-aliasing for black and white linework. BILINEAR will compute a linear interpolation of the four pixels around the target location. BILINEAR can be helpful when oversampling data to give a smooth appearance. |
[3] | (1, 2, 3, 4, 5, 6, 7) These parameters are only used in conjunction with GeoTIFF output. Thus the format parameter must be either ‘image/tiff’ or the “native” format of the coverage maps to GeoTIFF. The specificaiton of this encoding extension can be found here |