The Notes and Samples of WCS110  KVP Request

  1. GetCoverage request

  1. GetCoverage request expressed as Key Value Pairs

Name and examplea

Optionality & use

Definition and format

http://server_address/path/script? Mandatory URL of WCS server GetCoverage operation
service=WCS Mandatory Service name, shall be "WCS"
version=1.1.0 Mandatory Request protocol version
request=GetCoverage Mandatory Name of the operation, shall be
"GetCoverage"
identifier=identifier Mandatory Unique identifier of an available coverage
BoundingBox=47,-71, - 51,66,
urn:ogc:def:crs:EPSG:6.6:6326
6405
Optional, include when
spatial subset desired b
Request a coverage subset defined by the
specified bounding box in the referenced
coordinate reference system
RangeSubset=temp:nearest;
radiance[band[1,2,5]]
(see syntax below)
Optional; include when
requesting values for
only some of the
available fields or field
keys; or non-default
interpolation types on
fields.
Request only some fields OR subsets of
some fields (OR list fields to request nondefault
interpolation on them).
(see syntax below)
format=image/netcdf Mandatory Requested output format of Coverage. Shall
be one of those listed in the description of
the selected coverage
store=true Optional, include when
supported and not false
Specifies whether response coverage should
be stored, remotely from client at network
URL, a boolean value
GridBaseCRS=urn:ogc:def:crs:EP
SG:6.6:32618
Optional, include all of
five GridCRS
parameters, except for
defaulted parameters, to
request output in a CRS
other than the
ImageCRS of stored
coverage
Reference to baseCRS of desired output
GridCRS, a URN c
GridType=urn:ogc:def:method:W
CS:1.1:2dGridIn2dCrs
Reference to grid type of desired output
GridCRS, a URN c, d
GridOrigin=0,0 Position coordinates of one possible grid
origin, in baseCRS of desired output
GridCRS c, f
GridOffsets=1000,1000 Offsets between adjacent grid points, in
baseCRS of desired output GridCRS c, g

a. All parameter names are here listed using mostly lower case letters. However, any parameter name       capitalization shall be
allowed in KVP encoding, see Subclause 11.5.2 of [OGC 05-008].
b. At least one of BoundingBox and TimeSequence shall be included. WCS use of this BoundingBox is further specified in
Subclause 7.7 of OGC 06-083r8.
c. The GridType parameter shall reference the known definition of a grid type for a GridCRS, as specified in Annex G of OGC 06-083r8.. That
GridType definition shall specify the meanings of the other "Grid..." parameters listed, including the number of dimensions in each
other "Grid..." parameter.

d. This GridType may be omitted when the GridBaseCRS is 2D, in which case the default value
"urn:ogc:def:method:WCS:1.1:2dSimpleGrid" shall be used.
e. This GridCS may be omitted when the GridBaseCRS is 2D, in which case the default value shall be
"urn:ogc:def:cs:OGC:0.0:Grid2dSquareCS".
f. This GridOrigin may be omitted when the GridBaseCRS is 2D, in which case the default value shall be "0.0 0.0".
g. When the GridType is "urn:ogc:def:method:WCS:1.1:2dGridIn2dCrs", there shall be four values in this GridOffsets. The center
two of these offsets will be zero when the GridCRS is not rotated or skewed in the GridBaseCRS.

