https://github.com/derhuerst/db-hafas-stations
A list of most stations known by Deutsche Bahn, fetched from their APIs.
https://github.com/derhuerst/db-hafas-stations
db deutsche-bahn railways stations
Last synced: 12 months ago
JSON representation
A list of most stations known by Deutsche Bahn, fetched from their APIs.
- Host: GitHub
- URL: https://github.com/derhuerst/db-hafas-stations
- Owner: derhuerst
- License: isc
- Created: 2018-06-19T11:00:48.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2025-03-18T23:40:12.000Z (over 1 year ago)
- Last Synced: 2025-06-23T11:55:06.375Z (about 1 year ago)
- Topics: db, deutsche-bahn, railways, stations
- Language: JavaScript
- Homepage:
- Size: 64.5 KB
- Stars: 9
- Watchers: 5
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: readme.md
- License: license-data.md
Awesome Lists containing this project
README
# db-hafas-stations
**All [*Deutsche Bahn* (DB)](https://en.wikipedia.org/wiki/Deutsche_Bahn) stations**, including local public transport (buses, trams...) stops, currently about 290k. Returned by their [RIS::Stations](https://developers.deutschebahn.com/db-api-marketplace/apis/product/ris-stations) and [StaDa](https://developers.deutschebahn.com/db-api-marketplace/apis/product/stada) APIs (DB InfraGO, [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) and [OpenStreetMap Contributors](https://www.openstreetmap.org/copyright)). These use the same `evaNumbers` and names as the DB HAFAS that historically has been the source of this data.
[](https://www.npmjs.com/package/db-hafas-stations)
[](https://github.com/sponsors/derhuerst)
[](https://twitter.com/derhuerst)
## Installation
```shell
npm install db-hafas-stations
```
*Note:* This Git repo does not contain the data, but the npm package does.
## Usage
`readSimplifiedStations()` is an [async generator function](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function*) yielding [*Friendly Public Transport Format*](https://github.com/public-transport/friendly-public-transport-format) `station` and `stop` objects, read from `db-hafas-stations/data.ndjson` (~14mb).
```js
import {
readSimplifiedStations,
readFullStations,
} from 'db-hafas-stations'
for await const (station of readSimplifiedStations()) {
console.log(station)
}
```
```js
{
type: 'station',
id: '8000007',
name: 'Alzey',
weight: 73.1,
location: {
type: 'location',
latitude: 49.7502,
longitude: 8.109749
}
}
// …
```
`readFullStations()` is an async generator function yielding objects with more fields, read from `db-hafas-stations/full.ndjson` (~112mb).
## Building
You need to subscribe to both the [RIS::Stations](https://developers.deutschebahn.com/db-api-marketplace/apis/product/ris-stations) and [StaDa](https://developers.deutschebahn.com/db-api-marketplace/apis/product/stada) API and set the corresponding environment variables `DB_CLIENT_ID` and `DB_API_KEY` before running `npm run fetch` to fetch the data from the APIs (run carefully and not frequently, the quotas are very low!) and `npm run merge`.
## Related
- [`db-hafas-stations-autocomplete`](https://github.com/derhuerst/db-hafas-stations-autocomplete#db-stations-autocomplete) – Search for stations of DB (data from HAFAS).
- [`db-stations`](https://github.com/derhuerst/db-stations#db-stations) – A collection of just the train stations of Deutsche Bahn, computed from open data.
- [`hafas-find-stations`](https://github.com/derhuerst/hafas-find-stations) – Given a HAFAS client, find all stations in a bounding box.
- [`hafas-discover-stations`](https://github.com/derhuerst/hafas-discover-stations#hafas-discover-stations) – Pass in a HAFAS client, discover stations by querying departures.
- [`db-stops-search`](https://github.com/derhuerst/db-stops-search) – Search through all stops/stations in `db-hafas-stations`. Formats and imports the stops into a Meilisearch instance.
## Contributing
If you have a question or have difficulties using `db-hafas-stations`, please double-check your code and setup first. If you think you have found a bug or want to propose a feature, refer to [the issues page](https://github.com/derhuerst/db-hafas-stations/issues).