Public Transport — Open API for Distributed Journey Planning
Total Page:16
File Type:pdf, Size:1020Kb
CEN/TC 278 Date: 2017-01 TC 278 WI 00278420 CEN/TC 278 Secretariat: NEN Public transport — Open API for distributed journey planning Einführendes Element — Haupt-Element — Ergänzendes Element Élément introductif — Élément central — Élément complémentaire ICS: Descriptors: Document type: Technical Specification Document subtype: Document stage: Working Document Document language: E C:\Data\Clients\Ministere\SG8\Alignement\Doc\DJPS-final3\TC_278_WI_00278420_(E)-RS-170118- final3.doc STD Version 2.7g TC 278 WI 00278420:2017(E) Contents Page European Foreword ...................................................................................................................................................... 5 0 Introduction ...................................................................................................................................................... 6 0.1 General ................................................................................................................................................................ 6 0.2 An Open API for distributed journey planning (OJP) ......................................................................... 6 0.3 The public transport information tensions ........................................................................................... 7 0.4 Distributed journey planning architecture beyond scope ............................................................... 8 0.4.1 The distributed journey planning approach ......................................................................................... 8 0.4.2 Distributed or centralised approaches ................................................................................................... 8 0.4.3 The basis for the Open API ........................................................................................................................... 9 0.4.4 Other possible uses for the Open API ....................................................................................................... 9 0.5 The European ITS Directive ........................................................................................................................ 9 1 Scope ................................................................................................................................................................. 10 2 Normative references ................................................................................................................................. 10 3 Terms and definitions ................................................................................................................................ 11 3.1 Introduction ................................................................................................................................................... 11 3.2 Explanation of terms used in OJP schema ........................................................................................... 11 3.3 Explanation of extension terms in OJP Schema ................................................................................. 22 4 Symbols and abbreviations ...................................................................................................................... 24 5 Use cases .......................................................................................................................................................... 25 5.1 General ............................................................................................................................................................. 25 5.2 Key tasks for Distributed Journey Planning ....................................................................................... 26 5.2.1 Planning a component of a trip ............................................................................................................... 26 5.2.2 Discovering relevant stops ....................................................................................................................... 27 5.2.3 Obtaining information about accessibility and services for those with special needs ....... 27 5.2.4 Seeking route information that can be displayed on maps .......................................................... 27 5.3 Other possible tasks for a Distributed Journey Planning system ............................................... 28 5.3.1 Requesting a stop timetable ..................................................................................................................... 28 5.3.2 Requesting times for all intermediate stops in a trip ..................................................................... 28 5.3.3 Requesting expected events at a particular stop .............................................................................. 28 5.3.4 Requesting information about the fares and ticket options for a particular trip ................. 28 5.3.5 Other possible questions ........................................................................................................................... 28 6 System Architectures, Metadata and Data .......................................................................................... 29 6.1 General considerations .............................................................................................................................. 29 6.2 Metadata requirements ............................................................................................................................. 30 6.3 Core data requirements ............................................................................................................................. 31 7 Open API for Distributed Journey Planning – OJP Services .......................................................... 33 7.1 Departure Monitor ...................................................................................................................................... 33 7.1.1 Purpose ............................................................................................................................................................ 33 7.1.2 Interactions .................................................................................................................................................... 34 7.1.3 Concerned Components ............................................................................................................................. 34 7.1.4 Function 1: Departure Monitor ............................................................................................................... 34 7.2 Fare Information .......................................................................................................................................... 35 2 TC 278 WI 00278420:2017(E) 7.2.1 Purpose ............................................................................................................................................................ 35 7.2.2 Interactions ..................................................................................................................................................... 35 7.2.3 Concerned Components ............................................................................................................................. 36 7.2.4 Function 1: Tariff Zones for Stop / Station .......................................................................................... 36 7.2.5 Function 2: Static Fare Information ....................................................................................................... 37 7.2.6 Function 3: Trip-Related Fare Information ......................................................................................... 37 7.3 Location text matching ............................................................................................................................... 37 7.3.1 Purpose ............................................................................................................................................................ 37 7.3.2 Interactions ..................................................................................................................................................... 38 7.3.3 Concerned Components ............................................................................................................................. 38 7.3.4 Function: Location text matching ........................................................................................................... 38 7.4 Object Information Service ....................................................................................................................... 38 7.4.1 Purpose ............................................................................................................................................................ 38 7.4.2 Interactions ..................................................................................................................................................... 39 7.4.3 Concerned Components ............................................................................................................................. 39 7.4.4 Function 1: Object Information ............................................................................................................... 39 7.4.5 Function 2: Finding relevant exchange points ................................................................................... 39 8 Open API for Distributed Journey Planning – Interface Description ........................................