RangeSubset = FieldSubset
FieldSubset = FieldId [ ":" Interpolation ] [ "[" AxisSubsets "]" ]
AxisSubsets = AxisSubset *( "," AxisSubset )
AxisSubset = AxisId "[" Keys "]"
Keys = Key *( "," Key )
FieldId = <field identifier, as defined in Subclause 9.3.1.3 and Table 19 of OGC 06-083r8>
AxisId = <axis identifier, as defined in Subclause 9.3.1.3 and Table 20 of OGC 06-083r8>
Key = <key, as defined in Subclause 9.3.1.3 and Table 21 of OGC 06-083r8>
Interpolation = <interpolation type identifier, as defined in Table I.7 of OGC 06-083r8>

  1. Cases
  • http://data.laits.gmu.edu:8080/cgi-bin/wcs110?service=WCS&version=1.1.0&request=GetCoverage&identifier=NETCDF:"/Data/G12IR04D20011009181600.nc":Band4_TEMP&format=image/geotiff
  • http://data.laits.gmu.edu:8080/cgi-bin/wcs110?service=WCS&version=1.1.0&request=GetCoverage&identifier=NETCDF:"/Data/G12IR04D20011009181600.nc":Band4_TEMP&BoundingBox=-100,30,-85,40,urn:ogc:def:crs:OGC:2:84&format=image/geotiff
  • http://data.laits.gmu.edu:8080/cgi-bin/wcs110?service=WCS&version=1.1.0&request=GetCoverage&identifier=NETCDF:"/Data/G12IR04D20011009181600.nc":Band4_TEMP&BoundingBox=-100,30,-85,40,urn:ogc:def:crs:OGC:2:84&RangeSubset=Band31_TEMP:linear[band[1]]&format=image/geotiff
  • http://data.laits.gmu.edu:8080/cgi-bin/wcs110?service=WCS&version=1.1.0&request=GetCoverage&identifier=NETCDF:"/Data/G12IR04D20011009181600.nc":Band4_TEMP&BoundingBox=-100,30,-85,40,urn:ogc:def:crs:OGC:2:84&RangeSubset=Band31_TEMP:linear[band[1]]&format=image/geotiff&GridBaseCRS=urn:ogc:def:crs:EPSG:6.6:6371229&GridOffsets=1000,1000&GridOrigin=-900000.,1300000.0&store=true
    1. samples of KVP for parameters

    1. GetCapabilities request

    1. Parameters in GetCapabilities operation request

       

    Names Multiplicity Server implementation Client implementation
    service One (mandatory) Each parameter shall be
    implemented by all serversa
    Each parameter shall be
    implemented by all clients, using specified value
    request One (mandatory)
    Accept Versions Zero or one (optional) Shall be implemented by all
    servers
    Should be implemented by all
    software clients, using
    allowed values
    Sections Zero or one (optional) Each parameter should be
    implemented by each servera,b
    Each parameter may be
    implemented by each clientc
    update Sequence Zero or one (optional)
    Accept Formats Zero or one (optional)
    1. Server shall check that each value received is an allowed value.
    2. When this parameter is not implemented or not received, server shall provide the specified default response. When implemented and received, server shall provide specified response.
    3. When this parameter is not provided, client shall expect the specified default response. When  provided, client shall allow default or specified response.

     

    1. Get method request samples

    1. DescribeCoverage request

    1. Parameters in DescribeCoverage request operation
    Names Definition Data type and value Multiplicity and use
    service
    Service
    Service type identifier Character String type, not empty Value is OWS type abbreviation, namely "WCS" One (mandatory)
    request
    Request
    Operation name Character String type, not empty
    Value is operation name, namely
    "DescribeCoverage"
    One (mandatory)
    version
    Version
    Specification version for operation Character String type, not empty
    Value is specified by each
    Implementation Specification
    and Schemas version
    One (mandatory)
    identifier
    Identifier
    Unambiguous identifier of a coverage, unique for this WCS Character String type, not empty One or more (mandatory)
    Include for each desired
    coverage

    1. DescribeCoverage request URL encoding
    URL component Description Optionality
    http://server_address/path/script? URL of WCS server. Required
    service=WCS Service name. Must be "WCS". Required
    request=DescribeCoverage Request name. Must be "DescribeCoverage" Required
    version=1.1.0 Request protocol version.
    identifiers=identifier1, identifier2, A comma-separated list of coverage identifiers to describe (identified by their identifier values in the Capabilities document
    1. Get method request samples

      

    1. Reference
      • Web Coverage Service (WCS) Implementation SpecificationWCS 1.1.0, [OGC 06-083r8]
      • OGC Web Services Common Specification , [OGC 06-121r3]