Project

General

Profile

WMSExtensions » History » Version 4

Version 3 (Ernst de Vreede, 06/13/2013 02:28 PM) → Version 4/14 (Ernst de Vreede, 06/13/2013 02:42 PM)

h1. WMS Extensions

h2. GetFeatureInfo

The GetFeatureInfo call needs all parameters for a GetMap request, except REQUEST and adds X and Y (the pixel coordinates of interest) and QUERY_LAYERS (the layer(s) of interest)

The ADAGUC service extends the GetFeatureInfo call in a number of aspects:

New request parameters:
*
* JSONP=<javascript_function_name> _data is returned as JavaScript code, where provided function is called with JSON result_

Extended request parameters:
* INFO_FORMAT=<FORMAT> _which can be image/gif, image/png, text/plain, application/xml, text/html, application/json

h3. JSON format

The URL
http://bvmlab-218-41.knmi.nl/cgi-bin/ECMD_EUR.cgi?&SERVICE=WMS&REQUEST=GetFeatureInfo&VERSION=1.1.1
&SRS=EPSG%3A4326&LAYERS=201306130000%2FLS_precipitation&QUERY_LAYERS=201306130000%2FLS_precipitation
&BBOX=-180,-131.06076210092687,180,131.06076210092687&WIDTH=971&HEIGHT=707&X=482&Y=224
&FORMAT=image/gif&INFO_FORMAT=application/json&STYLES=&&time=2013-06-13T00:00:00Z/2013-06-16T03:00:00Z

gives the following result:
<pre><code class="json">
[

{
"name": "large_scale_precipitation",
"standard_name": "large_scale_precipitation",
"units": "mm",
"point": {
"SRS": "EPSG:4326",
"coords": "-1.297631,48.012358"
},
"dims": "time",
"data": {
"2013-06-13T03:00:00Z": "0.000",
"2013-06-13T06:00:00Z": "0.000",
"2013-06-13T09:00:00Z": "0.222",
"2013-06-13T12:00:00Z": "0.552",
"2013-06-13T15:00:00Z": "0.565",
"2013-06-13T18:00:00Z": "0.565",
"2013-06-13T21:00:00Z": "0.565",
"2013-06-14T00:00:00Z": "0.568",
"2013-06-14T03:00:00Z": "0.568",
"2013-06-14T06:00:00Z": "0.568",
"2013-06-14T09:00:00Z": "0.568",
"2013-06-14T12:00:00Z": "0.568",
"2013-06-14T15:00:00Z": "0.568",
"2013-06-14T18:00:00Z": "0.568",
"2013-06-14T21:00:00Z": "0.566",
"2013-06-15T00:00:00Z": "0.566",
"2013-06-15T03:00:00Z": "0.566",
"2013-06-15T06:00:00Z": "0.614",
"2013-06-15T09:00:00Z": "1.021",
"2013-06-15T12:00:00Z": "1.027",
"2013-06-15T15:00:00Z": "1.027",
"2013-06-15T18:00:00Z": "1.027",
"2013-06-15T21:00:00Z": "1.027",
"2013-06-16T00:00:00Z": "1.027",
"2013-06-16T03:00:00Z": "1.027"
}
}

]
</code></pre>

This output is more or less self-describing. The requested coordinate is always returned in EPSG:4326. A list of the data's dimensions is also provided.
The following code is an example of Javascript to handle the json:
<pre><code="JavaScript">
//JSON result is parsed and stored in the variable precip
precip["units"] is the units description
precip["dims"] is an array of the dimensions.
precip["data"]["2013-06-16T03:00:00Z"] is the last value of the requested timeseries data.
</code></pre>



h2. GetPointValue

GetPointValue is kind of a shorthand for GetFeatureInfo. It enables one to do a GetFeatureInfo like request, without specifying a WMS GetMap request.
This can be used to retrieve for example a time series of data for a certain lat/lon coordinate or or, in the case of ensemble data to get all 50 timeseries for a "plume" image.

h2. GetMetaData