This is a custom, interim version of hafas-client#134
published as @bahn-x/hafas-rest-exe-client
. It may be outdated or missing upstream features.
npm install @bahn-x/hafas-rest-exe-client
A client for HAFAS public transport APIs. Sort of like public-transport-enabler, but with a smaller scope. It contains customisations for the following transport networks:
There are also client libraries that use the library, but contain their own customisations:
HAFAS endpoint | library |
---|---|
Betriebsstellen & disturbances in the German rail network | db-netz-hafas |
There's a company called HaCon that sells a public transport management system called HAFAS. It is used by companies all over Europe to serve routing and departure information for apps. All those endpoints are similar, with the same terms and API routes, but have slightly different options, filters and sets of enabled features.
hafas-client
contains all logic for communicating with these, as well as serialising from and parsing to Friendly Public Transport Format (FPTF) 1.2.0
. Endpoint-specific customisations (called profiles here) increase the quality of the returned data.
npm install hafas-client
with react-native
hafas-client
as well its dependencies use Node-builtin modules and Node globals. To be able to use it within react-native, follow the instructions at node-libs-react-native
.
const createClient = require('hafas-client')
const dbProfile = require('hafas-client/p/db')
// create a client with Deutsche Bahn profile
const client = createClient(dbProfile, 'my-awesome-program')
// Berlin Jungfernheide to München Hbf
client.journeys('8011167', '8000261', {results: 1})
.then(console.log)
.catch(console.error)
The returned Promise
will resolve with an object with an array journeys
that contains one FPTF journey
.
{
journeys: [ {
legs: [ {
id: '1|100067|48|81|17122017',
origin: {
type: 'station',
id: '8089100',
name: 'Berlin Jungfernheide (S)',
location: {
type: 'location',
latitude: 52.530291,
longitude: 13.299451
},
products: { /* … */ }
},
departure: '2017-12-17T17:05:00+01:00',
departurePlatform: '5',
destination: {
type: 'station',
id: '8089118',
name: 'Berlin Beusselstraße',
location: { /* … */ },
products: { /* … */ }
},
arrival: '2017-12-17T17:08:00+01:00',
arrivalPlatform: '1',
line: {
type: 'line',
id: '41172',
name: 'S 41',
public: true,
mode: 'train',
product: 'suburban',
operator: {
type: 'operator',
id: 's-bahn-berlin-gmbh',
name: 'S-Bahn Berlin GmbH'
}
},
direction: 'Ringbahn ->'
}, /* … */ {
origin: {
type: 'station',
id: '730749',
name: 'Berlin Hauptbahnhof (S+U), Berlin',
location: {
type: 'location',
latitude: 52.526461,
longitude: 13.369378
},
products: { /* … */ }
},
departure: '2017-12-17T17:25:00+01:00',
destination: {
type: 'station',
id: '8098160',
name: 'Berlin Hbf (tief)',
location: { /* … */ },
products: { /* … */ }
},
arrival: '2017-12-17T17:33:00+01:00',
public: true,
walking: true
}, {
id: '1|70906|0|81|17122017',
origin: {
type: 'station',
id: '8098160',
name: 'Berlin Hbf (tief)',
location: { /* … */ },
products: { /* … */ }
},
departure: '2017-12-17T17:37:00+01:00',
departurePlatform: '1',
destination: {
type: 'station',
id: '8000261',
name: 'München Hbf',
location: { /* … */ },
products: { /* … */ }
},
arrival: '2017-12-17T22:45:00+01:00',
arrivalPlatform: '13',
line: { /* … */ },
direction: 'München Hbf'
} ],
origin: {
type: 'station',
id: '8089100',
name: 'Berlin Jungfernheide (S)',
location: { /* … */ },
products: { /* … */ }
},
departure: '2017-12-17T17:05:00+01:00',
destination: {
type: 'station',
id: '8000261',
name: 'München Hbf',
location: { /* … */ },
products: { /* … */ }
},
arrival: '2017-12-17T22:45:00+01:00',
price: {
amount: null,
hint: 'No pricing information available.'
}
} ],
earlierRef: /* … */,
laterRef: /* … */
}
public-transport-enabler
– Unleash public transport data in your Java project.- Friendly Public Transport Format – A format for APIs, libraries and datasets containing and working with public transport data.
db-hafas
– JavaScript client for the DB HAFAS API.vbb-hafas
– JavaScript client for Berlin & Brandenburg public transport HAFAS API.observe-hafas-client
– Observe all departures/arrivals/etc. returned byhafas-client
.cached-hafas-client
– Pass in ahafas-client
instance, cache data from it.hafas-client-rpc
– Make JSON-RPC calls tohafas-client
via WebSockets & stdio.hafas-client-health-check
– Check if ahafas-client
instance and its endpoint work.hafas-rest-api
– Expose a HAFAS client via an HTTP REST API.- List of european long-distance transport operators, available API endpoints, GTFS feeds and client modules.
- Collection of european transport JavaScript modules.
hafas-collect-departures-at
– Utility to collect departures, using any HAFAS client.hafas-monitor-trips
– Using a HAFAS client, watch all trips in a bounding box.hafas-monitor-departures
– Pass in a HAFAS client, fetch all departures at any set of stations.hafas-record-delays
– Record delays fromhafas-monitor-departures
into a LevelDB.hafas-monitor-journeys
– Usehafas-client
to monitor journeys from A to B.hafas-discover-stations
– Pass in a HAFAS client, discover stations by querying departures.hafas-estimate-station-weight
– Pass in a HAFAS client, estimate the importance of a station.
If you have a question, found a bug or want to propose a feature, have a look at the issues page.