Skip to content

Pass in a HAFAS client, discover stations by querying departures.

License

Notifications You must be signed in to change notification settings

derhuerst/hafas-discover-stations

Repository files navigation

hafas-discover-stations

Pass in a HAFAS client, discover stops/stations by querying departures. It tries to find all stops/stations that all trains known by the endpoint stop at.

npm version ISC-licensed minimum Node.js version support me via GitHub Sponsors chat with me on Twitter

Installing

npm install hafas-discover-stations

Usage

import {createWalkAndDiscoverStations as createWalk} from 'hafas-discover-stations'
import {createClient as createHafas} from 'hafas-client'
import {profile as dbProfile} from 'hafas-client/p/db/index.js'

const hafas = createHafas(dbProfile, 'my-awesome-program')
const walk = createWalk(hafas)

const berlinFriedrichstr = '8011306' // where to start
for await (const stopOrStation of walk(berlinFriedrichstr)) {
	console.log(stopOrStation)
}

walk() returns a readable stream in object mode. It emits the following events:

  • data: a new stop/station that has been discovered
  • stats: an object with the following keys:
    • stopsAndStations: the number of stops/stations discovered
    • edges: the number of edges discovered
    • totalReqs: the number of requests sent
    • avgReqDuration: the average duration of the last 30 requests
    • queuedReqs: the number of queued requests
  • edge: a connection between two stops/stations, with the following keys:

API

walk(stationId, [opt])

opt may have the following keys. It will be passed into queue().

  • concurrency: number of requests run in parallel – default: 2
  • timeout: timeout for a single job in milliseconds – default: 10000
  • parseStationId: an optional function to process station IDs – default: id => id
  • stationLines: Query lines of stops/stations? – default: false
  • shouldQueryDeparturesAt(stopId, nrOfHops): Should departures be queries from this stopId, effectively continuing the graph search? – default: () => true

Contributing

If you have a question or need support using hafas-discover-stations, please double-check your code and setup first. If you think you have found a bug or want to propose a feature, use the issues page.