Introduction

The FEW Web Mapping Service with time support is the FEWS implementation of the WMS-T OGC standard and is available since 2018.02. It allows requesting images for plots that have been configured in the FEWS grid display. The WMS version that is supported is version 1.3.

Only the EPSG:3857 projection (WGS84 Web Mercator) is supported. Every gridPlot that has been configured in the grid display configuration represents a WMS layer.

WMS Request methods

The available request methods with their supported parameters are described here.

GetCapabilties

 

GetCapabilities: get the available layers and times available for each layer at the current system time.

GetMap

 

GetMap: Get the plot image as png for a layer for a requested time, image size and extent. Only untiled images are supported, which means the complete image has to be requested for the complete extent.

 

Request URL:

http://localhost:8181/FewsWebServices/wms?request=GetMap&version=1.1.1&layers=giss_e2_h_grid%20decennially%201time=1859-01-01T00%3A00%3A00.000Z&srs=EPSG%3A3857&width=920&height=500&bbox=-17885041.62627868,-6887893.4928338025,18119856.177170746,12679985.748171324

Supported parameters:

LAYERS (required): the layerId of the plot to display. Only one layerid is supported.

TIME (required): the time for which the grid has to be plotted. Only one time is supported. Time ranges are NOT supported.

WIDTH (optional): width of the image. Default is 800. 

HEIGHT (optional): height of the image. Default is 600

VERSION (optional): supported version is 1.3 and is the default if not set. Older versions might work, but are not supported

CRS (required): the output projection of the plot. Only supported projection is: EPSG:3857

BBOX (required): the bounding box (in the projection as defined by the SRS parameter) of the extent that should be plot

Supported vendor parameters:

SHOWCONTOURS (optional): Display contour lines if enabled in the gridplot. Default is false. Set to true to show contour lines.

 

Restrictions:

The product of width and height is limited to the full HD resolution of 1920x1200 to avoid memory issues. In case a GetMap request is done where WIDTH*HEIGHT > 2304000 a bad request error will be returned.

GetLegendGraphic

GetLegendGraphic: Get the legend image as png for a layer.

http://localhost:8080/FewsWebServices/wms?SERVICE=WMS&VERSION=1.3&REQUEST=GetLegendGraphic&LAYERS=Wind_forecast_nwp

 

Properties

The following WMS specific properties can be configured in the FewsPiService.properties file.