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 Verbundlinie TRIAS API, caches it and serves it together with an HTML5 frontend. At Spektral, 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 - Most likely you will also want to change the
stopsto the stop ids that correspond to the stops you want to include (send a post request to the api with this data) 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 from the verbundlinie website.
{
"status": "ok", // 'ok' or 'error'
"departures":[{
"stop": "Lendplatz/tim",
"coordinates": [13.68357, 47.39131],
"line": "63",
"type": "bus",
"towards": "Schulzentrum St.Peter",
"barrierFree": undefined, // does not work...
"time": "2023-04-14T14:54:00.000Z", // calculated most accurate departure time
"timePlanned": "2023-04-14T14:54:00Z",
"timeReal": "2023-04-14T14:54:00Z",
"countdown": undefined, // does not work...
"walkDuration": 197.9, // walking duration to stop in seconds
"walkStatus": "soon" // 'too late', 'hurry' or 'soon'
}],
"warnings": [{
"title": "N5",
"description": "Bis voraussichtlich Juli 2023 Umleitung im Bereich Triester Straße"
}]
}
{
"status": "error",
"error": "API request failed"
}
We highly appreciate any and all help. If (or better, when) you find a bug, please open an issue on Github.
Pull requests are also very welcome, especially if they fix a bug or add features requested in an issue. Please be aware that if you open a PR, you agree with licensing your code under AGPL-3. You might have noticed that our client-side code has no dependencies and we would like to keep it that way. If you disagree with that approach or want to make bigger changes, please open an issue and discuss things with us first. We might not merge PRs if we feel that the changes do not reflect the usage of Öffimonitor at Metalab, but we're happy about forks as well!
This project is licensed under AGPL-3 by Metalab & improved by MassiTheDuck. It includes several external assets in the folder site/assets, namely a bunch of pictograms (all SVG files) which are licensed under Creative Commons Namensnennung 3.0 Österreich by Stadt Wien – Wiener Linien as well as the Roboto font (all TTF files) by Google licensed under Apache 2.0.
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 or leave it blank to disable the feature.
- Bernhard Hayden @burnoutberni
- Moritz Wilhelmy @wilhelmy
- Jascha Ehrenreich @jaeh
- Massi Valeskini @valeskini
Happy hacking! <3
