bih / tfgm

A simple Ruby wrapper for the Transport for Greater Manchester REST API (i.e. bus routes, car parks, metrolinks).

Transport for Greater Manchester: Unofficial Rubygem

This is a Rubygem which acts as a wrapper for the Transport for Greater Manchester REST API. This provides the most accurate car parks, bus and metrolink information available to freely consume through the opendata.tfgm.com REST API.

We built this to use internally in our project, EventRoute, for the Innovation Challenge in Manchester (which won Best Under 21). The TFGM REST API is new and unstable as of March 2013 so we would avoid using it in production.

Getting Started

• Sign up for an API Key — It's easy to sign up at developer.tfgm.com and you'll need a developer & application key. An example of what both the keys should like are: a1b23cd4-ef67-890g-h123-4567i8jk9lmn and they must be 36 characters in length.

• Install the gem

gem install tfgm

• Include it in your Ruby — Insert this at the top of your Ruby code where you'll using TFGM.

require 'tfgm'

• Create an instance of TFGM::API

instance = TFGM::API.new("Developer Key", "Application Key")

• Make it do something — if you're unsure of what it can do, scroll down to "Manual" on this page.

instance.stops_on_route('X50')

• Have fun. — Everything is returned as a Hash.new in Ruby. Use .inspect to extract data you need.

---

TFGM::API Manual

There's very limited data available, but we've outlined what's currently available below. Parameters denoted with * are mandatory.

Car Parks

• Find all car parks in Greater Manchester

# Parameters:
# (int)  *page     = default: 0
# (int)  *per_page = default: 10
instance.carparks(0, 5)

• Find a car park by ID

# Parameters:
# (int) *id
instance.carpark(21915)

Routes

• View all bus routes running in Greater Manchester

# Parameters:
# None
instance.routes

• View bus route by ID

# Parameters
# (string) *bus_code
instance.route('X50')

• Verify bus route exists

# Parameters:
# (string) *bus_code
if instance.is_route('X50') then
# Route exists, yay!
end

• Bus stops on bus route

# Parameters
# (string) *bus_code
instance.stops_on_route('X50')

Bus stops

• Find bus stops near a geolocation

# Parameters:
# (double) *latitude
# (double) *longitude
instance.bus_stops_near(52.91391221, -3.39414441)

• Find bus stop by ATCO Code

# Parameters:
# (string) *atco_code
instance.bus_stop('1800SB04781')

• Find routes running from bus stop

# Parameters:
# (string) *atco_code
instance.buses_on_stop('1800SB04781')

Metrolink times

• View all journey times

# Parameters:
# None
instance.journey_times

• View journey times for a single route

# Parameters:
# (string) *journey_id
instance.journey_times('A56-Dunham_proxy')

---

Contributing

We all know the REST API for TFGM is really buggy, but it's a great start. I'm glad that it's available and can foster innovation in the city, so if you're interested in developing it with me, just play about with it.

Let me know via @bilawalhameed on Twitter if you're interested before sending a pull request.