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.See Reference System for more information about the spatial reference system for the data. |
| Lat | The latitude for were you want to get the data. See Geographic area for more information about
the forecast area.See Reference System for more information about the spatial reference system for the data. |
| 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 encoding 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. |