Displays an info screen with the next Wiener Linien public transport connections nearby. It was developed and is currently in use at Metalab.
It includes a small server written in Node.js that pulls the needed data from the Wiener Linien API, caches it and serves it together with an HTML5 frontend. At Metalab, all of this runs on a Raspberry Pi, which also displays the frontend on a spare monitor (check out util for reproduction).
- Run
npm installto fetch dependencies. - Move
server/settings.example.jstoserver/settings.jsand - Add your API key (mandatory, get one here).
- Most likely you will also want to change the
api_idsto the RBL numbers that correspond to the stations you want to include (find them here) and change thelocation_coordinateto the location of your Öffimonitor. - Change additional settings (optional).
- Run
npm start - Open Öffimonitor in a browser of your choice.
Besides the HTML frontend you can find a JSON API at /api. It returns a status message, an array of departures and an array of warnings, which include all traffic infos of the type stoerunglang from the Wiener Linien API.
{
"status": "ok", // 'ok' or 'error'
"departures":[{
"stop": "Landesgerichtsstraße",
"coordinates": [16.3568570699034,48.2145510683941],
"line": "43",
"type": "ptTram",
"towards": "Neuwaldegg",
"barrierFree": true,
"time": "2017-02-14T18:54:14.000Z", // calculated most accurate departure time
"timePlanned": "2017-02-14T19:52:00.000+0100",
"timeReal": "2017-02-14T19:54:14.000+0100",
"countdown": 6,
"walkDuration": 197.9, // walking duration to stop in seconds
"walkStatus":"soon" // 'too late', 'hurry' or 'soon'
}],
"warnings": [{
"title": "43 : Fremder Verkehrsunfall",
"description": "Nach einer Fahrtbehinderung kommt es auf der Linie 43 zu unterschiedlichen Intervallen."
}]
}
All values without comments are directly taken from the Wiener Linien API. Attention! timeReal does not exist in case there is no real time information available and even timePlanned might be undefined if the departure time is written into the towards string (e.g. 'KARLSPLATZ NÄCHSTER ZUG 9 MIN'). In case you need a returned timestamp, rely on time, which always contains the most accurate departure time available.
{
"status": "error",
"error": "API request failed"
}
This project is licensed under AGPL-3. It includes several external assets in the folder site/assets, which are licensed under Creative Commons Namensnennung 3.0 Österreich by Stadt Wien – Wiener Linien (all SVG files) as well as the Roboto font by Google licensed under Apache 2.0 (all TTF files).
For calculating the walking duration to the stop, Öffimonitor by default queries the OSRM Demo Server and caches these results for the current runtime execution. By using the OSRM Demo Server you agree to this API usage policy. The corresponding database is licensed under ODbL by OSRM. You can change the server address to any other OSRM instance in server/settings.js.
Happy hacking!