Awesome

OJP - Open API for distributed Journey Planning

Content

This repository contains the XML Schema, examples and documentation tables for the "Open API for distributed Journey Planning" published as "CEN/TS 17118:2017: "Intelligent transport systems - Public transport - Open API for distributed journey planning".

OJP consists of a set of services that can be addressed using HTTP requests.

The main services to request information are:

• Place information
• Stop events (arrival and departure boards)
• Searching for trips
• Information about a given trip
• Information about fares for trips
• Changing of trips
• Refining of trips
• Availability for trip legs
• Information about lines

OJP systems interacting with each other additionally use:

• Getting information about Exchange Points (places when a trip switches from one OJP system to another)
• Using a multipoint trip service (n origins and m destinations)

Standard document

OJP is a CEN standard. Obtain a copy of the standard document "CEN/TS 17118:2017: "Intelligent transport systems - Public transport - Open API for distributed journey planning" at CEN.

OJP is part of the Transmodel family of standards together with NeTEx, SIRI and OpRa. It also contains elements from DATEX II.

Releases

• OJP 2.0: Latest release
• OJP 1.0.1: Bugfix release
• OJP 1.0: The version described in CEN/TS 17118:2017

GitHub Repository

Download the XSD schema files and examples in the git repository found at https://github.com/VDVde/OJP and take a look at the documentation tables.

You can contribute by:

• Pointing out issues
• Creating pull requests: Use the development documentation

Branches

• The main branch contains the latest release
• Development is done in the develop branch.
• The release/2.0 branch contains the latest v2.0 state
• The release/1.0 branch contains the latest v1.0 state

Wiki

OJP uses the wiki on GitHub for some resources and examples.

White papers

The white papers are published in the wiki as well.

Other sources

The wiki also contains links to other sources and implementations.

Regulatory environment of OJP

The "ITS Directive Delegated Regulation for provision of EU-wide multimodal travel information services" is the legal framework for travel data access and distributed journey planning in Europe. This initiative will provide the necessary requirements to make EU-wide multimodal travel information services accurate and available across borders. One of the key requirements concerns linking travel information services for distributed journey planning. Upon request, travel information service providers shall provide to another information service provider "routing results" based on static, and where possible, dynamic information. The "routing results" shall be based on:

• the enquirers start and end points of a journey along with the specific time and date of departure or arrival, or both;
• possible travel options along with the specific time and date of departure or arrival, or both, including any possible connections;
• the handover point between travel information services;
• in case of disturbances, alternative possible travel options along with the specific time and date of departure or arrival, or both, and any connections, where available.

The Delegated Regulation recommends that the CEN OPEN API standard for distributed journey planning is used by local, regional and national travel information service providers.