WMS Interface

The Meteomatics WMS (Web Map Service) Interface supports OGC WMS specifications of version 1.3.0. WMS is designed to provide area data, (e.g. air temperature of whole Europe at a specific point in time) as georeferenced images. Our WMS layers can be easily queried through GIS software like Google Earth, ArcGIS Desktop and Online or QGIS.

The interface is located at

https://api.meteomatics.com/wms?

The following chapters briefly describe the supported requests. Please refer to the OGC documentation for further details of the standard.

GetCapabilities-Request

The GetCapabilities-Request describes the capabilities of the WMS service. This information includes supported parameters, times available, and geographic regions available. A GetCapabilities-Request is constructed as follows:

https://api.meteomatics.com/wms?SERVICE=WMS&VERSION=<version>&REQUEST=GetCapabilities

The service will return a WMS specific XML describing all available data. The currently supported WMS versions are 1.1.1 and 1.3.0 (default).

GetMap-Request

The GetMap-Request fetches data. A GetMap-Request is constructed as follows:

https://api.meteomatics.com/wms?VERSION=<version>&REQUEST=GetMap&LAYERS=<layers>&STYLE=<style>&CRS=<CRS>&BBOX=<bbox>&WIDTH=<width>&HEIGHT=<height>&FORMAT=<format>

The following table describe the parameters of the GetCapabilities-Request:

Field Description Value Example
VERSION WMS version according to which the request will be treated. The supported versions are 1.1.1 and 1.3.0. String "1.3.0"
REQUEST The request type, here "GetMap". String "GetMap"
LAYERS Represents the requested parameter. For a list a of available parameters, please refer to the list of available parameters. Currently only one parameter is supported per request. String "t_2m:C"
STYLES (optional) The color scheme which should be used to represent the data. Currently the following color schemes are implemented: JET, JET_INVERTED, JET_SEGMENTED, JET_SEGMENTED_INVERTED,BLUES, BLUES_INVERTED, BLUE_TO_RED, RED_TO_BLUE, BLUE_MAGENTA, MAGENTA_BLUE, GRAY, GRAY_INVERTED, PERIODIC, PERIODIC_INVERTED, PLASMA, PLASMA_INVERTED, PRISM, PRISM_INVERTED, REDS, REDS_INVERTED , SEISMIC, SEISMIC_INVERTED, VIRIDIS, and VIRIDIS_INVERTED. The default style is a recommended colormap for the requested parameter. String "JET"
CRS Specifies the projection used to render the image. Currently EPSG:4326 (lon/lat with 1.1.1, but lat/lon under 1.3.0) and CRS:84 (always lon/lat) are implemented. String "EPSG:4326"
BBOX Defines the area of the requested data formatted as <x-min>,<y-min>,<x-max>,<y-max> where the interpretation of x and y depens on the standard and CRS. According to the 1.1.1 standard with EPSG:4326, the BBOX will be interpreted as <lon_min>,<lat_min>,<lon_max>,<lat_max>, whereas with 1.3.0 the interpretation will be <lat_min>,<lon_min>,<lat_max>,<lon_max>. With CRS:84 it will be strictly read as <lon_min>,<lat_min>,<lon_max>,<lat_max>. String World in 1.3.0 withEPSG:4326: "-90,-180,90,180"
WIDTH / HEIGHT Specifies the width/height of the returned data in pixels. Integer in the range 1-4096 "1024"
FORMAT Specifies the image data format of the response. Currently only PNG "image/png" is supported. MIME type "image/png"
TIME (optional) A single point in time (UTC) as specified in the time format description. Defaults to "now". ISO-8601 Date "2015-01-20T18:45Z"
MODEL (optional) A certain weather model should be used return the data. Default model is mix. String "ecmwf-ifs" or "ncep-gfs"

The service will return the data as specified by the FORMAT parameter, unless an error is encountered.

Example Requests

The following example requests for the versions 1.3.0 and 1.1.1 will return the current air temperature at the height of 2m in degrees Celsius for the whole world:

https://api.meteomatics.com/wms?VERSION=1.3.0&REQUEST=GetMap&LAYERS=mix:t_2m:C&STYLE=JET&CRS=EPSG:4326&BBOX=-90,-180,90,180&WIDTH=1024&HEIGHT=512&FORMAT=image/png

