DescribeCoverage Operation |
The DescribeCoverage action is a required action.
The DescribeCoverage operation allows a client to request a full description of one or more raster layers of a WCS service. The server returns a description of the requested XML document for the Coverage layer detailed information.
The client should send a Get request encoded in KVP.
The main request parameters of DescribeCoverage operation are shown in the following table:
Table 1 Main Parameters of Describe Coverage Operation Request
| Request parameters | Whether it is required | Description |
| SERVICE=WCS |
Yes |
Aervice type Request WCS Service. The request type needs to be set to " WCS ". |
| REQUEST=DescribeCoverage |
Yes |
Request name Request DescribeCoverage operation, the request name needs to be set to 'DescribeCoverage' |
|
Version |
Yes |
The version of the requested WCS service. |
|
Identifiers |
Yes |
Specify the layer to request. identifiers=identifier1, identifier2,…… |
Note: The case of the parameters is not required, and the order of the request parameters can also be arranged in any order.
DescribeCoverage operations are requested as follows:
<ServiceRoot>?SERVICE=WCS&REQUEST=DescribeCoverage&Version=1.1.1&Identifiers=*,*
ServiceRoot is the URI root directory of the service. Please refer to URI settings .
For example, after the local iServer service is started, the XML document returned by the GetCapacities request to the data-world/wcs111 service introduces the relevant information of the current service and the Coverage layer information available in the service. Please refer to the GetCapacities operation for details. It can be seen that data-world/wcs111 provides two available Coverage layers, and the Identifiers are respectively: 1 and 2. In this example, Identifier is 1, which is the detailed information of Day @ World, and the request URI is as follows:
http://localhost:8090/iserver/services/data-world/wcs111?SERVICE=WCS&REQUEST=DescribeCoverage&Version=1.1.1&Identifiers= 1
See the Response Example for the returned response results.
The server will return an XML document describing the detailed information of each requested Coverage data, that is, each Coverage CoverageDes cription.
CoverageDescription contains the following key elements:
Table 2 Contents Returned by Describe Coverage Operation
| Element name | Whether it is required | Description |
| (Description) |
Yes |
Description of Coverage |
|
Identifier |
Yes |
The unique identifier of the current coverage |
|
Metadata |
No |
More information oncurrent Coverage |
|
Domain |
Yes |
The available space-time extent of the current Coverage. See Domain for details. |
|
Range |
Yes |
The range of the current Coverage value. See Range for details. |
|
SupportedCRS |
Yes |
The coordinate reference system that supports the return of data by the GetCoverage operation. |
|
SupportedFormat |
Yes |
Support the format of data returned by the FHIR overage operation. Such as GeoTIFF, HDF-EOS, NITF, CF NetCDF, etc. |
Domain is divided into two types: SpatialDomain (required parameter) and TemporalDomain (optional parameter). The former represents the spatial range of the current Coverage, while the latter represents the time point sequence or time interval sequence of the current Coverage.
The main labels of SpatialDomain are shown in Table 3.
TemporalDomain is mainly composed of Timestamp sequence, which is determined by TimePositionOrInterval, that is, TimePosition and TimePeriod ultimately determine the time domain. The parameters for defining TimePeriod are shown in Table 4.
Table 3 Main Contents of SpatialDomain
| Element name | Whether it is required | Description |
|
BoundingBox |
Yes |
The bounding box of the current layer. |
|
GridCRS |
No |
The coordinate reference system of the current Coverage. |
|
Transformation |
No |
Current Coverage If projection conversion is required, use this projection conversion method. |
|
ImageCRS |
No |
If the current Coverage does not have GridCRS, you need to use ImageCRS. |
|
Polygon |
No |
The polygon that describes the Domain of the current Coverage. |
Table 4 Parameters of TimePeriod
| Element name | Whether it is required | Description |
|
BeginTime |
Yes |
Start time of the current segment. |
|
EndTime |
Yes |
The end time of the current segment. |
|
TimeResolution |
No |
Time resolution. |
|
frame |
No |
Time frame of reference. |
The range of values in Range is mainly described by Field (required parameter). For example, for grid elevation data or temperature data, this parameter can be used to describe the elevation range or temperature range that can be returned. And A Field is a description of a Range in terms of scalar-valued or vector-valued and contains the following parameters:
Table 5 Main parameters of the Field
| Element name | Whether it is required | Description |
| (Description) |
Yes |
A brief description of the current scope. |
|
Identifier |
Yes |
Unique identification of the current scope. |
|
Definition |
Yes |
More definition information for the current scope, including meaning, units, etc. |
|
NullValue |
No |
If there are no legal range values, this parameter is used. |
|
InterpolationMethods |
Yes |
Difference value method, the difference value method supported by the server for the available value range (Field) of current Coverage. |
|
Axis |
No |
The control variables for the vector range, namely the coordinate axis scale values, are detailed in Table 6. |
Table 6 Main parameters of Axis
| Element name | Whether it is required | Description |
| (Description) |
Yes |
Brief description of Axis. |
|
Identifier |
Yes |
Unique identification of the current Axis. |
|
AvailableKeys |
Yes |
List of Key values for the current Axis. Contains the child element Key, which is used to represent a key value. |
|
Meaning |
No |
The meaning or significance of the current Axis value. |
|
DataType |
No |
Current Axis value data type. |
|
ValuesUnit |
No |
If necessary, the unit reference system of the current Axis value is provided through this parameter. |
|
Metadata |
No |
Supplementary information on these numerical domain elements. |
Day@World in the data-world/wcs111 service in the request sample After the image data executes the DescribeCoverage request, the XML document returned by the server is as follows: