Get Point Forecast

The main functionality with the API.

The API response is a complete forecast approximately 10 days ahead of the latest current forecast. All times in the answer given in UTC.

The data is returned as mediatype application/json ( JSON ). In the JSON-result you can find the grid point longitude and latitude as a GeoJSON Point. This is the nearest grid point to the point you asked for. You can also find the referenceTime (forecast start time) and the approvedTime (the time the meteorologist approved the forecast). In the timeSeries block you find the data for the forecast. The validTime attribute gives the time for when the data is valid. All parameters except the precipitation parameters has an instantaneous valid time. Precipitation parameters have a distribution in time (a time interval) until the valid time for current data. The interval starts at the time step before. At the beginning of the forecast, the interval is one hour. Later in the forecast, the time interval increases (eg 3, 6 and 12 h). Unit remains mm / h.

After the validTime attribute all the Parameters and there values are listed.

GET /api/category/{category}/version/{version}/geotype/point/lon/{longitude}/lat/{latitude}/data.json
Category For now, there are one category for the API, pmp3g.
Version When the API for a given category is changed, the version is increased. Old versions will be available for a limited time.
Geotype The geoptype. In this case it should be point.
Lon The longitude for were you want to get the data. See Geographic area for more information about the forecast area.
Lat The latitude for were you want to get the data. See Geographic area for more information about the forecast area.
Data The actual data.

Get MultiPoint Forecast

With the MultiPoint request you can get a forecast for all grid points for the given category , validtime , parameter , leveltype and level .

The data is returned as mediatype application/json ( JSON ). In the JSON-result you can find the the referenceTime (forecast start time) and the approvedTime (the time the meteorologist approved the forecast). In the timeSeries block you find the data for the forecast. The validTime attribute gives the time for when the data is valid. The JSON-result has the same structure as the one from the Point request but with only one validtime and one parameter.

The query parameter downsample allows an integer between 0-20. A downsample value of 2 means that every other value horizontally and vertically is displayed.

The query parameter with-geo only allows false. The index for each value matches the index for the Point in the MultiPoint request.
NB! Your client must accept ancoding GZIP. Otherwise you will get a HTTP 406 error.

GET /api/category/{category}/version/{version}/geotype/multipoint/validtime/{YYMMDDThhmmssZ}/parameter/{p}/leveltype/{lt}/level/{l}/data.json?with-geo=false&downsample=2
Accept-Encoding: gzip
Category For now, there are one category for the API, pmp3g.
Version When the API for a given category is changed, the version is increased. Old versions will be available for a limited time.
Geotype The geoptype. In this case it should be multipoint.
ValidTime The validtime. Specified in YYYYMMDDThhmmssZ format. The available valid times can be found with the Valid time request.
Parameter The parameter (in lower case). See parameter info.
LevelType The level type. See parameter info.
Level The level. See parameter info.
Data The actual data.