zhv-de

Fetch the most up-to-date release of the german central public transport stop registry (Zentrales Haltestellenverzeichnis, ZHV - available on opendata-oepnv.de as well as zhv.wvigmbh.de). Sadly, there is no static endpoint from which you could obtain this data (yet), you can use this small tool until they provide one.

Installation

npm install zhv-de

Usage

The module exposes a single method which takes user and password (you can obtain those credentials for free at the opendata-oepnv.de website) as arguments and returns a Promise that will resolve in an object-mode stream of stops.

const zhv = require('zhv-de')
const user = '<your-opendata-oepnv.de-user-email>'
const password = '<your-opendata-oepnv.de-password>'
 
const ndjson = require('ndjson') // we use this to transform objects to JSON to pipe to stdout
 
zhv(user, password)
.then(dataStream => dataStream.pipe(ndjson.stringify()).pipe(process.stdout))
.catch(console.error)

The objects emitted by the stream will look as follows (note that the keys start with a lowercase character instead of the uppercase variant used on the ZHV website):

{
    seqNo: '0',
    type: 'S',
    dHID: 'de:07334:1714',
    parent: 'de:07334:1714',
    name: 'Wörth Alte Bahnmeisterei',
    latitude: 49.048672,
    longitude: 8.266324,
    municipalityCode: '07334501',
    municipality: 'Wörth am Rhein',
    districtCode: null,
    district: null,
    condition: 'Served',
    state: undefined,
    description: undefined,
    authority: 'NVBW'
}

Contributing

If you found a bug or want to propose a feature, feel free to visit the issues page.