build-mav-gtfs

build-mav-gtfs

Build GTFS from the Magyar Államvasutak (MÁV, Hungarian State Railways) REST API using the mav JS module. Please ask MÁV for permission before using this module in production.

Please note that the data basis used by the MÁV API allows GTFS data to be generated only 25 days in advance.

Work in progress. This software is not stable yet. See the to-do section.

Installation

Library

npm install --save build-mav-gtfs

CLI

npm install -g build-mav-gtfs

Usage

Library

The script takes a startDate and an endDate JS Date() object (the feed will include the endDate, days will be calculated in Europe/Lisbon timezone) and return a Promise that will resolve in an object containing GTFS object streams:

const generateGTFS = require('build-mav-gtfs')

generateGTFS(new Date("2017-12-01T00:00:00"), new Date("2018-05-31T00:00:00"))
.then((gtfs) => {
    gtfs.routes.pipe(someStream)
    gtfs.stops.pipe(anotherStream)
})

The GTFS object contains the following streams:

• agency
• stops
• routes
• trips
• stop_times
• calendar_dates
• feed_info

CLI

build-mav-gtfs start-date end-date directory
build-mav-gtfs 01.12.2017 31.05.2018 ~/cp-gtfs

To do

• minify/optimize gtfs calendar_dates to calendar

@juliuste will be working on this the next few days.

See also

• mav - Magyar Államvasutak API client in JavaScript
• build-cp-gtfs - Build GTFS from the Comboios de Portugal (CP, Portugese Railways) REST API
• db-api-to-gtfs - Build GTFS from the Deutsche Bahn (DB, German Railways) REST API

Contributing

If you found a bug, want to propose a feature or feel the urge to complain about your life, feel free to visit the issues page.