About
The final level of the API is the Data level.
This is where you get the actual Data.
Notice that data is only available in CSV format for the Period
corrected-archive, but also available in XML and JSON for the rest of
the Periods.
There is no ATOM format for any Data.
All dates in the JSON answers are in Unix time stamp.
NB: For station-set, if a station is missing data you get "value": null in the
JSON answer. In the XML answer the value element is missing. In the
CSV answer the value is just an empty string.
GET /api/version/{version}/parameter/{parameter}/station/{station}/period/{period}/data.{ext}
GET /api/version/{version}/parameter/{parameter}/station-set/{stationSet}/period/{period}/data.{ext}?measuringStations={measuringStations}
Parameters
| {period} | One of four Periods. Valid values are latest-hour,
latest-day, latest-months or corrected-archive. Notice that all
Stations do not have all four Periods so make sure
to check which ones are available in the Period level.
|
| {station} | Numeric value. Available Stations are listed in the Parameter level. |
| {stationSet} | Lexical value. Available Station Sets are listed in the Parameter level.
Valid value is all which is the set of station that has data for the latest hour. |
| {parameter} | Numeric value. Available Parameters are listed in the Version level. |
| {version} | Numeric value or latest. Try to use the Version with the
highest number instead of the Version titled latest. |
| {ext} | The suffix specifying which mediatype to use. See mediatypes for more information. |
Query parameters
| {measuringStations} | Query parameter specifying which measuring stations to get data for. Can be core or
additional. See stations attributes.
If not used, all stations are returned. Only valid for station-set.
|
Reference System
The used reference system (coordinate system) is WGS84, World Geodetic System 1984 (EPSG:4326). This means that the coordinates for the stations are expressed as latitude and longitude. The unit is decimal degress.
Examples
Example request and response for the Data level. This response in not complete for the sake of readability.
GET /api/version/1.0/parameter/1/station/159880/period/latest-day/data.csv
...
GET /api/version/1.0/parameter/1/station/159880/period/latest-day/data.xml
...
GET /api/version/1.0/parameter/1/station/159880/period/latest-day/data.json
...
GET /api/version/1.0/parameter/1/station-set/all/period/latest-hour/data.csv
...
GET /api/version/1.0/parameter/1/station-set/all/period/latest-hour/data.xml
...
GET /api/version/1.0/parameter/1/station-set/all/period/latest-hour/data.json
...