GetMap Request
The GetMap
-request is the main service, delivering geo-referenced layers for specific parameters and locations. Currently the only supported output result is a PNG-image. In our implementation, a WMS GetMap request triggers a standard API query. The following fields must be specified:
https://api.meteomatics.com/wms?VERSION=1.3.0&REQUEST=GetMap&LAYERS=&CRS=&BBOX=&WIDTH=&HEIGHT=&FORMAT=
Field | Description | Value | Example |
---|---|---|---|
VERSION |
Currently we support only OGC standard version 1.3.0.. | String | 1.3.0 |
REQUEST |
The name of the request. | String | GetMap |
LAYERS |
Name of the parameter, in principle all those available in the API. Currently we support only one parameter for query. The model could be also specified here preceding the parameter. | String | t_2m:C , mix:t_2m:C |
CRS |
Coordinate reference system. Currently supported:
|
String | EPSG:4326 |
BBOX |
Bounding box of the queried area (the example shows the coordinates for the entire world), we support only a rectangular area in one of the following formats:
<lat_min>,<lon_min>,<lat_max>,<lon_max> for EPSG:4326 or <east_min>,<north_min>,<east_max>,<north_max> for EPSG:3857 and EPSG:2056 .
|
String |
|
WIDTH HEIGHT |
The width and the height in pixels of the requested image. Supported range is [2-3072]. | Integer | 1024 |
FORMAT |
Only PNG and WebP is supported, but in general it could be any of this: WMS output formats | MIME type | image/png or image/webp |
TIME (optional) |
The time point of the query in our usual API format, only one time per query is supported. If not specified the default value is now .
| ISO-8601 Date | 2018-07-20T16:15Z |
STYLES (optional) |
The colormap applied to the queried data, as usual applied in the API query. Default values are the same as in the API. The default style is a recommended colormap for the requested parameter. Examples for all colormaps can be found here. | String | JET |
SOURCE (optional) |
The model used as data source, the default value is mix but can be any of the models implemented in the API. | String | ecmwf-ifs |
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.
Examples
The following example requests will return the current air temperature at the height of 2 meters in °C for the entire world:
-
EPSG 4326
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
-
EPSG 3857
https://api.meteomatics.com/wms?VERSION=1.3.0&REQUEST=GetMap&LAYERS=mix:t_2m:C&STYLE=JET&CRS=EPSG:3857&BBOX=-20037508.34,-19971868.88,20037508.34,19971868.88&WIDTH=1024&HEIGHT=512&FORMAT=image/png
-
EPSG 2056
https://api.meteomatics.com/wms?VERSION=1.3.0&REQUEST=GetMap&LAYERS=mix:t_2m:C&STYLE=JET&CRS=EPSG:2056&BBOX=2485071.58,1074261.72,2837119.8,1299941.79&WIDTH=1024&HEIGHT=512&FORMAT=image/png
-
PNG
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
-
WebP
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/webp