https://github.com/VDVde/OJP
Open API for distributed journey planning. CEN/TS 17118:2017.
https://github.com/VDVde/OJP
Last synced: 4 months ago
JSON representation
Open API for distributed journey planning. CEN/TS 17118:2017.
- Host: GitHub
- URL: https://github.com/VDVde/OJP
- Owner: VDVde
- Created: 2018-06-08T13:34:10.000Z (almost 7 years ago)
- Default Branch: develop
- Last Pushed: 2024-09-25T16:30:37.000Z (8 months ago)
- Last Synced: 2024-10-03T08:05:31.416Z (8 months ago)
- Language: XSLT
- Homepage: https://www.vdv.de/open-journey-planner.aspx
- Size: 6.68 MB
- Stars: 22
- Watchers: 15
- Forks: 12
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
- trackawesomelist - OJP (⭐22) - Open Journey Planner. (Recently Updated / [Oct 02, 2024](/content/2024/10/02/README.md))
README
# OJP - *O*pen API for distributed *J*ourney *P*lanning
## Content
This repository contains the XML Schema, examples and documentation tables for the "**O**pen API for distributed **J**ourney **P**lanning" 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"](https://standards.cen.eu/dyn/www/f?p=204:110:0::::FSP_PROJECT:62236&cs=1985DBD613F25D179FB65A73B0FDA4DB7) at [CEN](https://www.cen.eu).
OJP is part of the [Transmodel](https://www.transmodel-cen.eu/) family of standards together with [NeTEx](https://netex-cen.eu/), [SIRI](https://www.transmodel-cen.eu/siri-standard/) and [OpRa](https://www.opra-cen.eu/). It also contains elements from [DATEX II](https://datex2.eu/).
## Releases
* [OJP 2.0](https://github.com/VDVde/OJP/releases/tag/v2.0): Latest release
* [OJP 1.0.1](https://github.com/VDVde/OJP/releases/tag/v1.0.1): Bugfix release
* [OJP 1.0](https://github.com/VDVde/OJP/releases/tag/v1.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](https://vdvde.github.io/OJP/index.html).
You can contribute by:
* Pointing out [issues](https://github.com/VDVde/OJP/issues)
* Creating pull requests: Use the [development documentation](https://github.com/VDVde/OJP/wiki/WG:-:-Working-with-this-repository)
### Branches
* The [main branch](https://github.com/VDVde/OJP/tree/main) contains the latest release
* Development is done in the [develop branch](https://github.com/VDVde/OJP/tree/develop).
* The [release/2.0 branch](https://github.com/VDVde/OJP/tree/release/2.0) contains the latest v2.0 state
* The [release/1.0 branch](https://github.com/VDVde/OJP/tree/release/1.0) contains the latest v1.0 state
### Wiki
OJP uses the [wiki](https://github.com/VDVde/OJP/wiki) on GitHub for some resources and examples.
### White papers
The [white papers](https://github.com/VDVde/OJP/wiki/Whitepapers-on-OJP) are published in the wiki as well.
### Other sources
The wiki also contains links to other sources and [implementations](https://github.com/VDVde/OJP/wiki/Implementations-and-Tests).
## Regulatory environment of OJP
The "[ITS Directive Delegated Regulation for provision of EU-wide multimodal travel information services](https://transport.ec.europa.eu/transport-themes/smart-mobility/road/its-directive-and-action-plan/multimodal-travel-information_en)" 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.