https://api.meteomatics.com/wms?VERSION=1.1.1&REQUEST=GetMap&LAYERS=mix:t_2m:C&STYLE=JET&SRS=EPSG:4326&BBOX=-180,-90,180,90&WIDTH=1024&HEIGHT=512&FORMAT=image/png

GetLegendGraphic-Request

The GetLegendGraphic-Request delivers a legend graphic with an extent of 192x384 pixels to help the user with the interpretation of the data. The requests are usually automatically generated by the GIS software. A manual GetLegendGraphic-Request can be constructed as follows:

https://api.meteomatics.com/wms?VERSION=<version>&REQUEST=GetLegendGraphic&FORMAT=<format>&LAYER=<layer>&STYLE=<style>

Example: https://api.meteomatics.com/wms?VERSION=1.3.0&REQUEST=GetLegendGraphic&FORMAT=image/png&LAYER=t_2m:C&STYLE=jet_segmented

The following table describes the parameters of the GetLegendGraphic-Request:

Field Description Value Example
VERSION WMS version according to which the request will be treated (1.1.1 or 1.3.0). Has no impact on the GetLegendGraphic request. String "1.1.1" or "1.3.0".
REQUEST The request type. In case of GetLegendGraphic-Request fixed to "GetLegendGraphic". String "GetLegendGraphic"
LAYERS Represents the requested parameter. For a list a of available parameters, please refer to the list of available parameters. Currently only one parameter is supported per Request. Note that not all API parameters are also available via WMS. Please contact Meteomatics if you have any questions. String "t_2m:C"
STYLES (optional) The color scheme which should be used to represent the data. Currently the following color schemes are implemented: JET, JET_INVERTED, JET_SEGMENTED, JET_SEGMENTED_INVERTED, BLUE_TO_RED, RED_TO_BLUE, BLUES, BLUES_INVERTED, GRAY, GRAY_INVERTED, PERIODIC, PERIODIC_INVERTED, PLASMA, PLASMA_INVERTED, PRISM, PRISM_INVERTED, REDS, REDS_INVERTED , SEISMIC, SEISMIC_INVERTED, VIRIDIS, VIRIDIS_INVERTED, BLUE_MAGENTA, and MAGENTA_BLUE. The default style is a recommended colormap depending on the parameter. String "VIRIDIS_INVERTED"
FORMAT Specifies the image data format of the response. Currently only PNG "image/png" is supported. MIME type "image/png"
TRANSPARENT Custom optional parameter to specify whether the background of the legend graphic should be transparent or white. String "true"

Online ESRI ArcGIS (WMS Instruction)

If you use the online versions of ESRI ArcGIS, follow the instructions below to include our WMS interface for creating your own maps.

Start by opening the Online ESRI ArcGIS website and logging in.

Select one of maps in the WGS 84 coordinate system for the basemap

and click on Add, where you select Add Layer from Web from the drop-down menu:

Proceed by choosing A WMS OGC Web Service and enter our WMS URL https://api.meteomatics.com/wms?. Click on get layers, which will ask you to enter your Meteomatics API account credentials,

and select the desired layer (only one per time is supported). After that, press add layer

and the desired layer should be loaded and rendered.

Querying WMS Layers with custom parameters

In order to make full use of our WMS interface, say for querying WMS layers for specific times, you will need add custom parameters. To demonstrate how this works, let us go over the necessary steps to query a WMS layer for a specific TIME. The other custom parameters can be then be used analogously.

When adding the layer use Add Custom Parameters as displayed in the following image:

If you have already added the layer, you can retroactively change the custom parameters by going to the options of the layer and changing WMS OGC Options.

With the Parameter TIME you can query the layer for the date you want with Add Parameter and entering the desired Parameter and time.

Click on Get Layers, select the layer you're interested in and add it with add layer:

After that you should be able to see the layer (in this case the dew point) with the custom parameters:

QGIS (WMS Instruction)

If you use the free and open source geographic information system QGIS you can follow the instructions below to add our WMS interface to create your own maps.

Open QGIS and add a WMS/WMTS-Layer:

Create a New server connection

and fill in Name, e.g. with Meteomatics WMS, and URL with our WMS URL https://api.meteomatics.com/wms as well as the user name and password of your Meteomatics API user account.

Connect to the Meteomatics WMS with Connect,

select your desired layer and Add it:

This should result in QGIS displaying the desired layer, e.g. that of the dew point:

Note: the QGIS plugin TimeManager allows you to easily choose a time (without entering the time, the imagery is taken for the current time) and create slideshows/videos of WMS content.

News