Deutsche Bahn elevator information, enriched (by crowdsourcing) with OSM data. You're invited to help, see the data structure and contributing sections! Using this original dataset provided by Deutsche Bahn.
Installation and Usage
If you're using
npm, you can install the package by running:
npm install db-elevators
const elevators =
elevators is an array of objects which looks as follows:
id: '10499641'description: 'zu Gleis 1'station: '8010212'location:longitude: 146713589latitude: 510993991osmNodeId: '2793052424'id: '10499642'description: 'zu Gleis 2/3'station: '8010212'location:longitude: 146713245latitude: 510995518osmNodeId: '4011664512'// …
You can use the
id to retrieve live availability information via the FaSta API.
OpenStreetMap associations are stored in
osm.ndjson, an ndjson file which contains one record per row. All records are objects with the following keys (required).
||elevator id from the main dataset||
||Id of the OSM elevator node. Note that OSM ids are not too stable, however this still seems to be the best way to associate data (for now). Additionally, tests that verify that ids are still valid and refering to an elevator are run on a daily basis.||
||Name of the station. Note that this field is required, but won't ever be parsed, we just use it to make the dataset a bit more human-readable.||
||Elevator description from the main dataset. As with
||Some entries have been automatically fetched/guessed with a heuristical approach (
Put together, our example would give us the following data row for the NDJSON file:
If you want to add information to the dataset, fork this repository, add information and finally submit a pull request. If you don't know how any of this works, you can also just open an issue with the information you want to add in text form and I'll add it to the dataset for you. The same applies if you have found an error or want to change anything about the data structure.
Please note that by contributing to this project, you waive any copyright claims on the information you add.
See the todo list for a list of stations that have not been (fully) covered yet.
If you want to contribute to this project, you can either add data to
osm.ndjson manually or use the CLI as follows:
- Clone the repository (or your fork)
git clone https://github.com/juliuste/db-elevators.git
- Navigate to the repository root
- Use the CLI to add entries to
./build/bin/index # starts the cli./build/bin/index --help # shows the help menu./build/bin/index --auto-open # starts the CLI, opens OpenStreetMap around stations automatically (only on mac OS, using 'open' CLI)