Language plus “”
return default languageee section
1.2.6
a Although some values listed in the “Name” column appear to contain spaces, they shall not contain spaces.
b The “Sections” parameter specifies which XML elements within a service metadata document shall be
returned, within a usually abbreviated “Capabilities” element. The allowed section name values shall be specified by each Implementation Specification, as specified in Subclause 7.3.3.
NOTE 1 The name capitalization rules used here are specified in Subclauses 5.5 and 11.6.2.
NOTE 2 The data type of many parameters is specified as “Character String type, not empty”. In the
XML Schemas specified herein, these parameters are encoded with the xsd:string type, which does NOT require that these strings not be empty.
1.1.1 Implementation requirements
The “Multiplicity and use” column in Table 2 specifies the optionality of each listed parameter in the GetCapabilities operation request. Table 2 specifies the implementation
of those parameters by OWS clients and servers.
Table 2 — Implementation of parameters in GetCapabilities operation request
Name Multiplicity
Client implementation Server implementation
service One
mandatory Each parameter shall be
implemented by all clients, using specified value
Each parameter shall be implemented by all servers, checking that each
parameter is received with specified value
request One
mandatory Accept Vers
ions Zero or one
optional Should be implemented by all
software clients, using specified values
Shall be implemented by all servers, checking if parameter is received
with specified values Sections
Zero or one optional
a
Each parameter may be implemented by each client
If parameter not provided, shall expect default response
If parameter provided, shall allow default or specified
response Each parameter may be implemented
by each server If parameter not implemented or not
received, provide default response If parameter implemented and
received, provide specified response update Sequ
ence Zero or one
optional
a
Accept For mats
Zero or one optional
a
AcceptLl an
guage Zero or one
optional Should be implemented by all
clients Shall be implemented by servers
offering multilingual capabilities
a A specific OWS is allowed to make mandatory or prohibit server implementation of this parameter. If a
specific OWS makes server implementation mandatory, then this parameter can also be made mandatory in the operation request, requiring client implementation of this parameter. Similarly, if a specific OWS prohibits server
implementation of this parameter, then the parameter should also be prohibited in the operation request, prohibiting client implementation of this parameter.
1.1.2 GetCapabilities request KVP encoding
The KVP encoding of the GetCapabilities operation request shall be as shown in Table 3, with example values appropriate for WCS 1.0.0.
Table 3 — GetCapabilities operation request URL parameters
Name and example
a
Optionality and use Definition and format
service=WCS Mandatory
Service type identifier text request=GetCapabilities
Mandatory Operation name text
AcceptVersions=1.0.0,0.8.3 Optional When omitted, return latest
supported version see Subclause 7.3.2
Comma-separated prioritized sequence of one or more
specification versions accepted by client, with preferred versions listed
first Sections=Contents
Optional When omitted or not supported
by server, return complete service metadata document
Comma-separated unordered list of zero or more names of sections of
service metadata document to be returned in service metadata
document updateSequence=XXX
where XXX is character string previously provided
by server Optional
When omitted or not supported by server, return latest service
metadata document version Service metadata document version,
value is “increased” whenever any change is made in complete service
metadata document AcceptFormats= textxml
Optional When omitted or not supported
by server, return service metadata document using
MIME type textxml Comma-separated prioritized
sequence of zero or more response formats desired by client, with
preferred formats listed first AcceptLl
anguage=en- CA,fr-CA
Optional When
omitted or not supported
by server, return human readable text in
thea default
language of the server ’s choice
Comma-separated list of languages desired by the client for all human
readable text in the response, in order of preference.
For every element, the first
matching language available from the server shall be
present in the response. See section 1.2.6
a All parameter names are listed here using mostly lower case letters. However, any parameter name
capitalization shall be allowed in KVP encoding, see Subclause 11.5.2.
In a specific OWS Implementation Specification, this table shall be supported by specification of the section names allowed in the Sections parameter, with the meaning of
each value for that specific OWS. These section names and meanings shall be based on Subclause 7.4.2.
An example of a GetCapabilities request message encoded using KVP is:
http:hostname:portpath? SERVICE=WCSREQUEST=GetCapabilitiesACCEPTVERSIONS=1.0.0,0.8.3SECTIO
NS=ContentsUPDATESEQUENCE=XYZ123
ACCEPTFORMATS=textxml Accept
L anguageANGUAGE
=en-CA,fr-CA
This example includes all six possible parameters, but only the “service” and “request” parameters are required.
1.1.3 GetCapabilities request XML encoding