OpenTripPlanner

Instructions to get you started with using OS MRN in OpenTripPlanner.

OpenTripPlanner (OTP) is an open source multi-modal trip planner, focussing on travel by scheduled public transportation in combination with bicycling, walking, and mobility services, including bike share and ride hailing.

What you need

• Java Virtual Machine (JVM) (Java 17+)

To find out if you have Java installed:

1. Open PowerShell / Command Prompt (Windows) or Shell (Linux) and type:

java -version

1. Press Enter. If Java is installed, you should see a few lines of text detailing which version you have installed. If you get something along the lines of "java is not recognized ...", please download JVM [or OpenJDK] using the link above in 'What you need'.

Basic usage

In terms of creating a transit network using OS MRN, you'll require the following files (ensure that they are stored in the same directory):

• The otp-2.5.0-shaded.jar"shaded" JAR (Java ARchive) containing OTP and all other libraries needed for it to work.

• Some General Transit Feed Specification (GTFS) data for Transit Schedules and Stops, for example, Bus Open Data Service (BODS).

• OS MRN Protocolbuffer Binary Format (PBF) data downloaded from the OS Data Hub (OSMulti-modalRoutingNetwork.pbf).

The General Transit Feed Specification (GTFS) is an Open Standard used to distribute relevant information about transit systems to riders. It allows public transit agencies to publish their transit data in a format that can be consumed by a wide variety of software applications.

The Bus Open Data Service (BODS) provides bus timetable, vehicle location and fares data for every local bus service in England.

The OpenTripPlanner Basic Tutorial provides a detailed set on instructions of how to get the interactive OTP instance up-and-running, but fundamentally the steps are as follows:

1. Open PowerShell / Command Prompt (Windows) or Shell (Linux) and navigate to the folder where the OTP JAR, BODS GTFS, and OS MRN PBF files have been stored.

2. Run the following command to start the service: java -Xmx8G -jar otp-2.5.0-shaded.jar --build --serve . --port 8801.

3. Go to http://localhost:8801/ in a web browser.

   

   OpenTripPlanner UI showing example itineraries in the map area which were created using OS MRN and GTFS bus timetable information in OpenTripPlanner.