The GetMap
-Request fetches data and essentially consists of the following elements:
https://api.meteomatics.com/wms?VERSION=1.3.0&REQUEST=GetMap&LAYERS=&CRS=&BBOX=&WIDTH=&HEIGHT=&FORMAT=
The following table describes all parameters of the GetMap
-Request:
Field | Description | Value | Example |
---|---|---|---|
VERSION |
WMS version according to which the request will be treated. The currently supported version is 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. Only one parameter is supported per request. | String | "t_2m:C" |
STYLES (optional) |
A single 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 coordinate reference system used for georeferencing. Currently EPSG:4326 and EPSG:3857 are supported. |
String | "EPSG:4326" |
BBOX |
Defines the area of the requested data formatted as , where the interpretation of x and y depends on the standard and CRS. For example, with EPSG:4326 (and version 1.3.0 ), the BBOX will be interpreted as . |
String |
World |
WIDTH / HEIGHT |
Specifies the width and height of the requested image | Integer in the range 2-3072 | "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 section Date/Time Description. TIME always refers to validdatetime. Defaults to "now". |
ISO-8601 Date | "2018-07-20T16:15Z" |
MODEL (optional) |
A certain data source such as a weather model or a RADAR. 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. In that case a WMS exception in the XML format will be returned instead.
Example
The following example requests will return the current air temperature at the height of 2 meters in degrees Celsius for the entire 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