GTFS-realtime transit data is in protobuf format which means its not human-readable by default. node-GTFS-Realtime aims to make it fast and easy to inspect GTFS-realtime data by providing a one-line command for downloading GTFS-realtime format data and converting to JSON.

Run it right now from your command line:

npx gtfs-realtime http://api.bart.gov/gtfsrt/tripupdate.aspx

The command above will fetch BART's GTFS-Realtime trip updates and save them to a file to the current directory in JSON format, named like gtfs-realtime-tripupdate-2022-05-28T002330.164Z.json (using the current time). You can open the resulting file in a text editor to review.

node-GTFS-Realtime can be used as a command-line tool or as a node.js module.

Example JSON

Below is an example of the JSON result for a GTFS-Realtime Trip Updates request:

{
  "header": {
    "gtfsRealtimeVersion": "1.0",
    "incrementality": "FULL_DATASET",
    "timestamp": "1653701655"
  },
  "entity": [
    {
      "id": "1001663",
      "tripUpdate": {
        "trip": {
          "tripId": "1001663",
          "scheduleRelationship": "SCHEDULED"
        },
        "stopTimeUpdate": [
          {
            "stopSequence": 13,
            "arrival": {
              "delay": 25,
              "time": "1653701754",
              "uncertainty": 30
            },
            "departure": {
              "delay": 25,
              "time": "1653701775",
              "uncertainty": 30
            },
            "stopId": "SANL"
          }
        ]
      }
    }
  ]
}

Installation

To use this library as a command-line utility, install it globally directly from npm:

npm install gtfs-realtime -g

Or use it directly via npx:

npx gtfs-realtime@latest http://api.bart.gov/gtfsrt/tripupdate.aspx

If you are using this as a node module as part of an application, you can include it in your project's package.json file.

Quick Start

Command-Line Examples

Run via npx:

npx gtfs-realtime@latest http://api.bart.gov/gtfsrt/tripupdate.aspx

If installed globally:

gtfs-realtime http://api.bart.gov/gtfsrt/tripupdate.aspx

With custom HTTP headers

gtfs-realtime http://api.bart.gov/gtfsrt/tripupdate.aspx --header "Authorization: bearer 1234567"

Code example

import gtfsRealtime from 'gtfs-realtime';

const config = {
  url: 'http://api.bart.gov/gtfsrt/tripupdate.aspx',
  output: 'path/to/save/file.json'
};

gtfsRealtime(config)
  .then(() => {
    console.log('GTFS-Realtime Download Successful');
  })
  .catch((err) => {
    console.error(err);
  });

Command-Line Usage

gtfs-realtime [options...] <url>

The `gtfs-realtime` command-line utility will download GTFS-Realtime data from the specified URL and save it as a JSON file.

### Options

`-s, --silent`

Hides all console output

    gtfs-realtime http://api.bart.gov/gtfsrt/tripupdate.aspx --silent

`-H, --header`

Specify one or more HTTP headers to be included in the request.

    gtfs-realtime http://api.bart.gov/gtfsrt/tripupdate.aspx --header "Authorization: bearer 1234567" --header "test:true"

`-o, --output`

Specify a path to save the JSON file. Optional, defaults to the current directory using a filename with the current time.

    gtfs-realtime http://api.bart.gov/gtfsrt/tripupdate.aspx --output /path/to/save/file.json

`--help`

Show help.

    gtfs-realtime --help

`--version`

Show version

    gtfs-realtime --version

## Contributing

Pull requests are welcome, as is feedback and [reporting issues](https://github.com/blinktaginc/node-gtfs-realtime/issues).