ADAGUC » adagucserver

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 class="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 in the case of ensemble data to get all 50 timeseries for a "plume" image.

Parameters for a GetPointValue request are:

An example of a multi-dimensional data request:

http://bvmlab-218-41.knmi.nl/cgi-bin/ECMD_EUR.cgi?&SERVICE=WMS&REQUEST=GetPointValue&VERSION=1.1.1

&SRS=EPSG:4326&QUERY_LAYERS=201306130000/Temperature_pl&X=5.2&Y=52.0&INFO_FORMAT=application/json&

time=2013-06-13T00:00:00Z/2013-06-13T12:00:00Z&DIM_pressure=300,500

Output:

<pre><code class="json">

[

    {

        "name": "air_temperature",

        "standard_name": "air_temperature",

        "units": "Celsius",

        "point": {

            "SRS": "EPSG:4326",

            "coords": "5.200000,52.000000"

        },

        "dims": [

            "pressure",

            "time"

        ],

        "data": {

            "300": {

                "2013-06-13T00:00:00Z": "-39.54",

                "2013-06-13T03:00:00Z": "-39.69",

                "2013-06-13T06:00:00Z": "-39.62",

                "2013-06-13T09:00:00Z": "-39.57",

                "2013-06-13T12:00:00Z": "-39.76"

            },

            "500": {

                "2013-06-13T00:00:00Z": "-12.46",

                "2013-06-13T03:00:00Z": "-12.20",

                "2013-06-13T06:00:00Z": "-12.19",

                "2013-06-13T09:00:00Z": "-12.61",

                "2013-06-13T12:00:00Z": "-12.59"

            }

        }

    }

]

</code></pre>

A request can also be for multiple variables:

http://bvmlab-218-41.knmi.nl/cgi-bin/ECMD_EUR.cgi?&SERVICE=WMS&REQUEST=GetPointValue&VERSION=1.1.1

&SRS=EPSG:4326&QUERY_LAYERS=201306130000/Temperature_pl,201306130000/ZGeo_Height&X=5.2&Y=52.0

&INFO_FORMAT=application/json&time=2013-06-13T00:00:00Z/2013-06-13T12:00:00Z&DIM_pressure=300,500

Output:

<pre><code class="json">

[

    {

        "name": "air_temperature",

        "standard_name": "air_temperature",

        "units": "Celsius",

        "point": {

            "SRS": "EPSG:4326",

            "coords": "5.200000,52.000000"

        },

        "dims": [

            "pressure",

            "time"

        ],

        "data": {

            "300": {

                "2013-06-13T00:00:00Z": "-39.54",

                "2013-06-13T03:00:00Z": "-39.69",

                "2013-06-13T06:00:00Z": "-39.62",

                "2013-06-13T09:00:00Z": "-39.57",

                "2013-06-13T12:00:00Z": "-39.76"

            },

            "500": {

                "2013-06-13T00:00:00Z": "-12.46",

                "2013-06-13T03:00:00Z": "-12.20",

                "2013-06-13T06:00:00Z": "-12.19",

                "2013-06-13T09:00:00Z": "-12.61",

                "2013-06-13T12:00:00Z": "-12.59"

            }

        }

    },

    {

        "name": "height",

        "standard_name": "height",

        "units": "m",

        "point": {

            "SRS": "EPSG:4326",

            "coords": "5.200000,52.000000"

        },

        "dims": [

            "pressure",

            "time"

        ],

        "data": {

            "300": {

                "2013-06-13T00:00:00Z": "9426",

                "2013-06-13T03:00:00Z": "9411",

                "2013-06-13T06:00:00Z": "9398",

                "2013-06-13T09:00:00Z": "9392",

                "2013-06-13T12:00:00Z": "9377"

            },

            "500": {

                "2013-06-13T00:00:00Z": "5723",

                "2013-06-13T03:00:00Z": "5710",

                "2013-06-13T06:00:00Z": "5696",

                "2013-06-13T09:00:00Z": "5689",

                "2013-06-13T12:00:00Z": "5677"

            }

        }

    }

]

</code></pre>

h2. GetMetaData