About
The final level of the API is the Data level.
This is where you get the actual Data.
Data is available in CSV format for 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, only the latest value is included when fetching data in CSV format, regardless of Period used. This limitation only applies to the CSV format.
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}
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. |
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 is not complete for the sake of readability.
GET /api/version/1.0/parameter/4/station/33005/period/corrected-archive/data.csv
...
GET /api/version/latest/parameter/5/station/2179/period/latest-day/data.xml
...
GET /api/version/latest/parameter/5/station/2179/period/latest-day/data.json
...
GET /api/version/latest/parameter/5/station-set/all/period/latest-hour/data.csv
...
GET /api/version/latest/parameter/5/station-set/all/period/latest-hour/data.xml
...
GET /api/version/latest/parameter/5/station-set/all/period/latest-hour/data.json
...