API Documentation

Open Data

The api is free to use.


Authentication

No registration/API-key or any other authentication/authorisation is necessary at this time, but it may change in furure.


Data Format

Values are returned in a propritary format: Values are between apostrophes (') and divided by semicolons (;). Every data row is presented in a new line (\n).

Example:

'11010';'Linz/Hörsching';'298';'2014-08-13';'00:00';'14.3';'°C';'2014-08-13 00:15:02'
'11010';'Linz/Hörsching';'298';'2014-08-13';'01:00';'14.6';'°C';'2014-08-13 01:15:04'
'11010';'Linz/Hörsching';'298';'2014-08-13';'02:00';'14.4';'°C';'2014-08-13 02:15:02'
'11010';'Linz/Hörsching';'298';'2014-08-13';'03:00';'14.5';'°C';'2014-08-13 03:15:02'
'11010';'Linz/Hörsching';'298';'2014-08-13';'04:00';'14.1';'°C';'2014-08-13 04:15:02'
'11010';'Linz/Hörsching';'298';'2014-08-13';'05:00';'14.2';'°C';'2014-08-13 05:15:02'

Get Data

The api is located at http://at-wetter.tk/api/v1/.

Stations:

/api/v1/stations returns all available stations

Example:

'11157';'Aigen im Ennstal';'640';'m'
'11244';'Bad Gleichenberg';'280';'m'
'11101';'Bregenz';'424';'m'
'11190';'Eisenstadt';'184';'m'
'11155';'Feuerkogel';'1618';'m'
(...)

Fields:

/api/v1/fields returns all available data fields

Example:

't';'decimal(4,1)'
'tp';'decimal(4,1)'
'rf';'int(4)'
'wr';'int(4)'
'wg';'decimal(5,1)'
'wsr';'int(4)'
'wsg';'decimal(4,1)'
'regen';'decimal(6,1)'
'ldred';'decimal(8,1)'
'ldstat';'decimal(8,1)'
'sonne';'int(4)'
(...)

Query All Stations

/api/v1/[field]/[YYYY-MM-DD]/[day count] returns the [field] from the specified date [YYYY-MM-DD] and prints data [day count] days in the past for all available stations

[field] mandatory, see allowed values in the table below.
[YYYY-MM-DD] if omitted, defaults to today
[day count] if omitted, defaults to 0 (only data from the specified date, or if you omit the date also from today)


# field name description unit
1 t Temperature Data [°C]
2 tp Dew Point Data [°C]
3 rf Relative Humidity Data [%]
4 wr Wind Direction Data [°]
5 wg Wind Speed Data [km/h]
6 wsr Peek Wind Direction Data [°C]
7 wsg Peek Wind Speed Data [km/h]
8 regen Precipitation Data [l/m²]
9 ldred Atmospheric Pressure Data (red.) [hPa]
10 ldstat Atmospheric Pressure Data (Station Level) [hPa]
11 sonne Sunshine Data [%]

Example:

http://at-wetter.tk/api/v1/t/2014-08-01/2 returns the following result data: Temperature Data for every available station for 2014-08-01, 2 days in the past.
'11010';'Linz/Hörsching';'298';'2014-08-01';'00:00';'16.8';'°C';'2014-08-01 00:15:01'
'11012';'Kremsmünster';'383';'2014-08-01';'00:00';'16.4';'°C';'2014-08-01 00:15:01'
'11022';'Retz';'320';'2014-08-01';'00:00';'17.7';'°C';'2014-08-01 00:15:01'
'11035';'Wien/Hohe Warte';'203';'2014-08-01';'00:00';'19.1';'°C';'2014-08-01 00:15:01'
'11036';'Wien/Schwechat';'183';'2014-08-01';'00:00';'19.5';'°C';'2014-08-01 00:15:01'
'11101';'Bregenz';'424';'2014-08-01';'00:00';'16.3';'°C';'2014-08-01 00:15:01'
'11121';'Innsbruck';'579';'2014-08-01';'00:00';'15.7';'°C';'2014-08-01 00:15:01'
(...)

To get the current data for today:

Example:

http://at-wetter.tk/api/v1/t returns the following result data: Temperature Data for every available station for today.
'11010';'Linz/Hörsching';'298';'2014-08-13';'00:00';'14.3';'°C';'2014-08-13 00:15:02'
'11012';'Kremsmünster';'383';'2014-08-13';'00:00';'14.5';'°C';'2014-08-13 00:15:02'
'11022';'Retz';'320';'2014-08-13';'00:00';'15.0';'°C';'2014-08-13 00:15:02'
'11035';'Wien/Hohe Warte';'203';'2014-08-13';'00:00';'15.9';'°C';'2014-08-13 00:15:02'
'11036';'Wien/Schwechat';'183';'2014-08-13';'00:00';'16.0';'°C';'2014-08-13 00:15:02'
'11101';'Bregenz';'424';'2014-08-13';'00:00';'18.5';'°C';'2014-08-13 00:15:02'
'11121';'Innsbruck';'579';'2014-08-13';'00:00';'13.9';'°C';'2014-08-13 00:15:02'
(...)

Query A Specific Station

/api/v1/station/[station]/[field]/[YYYY-MM-DD]/[day count] returns the [field] from the specified date [YYYY-MM-DD] and prints data [day count] days in the past for the specified stations [station]

[station] mandatory, get allowed values from /api/v1/stations.
[field] mandatory, see allowed values in the table below.
[YYYY-MM-DD] if omitted, defaults to today
[day count] if omitted, defaults to 0 (only data from the specified date, or if you omit the date also from today)


# field name description unit
1 t Temperature Data [°C]
2 tp Dew Point Data [°C]
3 rf Relative Humidity Data [%]
4 wr Wind Direction Data [°]
5 wg Wind Speed Data [km/h]
6 wsr Peek Wind Direction Data [°C]
7 wsg Peek Wind Speed Data [km/h]
8 regen Precipitation Data [l/m²]
9 ldred Atmospheric Pressure Data (red.) [hPa]
10 ldstat Atmospheric Pressure Data (Station Level) [hPa]
11 sonne Sunshine Data [%]

Example:

http://at-wetter.tk/api/v1/station/11036/t/2014-08-01/2 returns the following result data: Temperature Data for station 11036 (Wien/Schwechat) for 2014-08-01, 2 days in the past.
'11036';'Wien/Schwechat';'183';'2014-07-30';'00:00';'20.8';'°C';'2014-07-30 00:15:02'
'11036';'Wien/Schwechat';'183';'2014-07-30';'01:00';'19.7';'°C';'2014-07-30 01:15:01'
'11036';'Wien/Schwechat';'183';'2014-07-30';'02:00';'19.5';'°C';'2014-07-30 02:15:02'
'11036';'Wien/Schwechat';'183';'2014-07-30';'03:00';'19.2';'°C';'2014-07-30 03:15:01'
'11036';'Wien/Schwechat';'183';'2014-07-30';'04:00';'18.7';'°C';'2014-07-30 04:15:02'
(...)

To get the current data for today:

Example:

http://at-wetter.tk/api/v1/station/11036/t returns the following result data: Temperature Data for station 11036 (Wien/Schwechat) for today.
'11036';'Wien/Schwechat';'183';'2014-08-13';'00:00';'16.0';'°C';'2014-08-13 00:15:02'
'11036';'Wien/Schwechat';'183';'2014-08-13';'01:00';'15.9';'°C';'2014-08-13 01:15:04'
'11036';'Wien/Schwechat';'183';'2014-08-13';'02:00';'15.9';'°C';'2014-08-13 02:15:02'
'11036';'Wien/Schwechat';'183';'2014-08-13';'03:00';'15.7';'°C';'2014-08-13 03:15:02'
'11036';'Wien/Schwechat';'183';'2014-08-13';'04:00';'15.1';'°C';'2014-08-13 04:15:02'
(...)

Questions

Feel free to send me an email to thomas@mitschke.tk with questions or suggestions to enhance this API.