gtfs-to-html converts transit data in GTFS format into user-friendly HTML schedules. Many transit agencies have schedule data in GTFS format but need to show each route's schedule to users on a website. This project aims to automate the process of creating these schedules. Automating HTML schedule generation makes it easy to keep schedules up to date when data changes and reduces the likelihood of errors.

gtfs-to-html uses the node-gtfs library to handle importing and querying GTFS data.

gtfs-to-html is currently used by Sonoma Country Transit to generate schedule pages for each route.

Install gtfs-to-html directly from npm:

npm install mongoose gtfs-to-html -g

gtfs-to-html --configPath /path/to/your/custom-config.json

const gtfsToHTML = require('gtfs-to-html');
const config = require('config.json');

gtfsToHTML(config, (err) => {
  if (err) return console.error(err);

  console.log('HTML Generation Successful')
});

Copy config-sample.json to config.json and then add your projects configuration to config.json.

cp config-sample.json config.json

{Array} Specify the GTFS files to be imported in an agencies array. GTFS files can be imported via a url or a local path.

Each file needs an agency_key, a short name you create that is specific to that GTFS file. For GTFS files that contain more than one agency, you only need to list each GTFS file once in the agencies array, not once per agency that it contains.

To find an agency's GTFS file, visit transitfeeds.com. You can use the URL from the agency's website or you can use a URL generated from the transitfeeds.com API along with your API token.

• Specify a download URL:

{
  "agencies": [
    {
      "agency_key": "county-connection",
      "url": "http://cccta.org/GTFS/google_transit.zip"
    }
  ]
}

• Specify a path to a zipped GTFS file:

{
  "agencies": [
    {
      "agency_key": "myAgency",
      "path": "/path/to/the/gtfs.zip"
    }
  ]
}

• Specify a path to an unzipped GTFS file:

{
  "agencies": [
    {
      "agency_key": "myAgency",
      "path": "/path/to/the/unzipped/gtfs/"
    }
  ]
}

• Exclude files - if you don't want all GTFS files to be imported, you can specify an array of files to exclude.

{
  "agencies": [
    {
      "agency_key": "myAgency",
      "path": "/path/to/the/unzipped/gtfs/",
      "exclude": [
        "shapes",
        "stops"
      ]
    }
  ]
}

• Optionally specify a proj4 projection string to correct poorly formed coordinates in the GTFS file

{
  "agencies": [
    {
      "agency_key": "myAgency",
      "path": "/path/to/the/unzipped/gtfs/",
      "proj": "+proj=lcc +lat_1=46.8 +lat_0=46.8 +lon_0=0 +k_0=0.99987742 +x_0=600000 +y_0=2200000 +a=6378249.2 +b=6356515 +towgs84=-168,-60,320,0,0,0,0 +pm=paris +units=m +no_defs"
    }
  ]
}

{String} This is printed at the top of the timetable.

    "effectiveDate": "July 8, 2015"

{String} The MongoDB URI use. When running locally, you may want to use mongodb://localhost:27017/gtfs.

{
  "mongoUrl": "mongodb://localhost:27017/gtfs",
  "agencies": [
    {
      "agency_key": "myAgency",
      "path": "/path/to/the/unzipped/gtfs/"
    }
  ]
}

{Boolean} Whether or not to skip the HTML head and footer when generating the HTML. Defaults to false.

    "noHead": false

{String} The symbol to be used when a specific trip does not serve a specified stop. Defaults to -.

    "noServiceSymbol": "-"

{String} The symbol to be used to indicate that riders must request a stop. Defaults to ***.

    "requestStopSymbol": "***"

{Boolean} Whether or not to show a map of the route on the timetable. Defaults to false.

    "showMap": false

{Boolean} Whether or not all stops should be shown, or only stops with a timepoint value in stop_times.txt that is considered exact (i.e. empty or 1). Defaults to false, all stops shown.

    "showOnlyTimepoint": false

{Boolean} Whether or not to show the city for each stop. City is determined by the stop_city field in the non-standard stop_attributes.txt. Only has an effect when the timetable's orientation is horizontal. Defaults to false.

    "showStopCity": false

{Boolean} If you don't want the import script to print any output to the console, you can set verbose to false. Defaults to true.

    "verbose": false

{Boolean} Whether or not to zip the output into one zip file. Defaults to false.

    "zipOutput": false

This project requires that an additional file timetables.txt be added to an agencies GTFS. This file specifies which HTML timetables should be built.

An example of this file is located in examples/timetables.txt. The format of this file is:

To allow creating a single timetable for multiple routes that overlap, you can have multiple entries in timetables.txt for the same timetable_id. These multi-route entries should have the same values timetable_id, start_date, end_date, calendar date, service_notes and orientation fields and should have different values for the route_id and route_label fields.

This is an optional file that can specify stop order for a particular timetable. It is useful when generating combined timetables for multiple overlapping routes, or exerting fine-grained control on stop order.

An example of this file is located in examples/timetable_stop_order.txt. The format of this file is:

Ensure than mongodb is running locally.

mongod

To generate HTML timetables, run gtfs-to-html.

gtfs-to-html

By default, gtfs-to-html will look for a config.json file in the project root. To specify a different path for the configuration file:

gtfs-to-html --configPath /path/to/your/custom-config.json

This will download the GTFS file specified in config.js . Then, gtfs-to-html will build the HTML timetables and save them in html/:agency_key.

configPath

gtfs-to-html --configPath /path/to/your/custom-config.json

noHead

gtfs-to-html --noHead

This will generate embeddable HTML without an <html>, <head> or <body> tag.

After an initial run of gtfs-to-html, the GTFS data will be downloaded and loaded into mongo.

You can view an individual route HTML on demand by running the included express app:

node app.js

By default, gtfs-to-html will look for a config.json file in the project root. To specify a different path for the configuration file:

node app.js --configPath /path/to/your/custom-config.json

Once running, you can view the HTML in your browser at localhost:3000

Pull requests are welcome, as is feedback and reporting issues.

With this running, you can open http://localhost:3000 in your browser and view all timetables. Note that this only works after GTFS has been imported to mongodb and mongodb is running locally.

npm run lint