diff --git a/CHANGELOG.md b/CHANGELOG.md index 533df3fd..4b520dbb 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -79,7 +79,7 @@ The releases can be found at https://github.com/VDVde/OJP/releases [#83](https://github.com/VDVde/OJP/pull/83) * Added parameter `NoSight` to `BaseTripMobilityFilterGroup` to allow requesting a trip for a blind user. [#36](https://github.com/VDVde/OJP/pull/36) -* Added a `TripStatusGroup` consisting of parameters which describe the current status of a trip, e.g. `Cancelled` / `Delayed` / `Infeasible`. +* Added a `TripStatusGroup` consisting of parameters which describe the current status of a trip, e.g., `Cancelled` / `Delayed` / `Infeasible`. [#116](https://github.com/VDVde/OJP/pull/116) * Added an optional `ProductCategory` of a `Service`. As defined in NeTEx and SIRI, a product category is a classification for VEHICLE JOURNEYs to express some common properties of journeys for marketing and fare products. diff --git a/OJP/OJP_Availability.xsd b/OJP/OJP_Availability.xsd index 804cff93..b9466b12 100644 --- a/OJP/OJP_Availability.xsd +++ b/OJP/OJP_Availability.xsd @@ -363,7 +363,7 @@ - Assistance for unboarding. + Assistance for alighting. @@ -403,7 +403,7 @@ - The vehicle is not available due to existing rules like operating hours or not competing against an existing public transport line. In the details of the problem there should be information indicating which rules were violated: e.g. The desired MOBILITY SERVICE can't be provided because there exists a regulare line for this TRIP. + The vehicle is not available due to existing rules like operating hours or not competing against an existing public transport line. In the details of the problem there should be information indicating which rules were violated: e.g., The desired MOBILITY SERVICE can't be provided because there exists a regular line for this TRIP. diff --git a/OJP/OJP_Common.xsd b/OJP/OJP_Common.xsd index dd665a32..116c76f0 100644 --- a/OJP/OJP_Common.xsd +++ b/OJP/OJP_Common.xsd @@ -73,7 +73,7 @@ - An oriented correspondence from one LINK or ROUTE of a source layer, onto an entity in a target layer: e.g. LINK SEQUENCE. As OJP is reduced in relation to NeTEx, we use a simple general structure. + An oriented correspondence from one LINK or ROUTE of a source layer, onto an entity in a target layer: e.g., LINK SEQUENCE. As OJP is reduced in relation to NeTEx, we use a simple general structure. @@ -147,7 +147,7 @@ - Reference to a product category. Product categories should be defined once and used uniformly in all channels (e.g. NeTEx, SIRI, OJP). + Reference to a product category. Product categories should be defined once and used uniformly in all channels (e.g., NeTEx, SIRI, OJP). @@ -160,7 +160,7 @@ - Reference to a GROUP of DIRECTIONs of the ROUTEs belonging to the same LINE created for the purpose of filtering and organising timetables. + Reference to a GROUP of DIRECTIONs of the ROUTEs belonging to the same LINE created for the purpose of filtering and organising timetables. @@ -297,7 +297,7 @@ - This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g. dragLift) or the LINE is only made available to certain passenger groups (e.g. school buses, hotel shuttles). + This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g., dragLift) or the LINE is only made available to certain passenger groups (e.g., school buses, hotel shuttles). @@ -368,7 +368,7 @@ - Bit pattern for operating days between start date and end date. The length of the pattern is equal to the number of days from start date to end date. A bit value of "1" indicates that an event actually happens on the day that is represented by the bit position. + Bit pattern for operating days between start date and end date. The length of the pattern is equal to the number of days from start date to end date. A bit value of "1" indicates that an event happens on the day that is represented by the bit position. @@ -385,7 +385,7 @@ - Textual description of the operation days, e.g. "monday to friday" or "not on holidays". + Textual description of the operation days, e.g., "Monday to Friday" or "not on holidays". diff --git a/OJP/OJP_Fare.xsd b/OJP/OJP_Fare.xsd index 6625ccb0..273d769f 100644 --- a/OJP/OJP_Fare.xsd +++ b/OJP/OJP_Fare.xsd @@ -66,7 +66,7 @@ - Sub-request: PLACE related fare information. This doesn't make a lot of sense for addresses, topographic place and coordinates. However, STOP PLACE, SCHEDULED STOP POINT and POINT OF INTEREST are different. + Sub-request: PLACE related fare information. This doesn't make a lot of sense for addresses, topographic place, and coordinates. However, STOP PLACE, SCHEDULED STOP POINT and POINT OF INTEREST are different. @@ -81,7 +81,7 @@ - Reference to a FareProduct. If no FareProductRef is specified the responding system should reply with information about all available fare products. + Reference to a FareProduct. If no FareProductRef is specified, the responding system should reply with information about all available fare products. @@ -98,7 +98,7 @@ - Reference to a FareProduct. If no FareProductRef is specified the responding system should reply with information about all available fare products. + Reference to a FareProduct. If no FareProductRef is specified, the responding system should reply with information about all available fare products. @@ -229,7 +229,7 @@ - The involved PLACE. Usually a StopPoint, StopPlace or PointOfInterest. + The involved PLACE. Usually,a StopPoint, StopPlace or PointOfInterest. diff --git a/OJP/OJP_FareSupport.xsd b/OJP/OJP_FareSupport.xsd index a47c37c2..0f9a10b0 100644 --- a/OJP/OJP_FareSupport.xsd +++ b/OJP/OJP_FareSupport.xsd @@ -156,7 +156,7 @@ - Type for an International phone number. + Country + MSISDN e.g. +41 675601 etc. + Type for an International phone number. + Country + MSISDN e.g., +41 675601 etc. @@ -271,7 +271,7 @@ - Purchase can only be made in advance of travel (e.g. for season ticket or advance ticket). + Purchase can only be made in advance of travel (e.g., for season ticket or advance ticket). @@ -514,20 +514,20 @@ - [a specific form of TRAVEL DOCUMENT in TM and NeTEx] Precondition to access a service or to purchase a FARE PRODUCT issued by an organisation that may not be a PT operator (e.g. military card, concessionary card, ...). In most cases, ENTITLEMENT PRODUCTs offer discounts, e.g. the "BahnCard50" of "Deutsche Bahn". + [a specific form of TRAVEL DOCUMENT in TM and NeTEx] Precondition to access a service or to purchase a FARE PRODUCT issued by an organisation that may not be a PT operator (e.g., military card, concessionary card). In most cases, ENTITLEMENT PRODUCTs offer discounts, e.g., the "BahnCard50" of "Deutsche Bahn". - Identifier of an ENTITLEMENT PRODUCT (e.g. BahnCard50, BahnCard50First, military card, concessionary card, ...). It is defined by the fare authority. + Identifier of an ENTITLEMENT PRODUCT (e.g., BahnCard50, BahnCard50First, military card, concessionary card). It is defined by the fare authority. - [a specific form of TRAVEL DOCUMENT in TM and NeTEx] Precondition to access a service or to purchase a FARE PRODUCT issued by an organisation that may not be a PT operator (e.g. military card, concessionary card, ...). In most cases, ENTITLEMENT PRODUCTs offer discounts, e.g. the "BahnCard50" of "Deutsche Bahn". + [a specific form of TRAVEL DOCUMENT in TM and NeTEx] Precondition to access a service or to purchase a FARE PRODUCT issued by an organisation that may not be a PT operator (e.g., military card, concessionary card). In most cases, ENTITLEMENT PRODUCTs offer discounts, e.g., the "BahnCard50" of "Deutsche Bahn". @@ -537,7 +537,7 @@ - Identifier of the ENTITLEMENT PRODUCT (e.g. BahnCard50, BahnCard50First, ...) + Identifier of the ENTITLEMENT PRODUCT (e.g., BahnCard50, BahnCard50First) @@ -570,7 +570,7 @@ - Is this product a proto product? Default is false. If true, it should not be shown to the user. In a distributed environment (e.g. EU-Spirit) partial systems may generate incomplete product information (proto product), which has to be processed further and combined with other information before it is a complete fare product and can be shown to the user. See https://eu-spirit.eu/ + Is this product a proto product? Default is false. If true, it should not be shown to the user. In a distributed environment (e.g., EU-Spirit) partial systems may generate incomplete product information (proto product), which has to be processed further and combined with other information before it is a complete fare product and can be shown to the user. See https://eu-spirit.eu/ @@ -601,7 +601,7 @@ - iso 4217 currency code, e.g. EUR for Euro or GBP for Pound Sterling + iso 4217 currency code, e.g., EUR for Euro or GBP for Pound Sterling @@ -623,7 +623,7 @@ - One or more ENTITLEMENT PRODUCTs required for the purchase of this FareProduct. In most cases, ENTITLEMENT PRODUCTs offer discounts, e.g. the "BahnCard50" of "Deutsche Bahn". + One or more ENTITLEMENT PRODUCTs required for the purchase of this FareProduct. In most cases, ENTITLEMENT PRODUCTs offer discounts, e.g., the "BahnCard50" of "Deutsche Bahn". @@ -697,7 +697,7 @@ - Structure of a single TripFareResult. This may cover the whole trip or only the part the service can answer. If only partial answers can be delivered, then this must be indicated with FARE_ADDITIONALTICKETS (as a warning). For a given trip multiple FareResults may need to be combined to get the whole tariff. A typical example may be classic public transport and a sharing leg. Some legs, e.g. TransferLegs and walking ContinuousLeg will never have a price. The service may include them in one of the tickets. If the whole trip is for free, then a TripFareResult with a price of 0 is expected. It is possible to have combined FareResults (e.g. for a bundle) and in addition price each leg individually. + Structure of a single TripFareResult. This may cover the whole trip or only the part the service can answer. If only partial answers can be delivered, then this must be indicated with FARE_ADDITIONALTICKETS (as a warning). For a given trip multiple FareResults may need to be combined to get the whole tariff. A typical example may be classic public transport and a sharing leg. Some legs, e.g., TransferLegs and walking ContinuousLeg will never have a price. The service may include them in one of the tickets. If the whole trip is for free, then a TripFareResult with a price of 0 is expected. It is possible to have combined FareResults (e.g., for a bundle) and in addition price each leg individually. @@ -709,7 +709,7 @@ - A ticket may be valid for multiple non-consequtive legs. TransferLegs and ContinuousLegs without a tariff may be either included or ignored. If the tariff depends on not having a ContinuousLeg e.g. with sharing in the middle, then the server must decide, if it wants to provide more than one TripFareResult. + A ticket may be valid for multiple non-consequtive legs. TransferLegs and ContinuousLegs without a tariff may be either included or ignored. If the tariff depends on not having a ContinuousLeg e.g., with sharing in the middle, then the server must decide, if it wants to provide more than one TripFareResult. @@ -719,7 +719,7 @@ - One ore more FareProducts that are valid for this part of the trip. + One or more FareProducts that are valid for this part of the trip. @@ -785,7 +785,7 @@ - Fare class for which to retrieve FareProducts. Refers to TYPE OF FARE CLASS (e.g. first class). Transmodel: CLASS OF USE. + Fare class for which to retrieve FareProducts. Refers to TYPE OF FARE CLASS (e.g., first class). Transmodel: CLASS OF USE. @@ -839,7 +839,7 @@ - Fare calculation is not possible because the suggested trip is not in compliance with the fare regulations, e.g. because of round trips, LEGs that go forth and return or exceed the maximal total trip duration. + Fare calculation is not possible because the suggested trip is not in compliance with the fare regulations, e.g., because of round trips, LEGs that go forth and return or exceed the maximal total trip duration. diff --git a/OJP/OJP_JourneySupport.xsd b/OJP/OJP_JourneySupport.xsd index f5664e57..fe59453c 100644 --- a/OJP/OJP_JourneySupport.xsd +++ b/OJP/OJP_JourneySupport.xsd @@ -25,17 +25,17 @@ - Full name of this product category, e.g. "Autoreisezug" in Switzerland or "Dampfschiff" + Full name of this product category, e.g., "Autoreisezug" in Switzerland or "Dampfschiff" - Short name or acronym of the product category, likely to be published, e.g. "BAV", "ARZ", "TGV". The product category is more important for publication in Switzerland than Mode / Submode. + Short name or acronym of the product category, likely to be published, e.g., "BAV", "ARZ", "TGV". The product category is more important for publication in Switzerland than Mode / Submode. - A reference to the product category. This is the internal code used within the reference frameworks (NeTEx, SIRI). It is usually not displayed, but interpreted by the technical system, e.g. "ch:1:TypeOfProductCategory:ARZ" (Autoreisezug in Switzerland) or "ch:1:TypeOfProductCategory:BAV". + A reference to the product category. This is the internal code used within the reference frameworks (NeTEx, SIRI). It is usually not displayed, but interpreted by the technical system, e.g., "ch:1:TypeOfProductCategory:ARZ" (Autoreisezug in Switzerland) or "ch:1:TypeOfProductCategory:BAV". @@ -59,7 +59,7 @@ - Services running combined with at least parts of this journey, e.g. wing trains. The contained stop sequence interval refers to the original journey. + Services running combined with at least parts of this journey, e.g., wing trains. The contained stop sequence interval refers to the original journey. @@ -110,12 +110,12 @@ - A product category for the service. This is a classification defined in NeTEx/SIRI used to identify groups of journeys with some special properties for marketing and fare products, e.g. "TE2" for SNCF or a special panorama train "PE" in Switzerland. + A product category for the service. This is a classification defined in NeTEx/SIRI used to identify groups of journeys with some special properties for marketing and fare products, e.g., "TE2" for SNCF or a special panorama train "PE" in Switzerland. - Line name or service description as known to the public, e.g. "512", "S8" or "Circle Line" or "ICE 488". + Line name or service description as known to the public, e.g., "512", "S8" or "Circle Line" or "ICE 488". @@ -130,22 +130,22 @@ - References to the OPERATORS. Multiple OPERATORS in case a ContinuousLeg can be operated by more than one operator, especially in the ALTERNATIVE MODE OF OPERATION where there can be dozens of taxi companies and many free floating sharing companies. + References to the OPERATORS. Multiple OPERATORS in case a ContinuousLeg can be operated by more than one operator, especially in the ALTERNATIVE MODE OF OPERATION where there can be dozens of taxi companies and many free-floating sharing companies. - Descriptive text for a route, e.g. "Airport via City Centre" + Descriptive text for a route, e.g., "Airport via City Centre". - Via points of the service that may help identify the vehicle to the public (In Transmodel modeled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia; it will also most probably be detailed as a VIA and associated DESTINATION DISPLAY in the ROUTE description). + Via points of the service that may help identify the vehicle to the public (In Transmodel modelled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia; it will also most probably be detailed as a VIA and associated DESTINATION DISPLAY in the ROUTE description). - This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g. dragLift) or the LINE is only made available to certain passenger groups (e.g. school buses, hotel shuttles). + This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g., dragLift) or the LINE is only made available to certain passenger groups (e.g., school buses, hotel shuttles). @@ -205,7 +205,7 @@ - Descriptive text for a route, e.g. "Airport via City Centre" + Descriptive text for a route, e.g., "Airport via City Centre". @@ -280,7 +280,7 @@ - A trip location represents the current logical position of a journey service. It can be used similarly to a place e.g. for starting a new trip request from within this service. A trip location does not(!) describe the relative position of a traveller within a vehicle, e.g. the seat. + A trip location represents the current logical position of a journey service. It can be used similarly to a place e.g., for starting a new trip request from within this service. A trip location does not(!) describe the relative position of a traveller within a vehicle, e.g., the seat. @@ -293,7 +293,7 @@ - The window of opportunity that the traveller has to perform this leg of the journey (e.g. a bridge is only open during a given interval). + The window of opportunity that the traveller has to perform this leg of the journey (e.g., a bridge is only open during a given interval). @@ -376,12 +376,12 @@ - Arrival times of the service at this stop ( group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME). + Arrival times of the service at this stop (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME). - Departure times of the service at this stop ( group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME). + Departure times of the service at this stop (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME). @@ -435,7 +435,7 @@ - The Capacity structure also will probably rarely be used and parsed. When used, then it mainly show elements that are important for accessibility. + The Capacity structure also will probably rarely be used and parsed. When used, then it mainly shows elements that are important for accessibility. @@ -448,7 +448,7 @@ - parameters which describe the current status of a DATED VEHICLE JOURNEY + parameters which describe the status of a DATED VEHICLE JOURNEY @@ -586,7 +586,7 @@ - Extra time needed before reaching/after leaving this location (an example of a TRIP ACCESS CONSTRAINT. In Transmodel it is modeled more extensively and could relate to ACCESS MODE e.g. walk max. 5 minutes, but cycle 10 minutes). + Extra time needed before reaching/after leaving this location (an example of a TRIP ACCESS CONSTRAINT. In Transmodel it is modelled more extensively and could relate to ACCESS MODE e.g., walk max. 5 minutes, but cycle 10 minutes). @@ -626,7 +626,7 @@ - Cancelled and delayed SERVICE JOURNEYs are still returned, but an additional explanatory textual information is provide to decribe their current real-time status. + Cancelled and delayed SERVICE JOURNEYs are still returned, but an additional explanatory textual information is provided to describe their current real-time status. @@ -644,7 +644,7 @@ - The number of trip results that the user wants to see at least (TRIP REQUEST POLICY.maximumNumberofJourneys). Be aware that some implementatins will deliver one of the TripResults before the indicated departure time. This means one always has to check the results against the parameters before using them. + The number of trip results that the user wants to see at least (TRIP REQUEST POLICY.maximumNumberofJourneys). Be aware that some implementations will deliver one of the TripResults before the indicated departure time. This means one always must check the results against the parameters before using them. @@ -661,7 +661,7 @@ - Whether the trip calculation should find a solution that starts immediately (e.g. because the user is already on the way) instead of finding the latest possible start opportunity. Default is FALSE. + Whether the trip calculation should find a solution that starts immediately (e.g., because the user is already on the way) instead of finding the latest possible start opportunity. Default is FALSE. @@ -703,7 +703,7 @@ - The user is not able to walk up/down stairs. + The user is not able to walk up/downstairs. @@ -775,7 +775,7 @@ - Which accessibility features and other accessibility-related information to retrieve (e.g. guidance text for the visually impaired). + Which accessibility features and other accessibility-related information to retrieve (e.g., guidance text for the visually impaired). @@ -785,7 +785,7 @@ - Wheter the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true + Whether the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true. @@ -836,7 +836,7 @@ - A geographical view of a Transmodel LEG TRACK together with duration and length that can be used for representing the leg on a map. The points may be STOP PLACE, SCHEDULED STOP POINT, coordinates or ADDRESSes. Specialisation of SECTION. + A geographical view of a Transmodel LEG TRACK together with duration and length that can be used for representing the leg on a map. The points may be STOP PLACE, SCHEDULED STOP POINT, coordinates, or ADDRESSes. Specialisation of SECTION. @@ -858,7 +858,7 @@ - An oriented correspondence from one LINK of a source layer, onto an entity in a target layer: e.g. LINK SEQUENCE. + An oriented correspondence from one LINK of a source layer, onto an entity in a target layer: e.g., LINK SEQUENCE. diff --git a/OJP/OJP_Lines.xsd b/OJP/OJP_Lines.xsd index 98e368f8..3d5cd6de 100644 --- a/OJP/OJP_Lines.xsd +++ b/OJP/OJP_Lines.xsd @@ -46,12 +46,12 @@ - The LINE's route geometry. A line can have multiple ROUTEs and each has its own geometry. The first should be the "main" geometry. + The LINE's route geometry. A line can have multiple ROUTEs, and each has its own geometry. The first should be the "main" geometry. - The LINE's main area. Used for MOBILITY SERVICES that cover one or more areas. The interconnection between the areas is not calculated (e.g. exclusion zones can't be modelled). Don't mix RouteGeometry and AreaGeometry in a response. + The LINE's main area. Used for MOBILITY SERVICES that cover one or more areas. The interconnection between the areas is not calculated (e.g., exclusion zones can't be modelled). Don't mix RouteGeometry and AreaGeometry in a response. diff --git a/OJP/OJP_Locations.xsd b/OJP/OJP_Locations.xsd index cb5e6114..1fec589a 100644 --- a/OJP/OJP_Locations.xsd +++ b/OJP/OJP_Locations.xsd @@ -22,7 +22,7 @@ - LOCATION / PLACE for further refinement. If a Place in a previous response was marked as not "complete" it can be refined by putting it here. If Places are organised hierarchically it may be reasonable to identify the Place in a top-down approach with several steps of refining a Place on each level of hierarchy. Following this approach an initial request retrieves a first list of top-level Places (e.g. streets) which are to be refined in a subsequent request to the next level (e.g. house number intervals). The objects of the current level are presented to the user for selection. The object reference of the selected object is then sent in the next request for further refinement. + LOCATION / PLACE for further refinement. If a Place in a previous response was marked as not "complete" it can be refined by putting it here. If Places are organised hierarchically, it may be reasonable to identify the Place in a top-down approach with several steps of refining a Place on each level of hierarchy. Following this approach an initial request retrieves a first list of top-level Places (e.g., streets) which are to be refined in a subsequent request to the next level (e.g., house number intervals). The objects of the current level are presented to the user for selection. The object reference of the selected object is then sent in the next request for further refinement. @@ -74,7 +74,7 @@ - Used in distributed environments. e.g. EU-Spirit. If none is given, the location/place information request refers to all known systems (in EU-Spirit "passive servers"). If at least one is given, the location/place information request refers only to the given systems (in EU-Spirit "passive servers"). In EU-Spirit the system IDs were previously called "provider code". See https://eu-spirit.eu/ + Used in distributed environments. e.g., EU-Spirit. If none is given, the location/place information request refers to all known systems (in EU-Spirit "passive servers"). If at least one is given, the location/place information request refers only to the given systems (in EU-Spirit "passive servers"). In EU-Spirit the system IDs were previously called "provider code". See https://eu-spirit.eu/ @@ -161,7 +161,7 @@ - States whether the included location/place is complete or needs further refinement. Only complete locations/places are fully resolved and can be used in e.g. trip requests. Incomplete locations/places have to be refined entering them once again into a LocationInformationRequest. + States whether the included location/place is complete or needs further refinement. Only complete locations/places are fully resolved and can be used in e.g., trip requests. Incomplete locations/places must be refined entering them once again into a LocationInformationRequest. @@ -177,7 +177,7 @@ - Stores the system reference, where to ask for actual locations corresponding to this city name result. In order to get actual locations, a new location information request using the system ID of this result is needed. + Stores the system reference, where to ask for actual locations corresponding to this city name result. To get actual locations, a new location information request using the system ID of this result is needed. @@ -254,7 +254,7 @@ - If there are multiple sorting methods supported by the system, the client can choose one of the existing. Which methods are available needs to be known to the client and may differ from system to system. Therefore use with care. + If there are multiple sorting methods supported by the system, the client can choose one of the existing. Which methods are available needs to be known to the client and may differ from system to system. Therefore, use with care. @@ -370,7 +370,7 @@ - Maximum number of results to be returned. The service is allowed to return fewer objects if reasonable or otherwise appropriate. If the number of matching objects is expected to be large (e.g. in the case that all objects should be delivered) this parameter can be used to partition the response delivery into smaller chunks. The location information service is expected to support a response volume of at least 500 location objects within one single response. + Maximum number of results to be returned. The service is allowed to return fewer objects if reasonable or otherwise appropriate. If the number of matching objects is expected to be large (e.g., in the case that all objects should be delivered) this parameter can be used to partition the response delivery into smaller chunks. The location information service is expected to support a response volume of at least 500 location objects within one single response. @@ -418,7 +418,7 @@ - Duration needed at this exchange point to change from one service to another. If a journey planning orchestrator puts together a trip at this exchange point, it has to take care, that feeding arrival and fetching departure are at least this duration apart. + Duration needed at this exchange point to change from one service to another. If a journey planning orchestrator puts together a trip at this exchange point, it must take care, that feeding arrival and fetching departure are at least this duration apart. @@ -433,7 +433,7 @@ - The priority of the exchange point. 100 is the maximum. The priority can be used to select given ExchangePoints more often (e.g. because the station is a main hub). + The priority of the exchange point. 100 is the maximum. The priority can be used to select given ExchangePoints more often (e.g., because the station is a main hub). diff --git a/OJP/OJP_ModesSupport.xsd b/OJP/OJP_ModesSupport.xsd index 80e78bb7..c5949ece 100644 --- a/OJP/OJP_ModesSupport.xsd +++ b/OJP/OJP_ModesSupport.xsd @@ -31,7 +31,7 @@ - Other driver without commercial interest is driving. Typical case of being picked up or dropped off at a stop e.g. by a friend, relative. If the offer is advertised or commercial, then pooling from ALTERNATIVE MODE OF OPERATION should be chosen. + Other driver without commercial interest is driving. Typical case of being picked up or dropped off at a stop e.g., by a friend, relative. If the offer is advertised or commercial, then pooling from ALTERNATIVE MODE OF OPERATION should be chosen. @@ -96,7 +96,7 @@ - General pooling ALTERNATIVE MODE OF OPERATION. Only use this enum, when no specialsation applies. In some cases where the pooling is very "scheduled" use the pooling in ConventionalModeOfOperation. + General pooling ALTERNATIVE MODE OF OPERATION. Only use this enum when no specialsation applies. In some cases, where the pooling is very "scheduled" use the pooling in ConventionalModeOfOperation. @@ -111,7 +111,7 @@ - ALTERNATIVE MODE OF OPERATION. A pooling that is dynamic, usually local and not long-term planned. + ALTERNATIVE MODE OF OPERATION. A pooling that is dynamic, usually local, and not long-term planned. @@ -121,7 +121,7 @@ - ALTERNATIVE MODE OF OPERATION. A pooling to go to workplaces and related things. Usually in a regular interval with the same people. + ALTERNATIVE MODE OF OPERATION. A pooling to go to workplaces and related things. Usually, in a regular interval with the same people. @@ -136,7 +136,7 @@ - ALTERNATIVE MODE OF OPERATION demand responsive is used, when there are no SCHEDULED STOP POINTs involved and the timetable component is weak. Otherwise use the demandResponsive in ConventionalModeOfOperation. + ALTERNATIVE MODE OF OPERATION demand responsive is used when there is no SCHEDULED STOP POINTs involved and the timetable component is weak. Otherwise use the demandResponsive in ConventionalModeOfOperation. @@ -161,7 +161,7 @@ - Only use this value, when no other applies. + Only use this value when no other applies. @@ -176,7 +176,7 @@ - Combinations of MODE and MODE OPERATION for ACCESS LEG. If no MODE OF OPERATION is given, then all can be used. Usually the result will be the own vehicle. + Combinations of MODE and MODE OPERATION for ACCESS LEG. If no MODE OF OPERATION is given, then all can be used. Usually, the result will be the own vehicle. @@ -216,7 +216,7 @@ - Types of MODES OF OPERATION are scheduled, classic and also flexible. From NeTEx. + Types of MODES OF OPERATION are scheduled, classic and flexible. From NeTEx. @@ -226,7 +226,7 @@ - Demand responsive services. General term, when nothing else is known. Requires SCHEDULED STOP POINTs. The more taxi-like a demand responsive service becomes the more probable it is better to use ALTERNATIVE MODE OF OPERATION. + Demand responsive services. General term when nothing else is known. Requires SCHEDULED STOP POINTs. The more taxi-like a demand responsive service becomes the more probable it is better to use ALTERNATIVE MODE OF OPERATION. @@ -236,7 +236,7 @@ - Specialisation of demand responsive MODE OF OPERATION. The service is based on AREAs, but still SCHEDULED STOP POINTs are used. Sometimes the characteristics of a given demand responsive service makes it mor of an ALTERNATIVE MODE OF OPERATION (e.g. pure area service). A conventional mode of operation is more indicated, when there are a limited list of stops within the area. + Specialisation of demand responsive MODE OF OPERATION. The service is based on AREAs, but still SCHEDULED STOP POINTs are used. Sometimes the characteristics of a given demand responsive service makes it mor of an ALTERNATIVE MODE OF OPERATION (e.g., pure area service). A conventional mode of operation is more indicated, when there is a limited list of stops within the area. @@ -246,7 +246,7 @@ - In some cases pooling is not an ALTERNATIVE MODE OF OPERATION, but is better served with a TimedLeg. Then this MODE OF OPERATION is to be used. + In some cases, pooling is not an ALTERNATIVE MODE OF OPERATION, but is better served with a TimedLeg. Then this MODE OF OPERATION is to be used. @@ -286,17 +286,17 @@ - Indicates that the transfer is done by taxi. This type should be avoided and the taxi leg should be modeled as a ContinuousLeg. + Indicates that the transfer is done by taxi. This type should be avoided and the taxi leg should be modelled as a ContinuousLeg. - Indicates that the connection to the next leg is specially monitored and usually kept (depending on agreements between the operators). Usually is used in combination with walk. + Indicates that the connection to the next leg is specially monitored and usually kept (depending on agreements between the operators). Usually, it is used in combination with walk. - The connection is guaranteed. This doesn't apply very often, but e.g. a bus has to bring people from the last train to a different destination. Then it will not depart, before the train has arrived and the passengers have changed. In some cases guaranteedConnection might be use with less strictness. + The connection is guaranteed. This doesn't apply very often, but e.g., a bus has to bring people from the last train to a different destination. Then it will not depart before the train has arrived and the passengers have changed. In some cases, guaranteedConnection might be use with less strictness. @@ -321,12 +321,12 @@ - This does not model the car ride. But parking the car and getting to the stop may take way longer e.g. in a big parking garage. This is a special type of checkIn or checkOut. + This does not model the car ride. But parking the car and getting to the stop may take way longer e.g., in a big parking garage. This is a special type of checkIn or checkOut. - In the transfer leg additional time may be needed to get or stow a bike (e.g. because the BIKE PARKING is at a special place). this can be seen as a special type of checkIn or checkOut. + In the transfer leg additional time may be needed to get or stow a bike (e.g., because the BIKE PARKING is at a special place). this can be seen as a special type of checkIn or checkOut. @@ -341,7 +341,7 @@ - Only to be used, when no other type applies. + Only to be used when no other type applies. @@ -363,7 +363,7 @@ - Only to be used, when no other type applies. + Only to be used when no other type applies. @@ -401,7 +401,7 @@ - Categorisation of a (conventional) PUBLIC TRANSPORT MODE. We use the SIRI 2.1 element which allows for many values in the enumeration. In OJP we don't use the following enumeration values: "pti1_xxx", "xxxServices" when a value without the "Service" exists for the same MODE, "allServicesExcept", "selfDrive", "taxi". Also in cases where only a "xxxService" exists in the enumeration, it should be avoided. "other" or "unknown" should only be used, if no other value applies. + Categorisation of a (conventional) PUBLIC TRANSPORT MODE. We use the SIRI 2.1 element which allows for many values in the enumeration. In OJP we don't use the following enumeration values: "pti1_xxx", "xxxServices" when a value without the "Service" exists for the same MODE, "allServicesExcept", "selfDrive", "taxi". Also, in cases where only a "xxxService" exists in the enumeration, it should be avoided. "other" or "unknown" should only be used if no other value applies. @@ -422,7 +422,7 @@ - List of PT Transport modes to include/exclude. We use the SIRI 2.1 element which allows for many values in the enumeration. In OJP we don't use the following enumeration values: "pti1_xxx", "xxxServices" when a value without the "Service" exists for the same MODE, "allServicesExcept", "selfDrive", "taxi". Also in cases where only a "xxxService" exists in the enumeration, it should be avoided. "other" or "unknown" should only be used, if no other value applies. + List of PT Transport modes to include/exclude. We use the SIRI 2.1 element which allows for many values in the enumeration. In OJP we don't use the following enumeration values: "pti1_xxx", "xxxServices" when a value without the "Service" exists for the same MODE, "allServicesExcept", "selfDrive", "taxi". Also, in cases where only a "xxxService" exists in the enumeration, it should be avoided. "other" or "unknown" should only be used if no other value applies. @@ -445,7 +445,7 @@ - List of PT Transport modes to include/exclude. We use the SIRI 2.1 element which allows for many values in the enumeration. In OJP we don't use the following enumeration values: "pti1_xxx", "xxxServices" when a value without the "Service" exists for the same MODE, "allServicesExcept", "selfDrive", "taxi". Also in cases where only a "xxxService" exists in the enumeration, it should be avoided. "other" or "unknown" should only be used, if no other value applies. + List of PT Transport modes to include/exclude. We use the SIRI 2.1 element which allows for many values in the enumeration. In OJP we don't use the following enumeration values: "pti1_xxx", "xxxServices" when a value without the "Service" exists for the same MODE, "allServicesExcept", "selfDrive", "taxi". Also, in cases where only a "xxxService" exists in the enumeration, it should be avoided. "other" or "unknown" should only be used if no other value applies. @@ -473,7 +473,7 @@ - Combinations of MODE and MODE OF OPERATION that should be covered as monomodal trips (or for the ACCESS LEGs). If no MODE OF OPERATION is added usually "own" is assumed. But the trip planner may add other relevant results (e.g. sharing, if sensible trips are possible). + Combinations of MODE and MODE OF OPERATION that should be covered as monomodal trips (or for the ACCESS LEGs). If no MODE OF OPERATION is added usually "own" is assumed. But the trip planner may add other relevant results (e.g., sharing, if sensible trips are possible). diff --git a/OJP/OJP_PlaceSupport.xsd b/OJP/OJP_PlaceSupport.xsd index 3827780a..a7392c49 100644 --- a/OJP/OJP_PlaceSupport.xsd +++ b/OJP/OJP_PlaceSupport.xsd @@ -36,7 +36,7 @@ - Name of the bay where to board/alight from the vehicle. As to the latest realtime status. + Name of the bay where to board/alight from the vehicle. As to the latest real-time status. @@ -180,7 +180,7 @@ - [TMv6] A type of PLACE providing the topographical context when searching for or presenting travel information, for example as the origin or destination of a trip. It may be of any size (e.g. County,City, Town, Village) and of different specificity (e.g. Greater London, London, West End, Westminster, St James's). + [TMv6] A type of PLACE providing the topographical context when searching for or presenting travel information, for example as the origin or destination of a trip. It may be of any size (e.g., County,City, Town, Village) and of different specificity (e.g., Greater London, London, West End, Westminster, St James's). @@ -205,7 +205,7 @@ - Used in distributed environments (e.g. EU-Spirit). If set, this topographic place resides within the given system (in EU-Spirit "passive server"). This system can be queried for actual places within this topographic place. This is used in an distributed environment for a two-steps place identification. In EU-Spirit the system IDs were previously called "provider code". See https://eu-spirit.eu/ + Used in distributed environments (e.g., EU-Spirit). If set, this topographic place resides within the given system (in EU-Spirit "passive server"). This system can be queried for actual places within this topographic place. This is used in a distributed environment for a two-steps place identification. In EU-Spirit the system IDs were previously called "provider code". See https://eu-spirit.eu/ @@ -270,7 +270,7 @@ - Additional information for this POI (e.g. information on available parking slots, charging infrastructure, sharing vehicles). + Additional information for this POI (e.g., information on available parking slots, charging infrastructure, sharing vehicles). @@ -499,12 +499,12 @@ - SITUATION reference. Mostly used for STOP PLACE, SCHEDULED STOP POINT (StopPoint). However, in future a situation reference may occur on many geographic elements (e.g. roads) as well. + SITUATION reference. Mostly used for STOP PLACE, SCHEDULED STOP POINT (StopPoint). However, in future a situation reference may occur on many geographic elements (e.g., roads) as well. - Attributes associated with this place. This is used, e.g., for details, OSM attributes oder key/value descriptions. Most of them will be implementation dependend (except OSM). From Transmodel, TYPE OF POINT might be a possible attribute. + Attributes associated with this place. This is used, e.g., for details, OSM attributes or key/value descriptions. Most of them will be implementation dependent (except OSM). From Transmodel, TYPE OF POINT might be an attribute. @@ -546,7 +546,7 @@ - Used in distributed environments. e.g. EU-Spirit. If none is given, the place information request refers to all known systems (in EU-Spirit "passive servers"). If at least one is given, the place information request refers only to the given systems (in EU-Spirit "passive servers"). In EU-Spirit the system IDs were previously called "provider code". See https://eu-spirit.eu/ + Used in distributed environments. e.g., EU-Spirit. If none is given, the place information request refers to all known systems (in EU-Spirit "passive servers"). If at least one is given, the place information request refers only to the given systems (in EU-Spirit "passive servers"). In EU-Spirit the system IDs were previously called "provider code". See https://eu-spirit.eu/ diff --git a/OJP/OJP_Requests.xsd b/OJP/OJP_Requests.xsd index 651757be..d54ecece 100644 --- a/OJP/OJP_Requests.xsd +++ b/OJP/OJP_Requests.xsd @@ -84,7 +84,7 @@ By means of abstraction these functions are assembled within one single service - Distributed journey planning requires several journey planning systems planning parts of the whole trip which shall be assembled. Each of the planners will therefore get a sub-query to plan: the first planner from the origin of the trip to its system boundaries, the next planner has to find trips from these boundaries to its boundaries with the next systems. This process will be continued until the final system where the destination of the user’s trip is located. + Distributed journey planning requires several journey planning systems planning parts of the whole trip which shall be assembled. Each of the planners will therefore get a sub-query to plan: the first planner from the origin of the trip to its system boundaries, the next planner must find trips from these boundaries to its boundaries with the next systems. This process will be continued until the final system where the destination of the user’s trip is located. The boundary points where the trip calculation is handed over to the next journey planning system are called exchange points. If they are not known in advance the exchange points can be looked up from a server by using the exchange points service. This service implements the model PI QR Location Request from TM 6. @@ -100,7 +100,7 @@ The boundary points where the trip calculation is handed over to the next journe - Distributed journey planning requires several journey planning systems planning parts of the whole trip which shall be assembled. Each of the planners will therefore get a sub-query to plan: the first planner from the origin of the trip to its system boundaries, the next planner has to find trips from these boundaries to its boundaries with the next systems. This process will be continued until the final system where the destination of the user’s trip is located. + Distributed journey planning requires several journey planning systems planning parts of the whole trip which shall be assembled. Each of the planners will therefore get a sub-query to plan: the first planner from the origin of the trip to its system boundaries, the next planner must find trips from these boundaries to its boundaries with the next systems. This process will be continued until the final system where the destination of the user’s trip is located. The boundary points where the trip calculation is handed over to the next journey planning system are called exchange points. If they are not known in advance the exchange points can be looked up from a server by using the exchange points service. This service implements the model PI QR Location Request from TM 6. @@ -156,8 +156,8 @@ The boundary points where the trip calculation is handed over to the next journe - This service provides information on a single leg (service pattern, real-time status, vehicle facilities etc.). The service always provides information about a VEHICLE or a SERVICE JOURNEY. It doesn't provide directly information about a trip. When the response changes the conditions in a way that invalidates the trip (connection no longer possible, delays, cancellation) then a new TripRequest for the reminder of the trip is necessary for a replanning of the trip. -The service also provides information about formation, occupancy and capacity. The full SIRI elements are used. Therefore a lot of things can be expressed. Some that go beyond what usually may be required. However, if accessibility is fully to be considered (with stop-vehicle interaction), then SIRI must be used in full. The relevant SIRI documentation should be considered. This service implements PI QR Service Journey Request and PI QR Single Journey Request from TM 6. + This service provides information on a single leg (service pattern, real-time status, vehicle facilities etc.). The service always provides information about a VEHICLE or a SERVICE JOURNEY. It doesn't directly provide information about a trip. When the response changes the conditions in a way that invalidates the trip (connection no longer possible, delays, cancellation) then a new TripRequest for the reminder of the trip is necessary for a replanning of the trip. +The service also provides information about formation, occupancy, and capacity. The full SIRI elements are used. Therefore, a lot of things can be expressed. Some that go beyond what usually may be required. However, if accessibility is fully to be considered (with stop-vehicle interaction), then SIRI must be used in full. The relevant SIRI documentation should be considered. This service implements PI QR Service Journey Request and PI QR Single Journey Request from TM 6. @@ -172,8 +172,8 @@ The service also provides information about formation, occupancy and capacity. T - This service provides information on a single leg (service pattern, real-time status, vehicle facilities etc.). The service always provides information about a VEHICLE or a SERVICE JOURNEY. It doesn't provide directly information about a trip. When the response changes the conditions in a way that invalidates the trip (connection no longer possible, delays, cancellation) then a new TripRequest for the reminder of the trip is necessary for a replanning of the trip. -The service also provides information about formation, occupancy and capacity. The full SIRI elements are used. Therefore a lot of things can be expressed. Some that go beyond what usually may be required. However, if accessibility is fully to be considered (with stop-vehicle interaction), then SIRI must be used in full. The relevant SIRI documentation should be considered. This service implements PI QR Service Journey Request and PI QR Single Journey Request from TM 6. + This service provides information on a single leg (service pattern, real-time status, vehicle facilities etc.). The service always provides information about a VEHICLE or a SERVICE JOURNEY. It doesn't directly provide information about a trip. When the response changes the conditions in a way that invalidates the trip (connection no longer possible, delays, cancellation) then a new TripRequest for the reminder of the trip is necessary for a replanning of the trip. +The service also provides information about formation, occupancy, and capacity. The full SIRI elements are used. Therefore, a lot of things can be expressed. Some that go beyond what usually may be required. However, if accessibility is fully to be considered (with stop-vehicle interaction), then SIRI must be used in full. The relevant SIRI documentation should be considered. This service implements PI QR Service Journey Request and PI QR Single Journey Request from TM 6. @@ -298,8 +298,8 @@ The service also provides information about formation, occupancy and capacity. T The trip refinement service retrieves additional or updated information (e.g., real-time data) about a given, previously retrieved trip. It does not depend on the assumption that the trip has been retrieved from the same server; it may, in fact, even stem from another source than a OJP system. -An example scenario may involve a trip retrieved from a system A and one wishes to refine the trip with real time information from another system B. As it cannot be ascertained that both systems use identical objcet IDs, this is signalled by setting ExternalObjectRefs to true. -System B, being confronted with external IDs, must try to recognise the relevant objects in another way and retrieve them in its own database. In the response it will use its own object IDs. In order to maintain a consistent mapping, it is imperative that system B reflects the structure of the refine request precisely in its response (principle of structure maintenance). +An example scenario may involve a trip retrieved from a system A and one wishes to refine the trip with real time information from another system B. As it cannot be ascertained that both systems use identical object IDs, this is signalled by setting ExternalObjectRefs to true. +System B, being confronted with external IDs, must try to recognise the relevant objects in another way and retrieve them in its own database. In the response it will use its own object IDs. To maintain a consistent mapping, it is imperative that system B reflects the structure of the refine request precisely in its response (principle of structure maintenance). @@ -315,8 +315,8 @@ System B, being confronted with external IDs, must try to recognise the relevant The trip refinement service retrieves additional or updated information (e.g., real-time data) about a given, previously retrieved trip. It does not depend on the assumption that the trip has been retrieved from the same server; it may, in fact, even stem from another source than a OJP system. -An example scenario may involve a trip retrieved from a system A and one wishes to refine the trip with real time information from another system B. As it cannot be ascertained that both systems use identical objcet IDs, this is signalled by setting ExternalObjectRefs to true. -System B, being confronted with external IDs, must try to recognise the relevant objects in another way and retrieve them in its own database. In the response it will use its own object IDs. In order to maintain a consistent mapping, it is imperative that system B reflects the structure of the refine request precisely in its response (principle of structure maintenance). +An example scenario may involve a trip retrieved from a system A and one wishes to refine the trip with real time information from another system B. As it cannot be ascertained that both systems use identical object IDs, this is signalled by setting ExternalObjectRefs to true. +System B, being confronted with external IDs, must try to recognise the relevant objects in another way and retrieve them in its own database. In the response it will use its own object IDs. To maintain a consistent mapping, it is imperative that system B reflects the structure of the refine request precisely in its response (principle of structure maintenance). diff --git a/OJP/OJP_StopEvents.xsd b/OJP/OJP_StopEvents.xsd index 31ef8a16..8319eb31 100644 --- a/OJP/OJP_StopEvents.xsd +++ b/OJP/OJP_StopEvents.xsd @@ -91,7 +91,7 @@ Indicates for which parts of the hierarchy of the StopPlace(s) stop events should be provided (if known by the server). "local" (default) is the local server setting. "no" will include no hierarchy and only provide the given StopPlace / StopPoint. "down" will include all lower StopPoints/StopPlaces in the hierarchy, if - such a hierarchy exists. "all" does include all StopPoints/StopPlaces for the meta station, if it is known. How + such a hierarchy exists. "all" does include all StopPoints/StopPlaces for the meta station if it is known. How to use this: if you indicate the reference to a train station and the parameter is set to "down", the departures/ arrivals at the associated bus stations will show as well. If you have the ScheduledStopPoint of platform B of the local bus and it is associated with 3 other stations, you will get all these arrivals/departures as well, @@ -137,7 +137,7 @@ - Wheter the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true + Whether the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true @@ -146,10 +146,10 @@ be provided (if known by the server). "local" (default) is the local server setting. "no" will include no hierarchy and only provide the given StopPlace / StopPoint. "down" will include all lower StopPoints/ StopPlaces in the hierarchy, if such a hierarchy exists. "all" does include all StopPoints/StopPlaces - for the meta station, if it is known. How to use this: if you indicate the reference to a train station + for the meta station if it is known. How to use this: if you indicate the reference to a train station and the parameter is set to "down", the departures/arrivals at the associated bus stations will show as well. If you have the ScheduledStopPoint of platform B of the local bus and it is associated with 3 other - stations, you will get all these arrivals/departures as well, if the parameter is set to "all". + stations, you will get all these arrivals/departures as well if the parameter is set to "all". @@ -254,17 +254,17 @@ - [same as CALL in SIRI] the meeting of a VEHICLE JOURNEY with a specific SCHEDULED STOP POINT . + [same as CALL in SIRI] the meeting of a VEHICLE JOURNEY with a specific SCHEDULED STOP POINT. - Distance from request LOCATION / PLACE (e.g. address) to this stop in metres. + Distance from request LOCATION / PLACE (e.g., address) to this stop in metres. - Walking duration from request LOCATION / PLACE (e.g. address) to this stop. All user options taken into account (e.g. walk speed). + Walking duration from request LOCATION / PLACE (e.g., address) to this stop. All user options considered (e.g., walk speed). @@ -279,7 +279,7 @@ - No departure/arrival could be found within the requested period of time that meets the given restrictions. + No departure/arrival could be found within the requested period that meets the given restrictions. @@ -304,7 +304,7 @@ - There is no realtime or forecast data available for this departure/arrival event. + There is no real-time or forecast data available for this departure/arrival event. diff --git a/OJP/OJP_TripInfo.xsd b/OJP/OJP_TripInfo.xsd index a2c77bec..614e06a5 100644 --- a/OJP/OJP_TripInfo.xsd +++ b/OJP/OJP_TripInfo.xsd @@ -133,7 +133,7 @@ - TripInfo result structure containing the current status of a trip. + TripInfo result structure containing the status of a trip. diff --git a/OJP/OJP_Trips.xsd b/OJP/OJP_Trips.xsd index 8c382dc1..1d6ae8fd 100644 --- a/OJP/OJP_Trips.xsd +++ b/OJP/OJP_Trips.xsd @@ -72,7 +72,7 @@ - Data to be included/excluded from search, e.g. modes, operators (Transmodel: TRIP REQUEST FILTER). + Data to be included/excluded from search, e.g., modes, operators (Transmodel: TRIP REQUEST FILTER). @@ -111,7 +111,7 @@ - The MotorisedMainTravelMode defines whether the trip planner works in PT mode (or pure IT mode) or includes carTransportRail and the like. If set to true (e.g. because one travels by car, truck or motorcycle), then carTransportRail, ferry are used together with roads. + The MotorisedMainTravelMode defines whether the trip planner works in PT mode (or pure IT mode) or includes carTransportRail and the like. If set to true (e.g., because one travels by car, truck or motorcycle), then carTransportRail, ferry are used together with roads. @@ -147,18 +147,18 @@ - Additional time added to all transfers (also to transfers between individual to public transport, not modeled in Transmodel). + Additional time added to all transfers (also to transfers between individual to public transport, not modelled in Transmodel). - Users hiking profile. The main element to control general walking behaviour is WalkSpeed (together with accessibility constraints). Note: possible explanations in German can be found here: https://akademie.alpinewelten.com/bergwandern/klassifizierung-von-wanderwegen + Users hiking profile. The main element to control general walking behaviour is WalkSpeed (together with accessibility constraints). Note: explanations in German can be found here: https://akademie.alpinewelten.com/bergwandern/klassifizierung-von-wanderwegen - Regular hiking/walking in valleys and plains and easy mountain trails e.g. yellow hiking signs in Switzerland or blue in Germany. + Regular hiking/walking in valleys and plains and easy mountain trails e.g., yellow hiking signs in Switzerland or blue in Germany. @@ -230,7 +230,7 @@ - The types of algorithm that can be used for planning a journey (fastest, least walking, etc.). Only one method can be used. Each one really is a whole set of a policy, which is defined below. E.g. fastest also includes least transfers as a second criteria, some modes are excluded usually by default. Implementations might differ (slightly). Also some strategies might not be implemented. The most important strategies are marked. + The types of algorithms that can be used for planning a journey (fastest, least walking, etc.). Only one method can be used. Each one really is a whole set of a policy, which is defined below. E.g., fastest also includes least transfers as a second criteria, some modes are excluded usually by default. Implementations might differ (slightly). Also, some strategies might not be implemented. The most important strategies are marked. @@ -250,7 +250,7 @@ - Cheapest fare, taking into account the applicable reductions. Might not base on actual cost, but an estimation. Expected strategy. + Cheapest fare, considering the applicable reductions. Might not be based on actual cost, but an estimation. Expected strategy. @@ -260,17 +260,17 @@ - Earliest possible arrival time respecting the time constraints. (forward search) + Earliest possible arrival time respecting the time constraints (forward search). - Latest departure time for a given arrival time. (backward search) + Latest departure time for a given arrival time (backward search). - Combines earliestArrival and latestDeparture, allowing to compress the departure time. (forward-backward-forward search) + Combines earliestArrival and latestDeparture, allowing to compress the departure time (forward-backward-forward search). @@ -432,14 +432,14 @@ - When the result is an alternative option from IncludeAlternativeOptions, then the flag should be set to true. If it is an alternative option this means that the server decided to add this result for its own reasons: e.g. to push a certain trip leg, because it believes that it might better suit at least some possible customers. Such options are not an optimal fit to the criteria that were in the request. The client may therefore disregard such results depending on the use case. + When the result is an alternative option from IncludeAlternativeOptions, then the flag should be set to true. If it is an alternative option this means that the server decided to add this result for its own reasons: e.g., to push a certain trip leg, because it believes that it might better suit at least some possible customers. Such options are not an optimal fit to the criteria that were in the request. The client may therefore disregard such results depending on the use case. - Structure for trip overview information (only implementation related and therefore not modeled in Transmodel). + Structure for trip overview information (only implementation related and therefore not modelled in Transmodel). @@ -459,17 +459,17 @@ - Overall duration of the trip (TRIP attribute, not detailed in Transmodel, available from constituing LEGs). + Overall duration of the trip (TRIP attribute, not detailed in Transmodel, available from constituting LEGs). - Departure time at origin (TRIP attribute, not detailed in Transmodel, available from constituing LEGs). + Departure time at origin (TRIP attribute, not detailed in Transmodel, available from constituting LEGs). - Arrival time at destination (TRIP attribute, not detailed in Transmodel, available from constituing LEGs). + Arrival time at destination (TRIP attribute, not detailed in Transmodel, available from constituting LEGs). @@ -479,7 +479,7 @@ - Trip distance (TRIP attribute, not detailed in Transmodel, available from constituing LEGs). + Trip distance (TRIP attribute, not detailed in Transmodel, available from constituting LEGs). @@ -514,17 +514,17 @@ - Overall duration of the trip (TRIP attribute, not detailed in Transmodel, available from constituing LEGs). + Overall duration of the trip (TRIP attribute, not detailed in Transmodel, available from constituting LEGs). - Departure time at origin (TRIP attribute, not detailed in Transmodel, available from constituing LEGs). + Departure time at origin (TRIP attribute, not detailed in Transmodel, available from constituting LEGs). - Arrival time at destination (TRIP attribute, not detailed in Transmodel, available from constituing LEGs). + Arrival time at destination (TRIP attribute, not detailed in Transmodel, available from constituting LEGs). @@ -534,12 +534,12 @@ - Trip distance (TRIP attribute, not detailed in Transmodel, available from constituing LEGs). + Trip distance (TRIP attribute, not detailed in Transmodel, available from constituting LEGs). - Legs of the trip (Transmodel: LEG or MONITORED LEG). Note: There is always a TransferLeg between two TimedLegs. There can be a TransferLeg between two ContinuousLegs (e.g. because some special time consuming action is necessary like a car hire). There can be a TransferLeg between a ContinuousLeg and a TimedLeg for the same reason. There aren't two consecutive TransferLegs. + Legs of the trip (Transmodel: LEG or MONITORED LEG). Note: There is always a TransferLeg between two TimedLegs. There can be a TransferLeg between two ContinuousLegs (e.g., because some special time consuming action is necessary like a car hire). There can be a TransferLeg between a ContinuousLeg and a TimedLeg for the same reason. There aren't two consecutive TransferLegs. @@ -565,7 +565,7 @@ - A single stage of a TRIP that is made without change of MODE or service (ie: between each interchange). Implements LEG from TM 6.2. + A single stage of a TRIP that is made without change of MODE or service (e.g., between each interchange). Implements LEG from TM 6.2. @@ -580,7 +580,7 @@ - The duration of the LEG (e.g. from Transmodel PT RIDE LEG.Duration). + The duration of the LEG (e.g., from Transmodel PT RIDE LEG.Duration). @@ -646,7 +646,7 @@ - Services running combined with at least parts of this journey, e.g. wing trains. The contained stop sequence interval refers to the original journey. + Services running combined with at least parts of this journey, e.g., wing trains. The contained stop sequence interval refers to the original journey. @@ -771,7 +771,7 @@ - Describes the the situation at a stop or station at which the passenger boards a Leg of a trip including time-related information. + Describes the situation at a stop or station at which the passenger boards a Leg of a trip including time-related information. @@ -790,7 +790,7 @@ - Interchange identifier of the distributing line/service at its boarding. This is not a reference. This identifier is used to recognize in a distributed environment (e.g. EU-Spirit), that two systems refer to the same line (or service) while using their own internal references. In EU-Spirit this is used to decide whether an interchange is in fact a stay-seated scanario (aka "line ID"). See https://eu-spirit.eu/ + Interchange identifier of the distributing line/service at its boarding. This is not a reference. This identifier is used to recognize in a distributed environment (e.g., EU-Spirit), that two systems refer to the same line (or service) while using their own internal references. In EU-Spirit this is used to decide whether an interchange is in fact a stay-seated scanario (aka "line ID"). See https://eu-spirit.eu/ @@ -809,17 +809,17 @@ - describes the arrival situation at the leg alight stop point ( group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME) + describes the arrival situation at the leg alight stop point (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME) - describes the departure situation at this leg alight stop point (empty for last leg) ( group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME) + describes the departure situation at this leg alight stop point (empty for last leg) (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME) - Interchange identifier of the feeding line/service at its alighting. This is not a reference. This identifier is used to recognize in a distributed environment (e.g. EU-Spirit), that two systems refer to the same line (or service) while using their own internal references. In EU-Spirit this is used to decide whether an interchange is in fact a stay-seated scenario (aka "line id"). See https://eu-spirit.eu/ + Interchange identifier of the feeding line/service at its alighting. This is not a reference. This identifier is used to recognize in a distributed environment (e.g., EU-Spirit), that two systems refer to the same line (or service) while using their own internal references. In EU-Spirit this is used to decide whether an interchange is in fact a stay-seated scenario (aka "line id"). See https://eu-spirit.eu/ @@ -838,12 +838,12 @@ - describes the arrival situation a this leg board stop point (empty for first leg) ( group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME) + describes the arrival situation at this leg board stop point (empty for first leg) (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME) - describes the departure situation at this leg board stop point ( group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME) + describes the departure situation at this leg board stop point (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME) @@ -861,7 +861,7 @@ - A view of LEG TRACK including PATH JUNCTION information, PATH LINK information and PATH GUIDANCE. One or more path guidance sections that form the LEG. For a good PATH GUIDANCE a fine granularity of the sections may be needed. This may also depend on the MODE and the type of guidance required. + A view of LEG TRACK including PATH JUNCTION information, PATH LINK information and PATH GUIDANCE. One or more path guidance sections that form the LEG. For a good PATH GUIDANCE, a fine granularity of the sections may be needed. This may also depend on the MODE and the type of guidance required. @@ -873,7 +873,7 @@ - An aggregate of information that may be leaning on LEG TRACK together with duration and length that can be used for representing the leg on a map. The points may be STOP PLACE, SCHEDULED STOP POINT, coordinates or ADDRESSes. + An aggregate of information that may be leaning on LEG TRACK together with duration and length that can be used for representing the leg on a map. The points may be STOP PLACE, SCHEDULED STOP POINT, coordinates, or ADDRESSes. @@ -883,7 +883,7 @@ - Various types of guidance advice given to traveller (according to Transmodel a view of a LEG TRACK and PATH GUIDANCE). + Several types of guidance advice given to traveller (according to Transmodel a view of a LEG TRACK and PATH GUIDANCE). @@ -903,7 +903,7 @@ - Textual direction hint for better understanding, e.g. "follow signs to Hamburg" (according to Transmodel a view of a LEG TRACK and PATH GUIDANCE). + Textual direction hint for better understanding, e.g., "follow signs to Hamburg" (according to Transmodel a view of a LEG TRACK and PATH GUIDANCE). @@ -949,7 +949,7 @@ - Various types of guidance advice given to traveller. Suitable values may differ by MODE (e.g. a car driver needs different advice than a person walking for a transfer. + Several types of guidance advice given to traveller. Suitable values may differ by MODE (e.g., a car driver needs different advice than a person walking for a transfer. @@ -974,7 +974,7 @@ - When this value is used, you always have to consider the value in TurnAction as well. There must be a TurnAction present if "turn" is used. + When this value is used, you always must consider the value in TurnAction as well. There must be a TurnAction present if "turn" is used. @@ -1004,12 +1004,12 @@ - Entering a builtup area / community. + Entering a built-up area / community. - Leave the builtup area / community. + Leave the built-up area / community. @@ -1024,7 +1024,7 @@ - If there are more than 2 lanes, then TurnAction half_left,left,sharp_left may help decide. + If there are more than 2 lanes, then TurnAction half_left, left, sharp_left may help decide. @@ -1034,7 +1034,7 @@ - If there are more than 2 lanes, then TurnAction half_right,right,sharp_right may help decide + If there are more than 2 lanes, then TurnAction half_right, right, sharp_right may help decide. @@ -1114,12 +1114,12 @@ - Walk time as part of the overall interchange duration (in Transmodel might be modeled as TRANSFER.CONNECTION.DefaultDuration). + Walk time as part of the overall interchange duration (in Transmodel might be modelled as TRANSFER.CONNECTION.DefaultDuration). - Buffer time as part of the overall interchange duration. Buffer times, e.g. check in/out times, sometimes are mandatory for using certain services as e.g. airplanes, ferries or highspeed trains. + Buffer time as part of the overall interchange duration. Buffer times, e.g., check in/out times, sometimes are mandatory for using certain services as e.g., airplanes, ferries or highspeed trains. @@ -1164,7 +1164,7 @@ Can only be used when both participants recognise the same schedule version. If - + @@ -1208,7 +1208,7 @@ Can only be used when both participants recognise the same schedule version. If - Allowed values for AccessibilityFeature (for mobility and sensory impairments, assistance and important elements to pay attention to). + Allowed values for AccessibilityFeature (for mobility and sensory impairments, assistance and crucial elements to pay attention to). @@ -1245,12 +1245,12 @@ Can only be used when both participants recognise the same schedule version. If - [TMv6] a link within a PLACE of or between two PLACEs (that is STOP PLACEs, ACCESS SPACEs or QUAYs, BOARDING POSITIONs, POINTs OF INTEREST etc or PATH JUNCTIONs) that represents a step in a possible route for pedestrians, cyclists or other out-of-vehicle passengers within or between a PLACE. Here we use a reduced form of a PATH LINK containing the description of the type of accessibility on this navigation section. + [TMv6] a link within a PLACE of or between two PLACEs (that is STOP PLACEs, ACCESS SPACEs or QUAYs, BOARDING POSITIONs, POINTs OF INTEREST etc or PATH JUNCTIONs) that represents a step in a possible route for pedestrians, cyclists, or other out-of-vehicle passengers within or between a PLACE. Here we use a reduced form of a PATH LINK containing the description of the type of accessibility on this navigation section. - Whether path is up, down or level. + Whether path is up, down, or level. @@ -1312,7 +1312,7 @@ Can only be used when both participants recognise the same schedule version. If - Id of the element at this end of the PathLink (typically a PLACE, e.g. where the elevator is located). + Id of the element at this end of the PathLink (typically a PLACE, e.g., where the elevator is located). @@ -1337,7 +1337,7 @@ Can only be used when both participants recognise the same schedule version. If - Ordered series of points where the journey must pass through. If more than one via point is given all of them must be obeyed - in the correct order. The server is allowed to replace a via stop by equivalent stops (in Transmodel modeled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia). + Ordered series of points where the journey must pass through. If more than one via point is given all of them must be obeyed - in the correct order. The server is allowed to replace a via stop by equivalent stops (in Transmodel modelled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia). @@ -1390,24 +1390,24 @@ Can only be used when both participants recognise the same schedule version. If How the multiple origin/destination points should be considered. - Note: Unfortunately this element was underdefined before and this resulted in different implementations. + Note: Unfortunately, this element was underdefined before and this resulted in different implementations. Note: MultiPointType trumps the number of results. If the algorithm thinks it necessary to provide more results, it should. - If a solution for any one of multiple origin/destination points is sufficient. Some implementation will return only one origin-destination pair even for multiple results with this setting. Others will provide multiple. + If a solution for any one of multiple origin/destination points is sufficient. Some implementations will return only one origin-destination pair even for multiple results with this setting. Others will provide multiple. - A distinct solution for each of the origin points has to be found. + A distinct solution for each of the origin points must be found. - A distinct solution for each of the destination points has to be found. + A distinct solution for each of the destination points must be found. @@ -1432,7 +1432,7 @@ Can only be used when both participants recognise the same schedule version. If - The MultiPointType should be returned, because it may differ from the one asked. Many systems will support only a subset of the MultiPointTypes and it is important to know, what the result is based on. + The MultiPointType should be returned because it may differ from the one asked. Many systems will support only a subset of the MultiPointTypes and it is important to know, what the result is based on. @@ -1507,7 +1507,7 @@ Can only be used when both participants recognise the same schedule version. If - Parameters which describe the current status of a TRIP (will be added to MONITORED TRIP in Transmodel). + Parameters which describe the status of a TRIP (will be added to MONITORED TRIP in Transmodel). @@ -1574,12 +1574,12 @@ Can only be used when both participants recognise the same schedule version. If - Refers to the legs to be refined by the server. If none is given, then all legs are open for refinement (depending if the relevant system can refine them). + Refers to the legs to be refined by the server. If none is given, then all legs are open for refinement (depending on if the relevant system can refine them). - System reference to use for the refinement. If not specified the origin systems of each leg are used for the refinement. + System reference to use for the refinement. If not specified, the origin systems of each leg are used for the refinement. @@ -1708,7 +1708,7 @@ Can only be used when both participants recognise the same schedule version. If - There is no realtime information available for at least one of the services within this trip result. + There is no real-time information available for at least one of the services within this trip result. @@ -1718,7 +1718,7 @@ Can only be used when both participants recognise the same schedule version. If - The mode of individual transport specified by the user has been replaced by the system because otherwise no trip could be found. Usually this means taking a taxi instead of walking. + The mode of individual transport specified by the user has been replaced by the system because otherwise no trip could be found. Usually, this means taking a taxi instead of walking. @@ -1728,7 +1728,7 @@ Can only be used when both participants recognise the same schedule version. If - Used for warnings, when there where possible/better results that were dropped, because of the criteria were not used (e.g. private services, offer only available for seniors). + Used for warnings, when there where possible/better results that were dropped, because of the criteria were not used (e.g., private services, offer only available for seniors). @@ -1806,7 +1806,7 @@ Can only be used when both participants recognise the same schedule version. If - System reference to use for the refinement. If not specified the origin systems of each leg are used for the refinement. + System reference to use for the refinement. If not specified, the origin systems of each leg are used for the refinement. @@ -1816,7 +1816,7 @@ Can only be used when both participants recognise the same schedule version. If - Absolute time in minutes the passenger wants additionally to make the interchange. If another TransferLeg is needed (e.g. since another quay is used for the found arrival/departure) this is taken into account. If not passed, the next best arrival/departure is requested. + Absolute time in minutes the passenger wants additionally to make the interchange. If another TransferLeg is needed (e.g., since another quay is used for the found arrival/departure) this is taken into account. If not passed, the next best arrival/departure is requested. diff --git a/OJP/OJP_Utility.xsd b/OJP/OJP_Utility.xsd index f952543c..defea098 100644 --- a/OJP/OJP_Utility.xsd +++ b/OJP/OJP_Utility.xsd @@ -88,7 +88,7 @@ - Is the referenced resource meant to be embedded as a webview in a surrounding context, e.g. app or web page? If yes, the resource has to be fully responsive. Default is false. + Is the referenced resource meant to be embedded as a webview in a surrounding context, e.g., app or web page? If yes, the resource has to be fully responsive. Default is false. diff --git a/docs/generated/index.html b/docs/generated/index.html index aabfa932..7998a754 100644 --- a/docs/generated/index.html +++ b/docs/generated/index.html @@ -105,7 +105,7 @@

OJP - Open API for distributed Journey

2.6. The complex type OJPLocationInformationRequestStructure

- + @@ -125,7 +125,7 @@

OJP - Open API for distributed Journey

-

OJPLocationInformationRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

LocationInformationRequest

a

InitialInput

-1:1

+InitialLocationInput

Initial input for the location information request. This input defines what is originally looked for. Be aware that this also can contain PLACEs.

b

PlaceRef

-1:1

+PlaceRef

LOCATION / PLACE for further refinement. If a Place in a previous response was marked as not "complete" it can be refined by putting it here. If Places are organised hierarchically it may be reasonable to identify the Place in a top-down approach with several steps of refining a Place on each level of hierarchy. Following this approach an initial request retrieves a first list of top-level Places (e.g. streets) which are to be refined in a subsequent request to the next level (e.g. house number intervals). The objects of the current level are presented to the user for selection. The object reference of the selected object is then sent in the next request for further refinement.

Then, the element contains one of the following elements:

LocationInformationRequest

a

InitialInput

-1:1

+InitialLocationInput

Initial input for the location information request. This input defines what is originally looked for. Be aware that this also can contain PLACEs.

b

PlaceRef

-1:1

+PlaceRef

LOCATION / PLACE for further refinement. If a Place in a previous response was marked as not "complete" it can be refined by putting it here. If Places are organised hierarchically, it may be reasonable to identify the Place in a top-down approach with several steps of refining a Place on each level of hierarchy. Following this approach an initial request retrieves a first list of top-level Places (e.g., streets) which are to be refined in a subsequent request to the next level (e.g., house number intervals). The objects of the current level are presented to the user for selection. The object reference of the selected object is then sent in the next request for further refinement.

Restrictions

0:1

+PlaceParam

E.g. place types (stops, addresses, POIs) or specific place attributes

→‍siri:Extensions

0:1

→‍siri:Extensions

PlaceResult

0:*

+PlaceResult

The place/location objects found by the service are ordered in descending order of how well they match the input data. The first result in the list matches best.

→‍siri:Extensions

0:1

→‍siri:Extensions

2.9. The toplevel element OJPExchangePointsRequest

OJPExchangePointsRequest

+OJPExchangePointsRequest (↔ siri:AbstractFunctionalServiceRequest)

Distributed journey planning requires several journey planning systems planning parts of the whole trip which shall be assembled. Each of the planners will therefore get a sub-query to plan: the first planner from the origin of the trip to its system boundaries, the next planner has to find trips from these boundaries to its boundaries with the next systems. This process will be continued until the final system where the destination of the user’s trip is located. +

2.9. The toplevel element OJPExchangePointsRequest

OJPExchangePointsRequest

+OJPExchangePointsRequest (↔ siri:AbstractFunctionalServiceRequest)

Distributed journey planning requires several journey planning systems planning parts of the whole trip which shall be assembled. Each of the planners will therefore get a sub-query to plan: the first planner from the origin of the trip to its system boundaries, the next planner must find trips from these boundaries to its boundaries with the next systems. This process will be continued until the final system where the destination of the user’s trip is located. The boundary points where the trip calculation is handed over to the next journey planning system are called exchange points. If they are not known in advance the exchange points can be looked up from a server by using the exchange points service. This service implements the model PI QR Location Request from TM 6.

2.10. The complex type OJPExchangePointsRequestStructure

@@ -133,10 +133,10 @@

OJP - Open API for distributed Journey

-

OJPExchangePointsRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

Params

0:1

+ExchangePointsParam

E.g. location/place types (stops, addresses, POIs) or specific location/place attributes

→‍siri:Extensions

0:1

→‍siri:Extensions

2.11. The toplevel element OJPExchangePointsDelivery

OJPExchangePointsDelivery

+OJPExchangePointsDelivery (↔ siri:AbstractFunctionalServiceDelivery)

Distributed journey planning requires several journey planning systems planning parts of the whole trip which shall be assembled. Each of the planners will therefore get a sub-query to plan: the first planner from the origin of the trip to its system boundaries, the next planner has to find trips from these boundaries to its boundaries with the next systems. This process will be continued until the final system where the destination of the user’s trip is located. +

2.11. The toplevel element OJPExchangePointsDelivery

OJPExchangePointsDelivery

+OJPExchangePointsDelivery (↔ siri:AbstractFunctionalServiceDelivery)

Distributed journey planning requires several journey planning systems planning parts of the whole trip which shall be assembled. Each of the planners will therefore get a sub-query to plan: the first planner from the origin of the trip to its system boundaries, the next planner must find trips from these boundaries to its boundaries with the next systems. This process will be continued until the final system where the destination of the user’s trip is located. The boundary points where the trip calculation is handed over to the next journey planning system are called exchange points. If they are not known in advance the exchange points can be looked up from a server by using the exchange points service. This service implements the model PI QR Location Request from TM 6.

2.12. The complex type OJPExchangePointsDeliveryStructure

- @@ -165,8 +165,8 @@

OJP - Open API for distributed Journey

-

OJPExchangePointsDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

→‍OJPExchangePointsRequest

0:1

→‍OJPExchangePointsRequest

Distributed journey planning requires several journey planning systems planning parts of the whole trip which shall be assembled. Each of the planners will therefore get a sub-query to plan: the first planner from the origin of the trip to its system boundaries, the next planner has to find trips from these boundaries to its boundaries with the next systems. This process will be continued until the final system where the destination of the user’s trip is located. +

The element contains a sequence of the following elements:

→‍OJPExchangePointsRequest

0:1

→‍OJPExchangePointsRequest

Distributed journey planning requires several journey planning systems planning parts of the whole trip which shall be assembled. Each of the planners will therefore get a sub-query to plan: the first planner from the origin of the trip to its system boundaries, the next planner must find trips from these boundaries to its boundaries with the next systems. This process will be continued until the final system where the destination of the user’s trip is located. The boundary points where the trip calculation is handed over to the next journey planning system are called exchange points. If they are not known in advance the exchange points can be looked up from a server by using the exchange points service. This service implements the model PI QR Location Request from TM 6.

ServiceResponseContext

DataFrameRef

0:1

siri:DataFrameRefStructure

identifier of the set of data being used by an information system, which allows a comparison to be made with the versions of data being used by overlapping systems.

CalcTime

0:1

Calc

Calculation time.

StopEventResult

0:*

+StopEventResult

Enclosing element for stop event data.

→‍siri:Extensions

0:1

→‍siri:Extensions

2.17. The toplevel element OJPTripInfoRequest

OJPTripInfoRequest

+OJPTripInfoRequest (↔ siri:AbstractFunctionalServiceRequest)

This service provides information on a single leg (service pattern, real-time status, vehicle facilities etc.). The service always provides information about a VEHICLE or a SERVICE JOURNEY. It doesn't provide directly information about a trip. When the response changes the conditions in a way that invalidates the trip (connection no longer possible, delays, cancellation) then a new TripRequest for the reminder of the trip is necessary for a replanning of the trip. -The service also provides information about formation, occupancy and capacity. The full SIRI elements are used. Therefore a lot of things can be expressed. Some that go beyond what usually may be required. However, if accessibility is fully to be considered (with stop-vehicle interaction), then SIRI must be used in full. The relevant SIRI documentation should be considered. This service implements PI QR Service Journey Request and PI QR Single Journey Request from TM 6.

2.18. The complex type OJPTripInfoRequestStructure

+

OJPTripInfoRequestStructure

+AbstractOJPServiceRequest

2.17. The toplevel element OJPTripInfoRequest

OJPTripInfoRequest

+OJPTripInfoRequest (↔ siri:AbstractFunctionalServiceRequest)

This service provides information on a single leg (service pattern, real-time status, vehicle facilities etc.). The service always provides information about a VEHICLE or a SERVICE JOURNEY. It doesn't directly provide information about a trip. When the response changes the conditions in a way that invalidates the trip (connection no longer possible, delays, cancellation) then a new TripRequest for the reminder of the trip is necessary for a replanning of the trip. +The service also provides information about formation, occupancy, and capacity. The full SIRI elements are used. Therefore, a lot of things can be expressed. Some that go beyond what usually may be required. However, if accessibility is fully to be considered (with stop-vehicle interaction), then SIRI must be used in full. The relevant SIRI documentation should be considered. This service implements PI QR Service Journey Request and PI QR Single Journey Request from TM 6.

2.18. The complex type OJPTripInfoRequestStructure

@@ -183,11 +183,11 @@

OJP - Open API for distributed Journey

-

OJPTripInfoRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

TripInfoRequest

Params

0:1

+TripInfoParam

Request parameter.

→‍siri:Extensions

0:1

→‍siri:Extensions

2.19. The toplevel element OJPTripInfoDelivery

OJPTripInfoDelivery

+OJPTripInfoDelivery (↔ siri:AbstractFunctionalServiceDelivery)

This service provides information on a single leg (service pattern, real-time status, vehicle facilities etc.). The service always provides information about a VEHICLE or a SERVICE JOURNEY. It doesn't provide directly information about a trip. When the response changes the conditions in a way that invalidates the trip (connection no longer possible, delays, cancellation) then a new TripRequest for the reminder of the trip is necessary for a replanning of the trip. -The service also provides information about formation, occupancy and capacity. The full SIRI elements are used. Therefore a lot of things can be expressed. Some that go beyond what usually may be required. However, if accessibility is fully to be considered (with stop-vehicle interaction), then SIRI must be used in full. The relevant SIRI documentation should be considered. This service implements PI QR Service Journey Request and PI QR Single Journey Request from TM 6.

2.20. The complex type OJPTripInfoDeliveryStructure

+

OJPTripInfoDeliveryStructure

siri:AbstractServiceDeliveryStructure

2.19. The toplevel element OJPTripInfoDelivery

OJPTripInfoDelivery

+OJPTripInfoDelivery (↔ siri:AbstractFunctionalServiceDelivery)

This service provides information on a single leg (service pattern, real-time status, vehicle facilities etc.). The service always provides information about a VEHICLE or a SERVICE JOURNEY. It doesn't directly provide information about a trip. When the response changes the conditions in a way that invalidates the trip (connection no longer possible, delays, cancellation) then a new TripRequest for the reminder of the trip is necessary for a replanning of the trip. +The service also provides information about formation, occupancy, and capacity. The full SIRI elements are used. Therefore, a lot of things can be expressed. Some that go beyond what usually may be required. However, if accessibility is fully to be considered (with stop-vehicle interaction), then SIRI must be used in full. The relevant SIRI documentation should be considered. This service implements PI QR Service Journey Request and PI QR Single Journey Request from TM 6.

2.20. The complex type OJPTripInfoDeliveryStructure

- + @@ -226,7 +226,7 @@

OJP - Open API for distributed Journey

- + @@ -239,7 +239,7 @@

OJP - Open API for distributed Journey

- + @@ -262,8 +262,8 @@

OJP - Open API for distributed Journey

OJPTripInfoDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

→‍OJPTripInfoRequest

0:1

→‍OJPTripInfoRequest

This service provides information on a single leg (service pattern, real-time status, vehicle facilities etc.). The service always provides information about a VEHICLE or a SERVICE JOURNEY. It doesn't provide directly information about a trip. When the response changes the conditions in a way that invalidates the trip (connection no longer possible, delays, cancellation) then a new TripRequest for the reminder of the trip is necessary for a replanning of the trip. -The service also provides information about formation, occupancy and capacity. The full SIRI elements are used. Therefore a lot of things can be expressed. Some that go beyond what usually may be required. However, if accessibility is fully to be considered (with stop-vehicle interaction), then SIRI must be used in full. The relevant SIRI documentation should be considered. This service implements PI QR Service Journey Request and PI QR Single Journey Request from TM 6.

The element contains a sequence of the following elements:

→‍OJPTripInfoRequest

0:1

→‍OJPTripInfoRequest

This service provides information on a single leg (service pattern, real-time status, vehicle facilities etc.). The service always provides information about a VEHICLE or a SERVICE JOURNEY. It doesn't directly provide information about a trip. When the response changes the conditions in a way that invalidates the trip (connection no longer possible, delays, cancellation) then a new TripRequest for the reminder of the trip is necessary for a replanning of the trip. +The service also provides information about formation, occupancy, and capacity. The full SIRI elements are used. Therefore, a lot of things can be expressed. Some that go beyond what usually may be required. However, if accessibility is fully to be considered (with stop-vehicle interaction), then SIRI must be used in full. The relevant SIRI documentation should be considered. This service implements PI QR Service Journey Request and PI QR Single Journey Request from TM 6.

ServiceResponseContext

DataFrameRef

0:1

siri:DataFrameRefStructure

identifier of the set of data being used by an information system, which allows a comparison to be made with the versions of data being used by overlapping systems.

CalcTime

0:1

Calc

Calculation time.

ErrorCondition

0:*

+OJPError

OJP generic problem for the whole delivery.

The element contains a sequence of the following elements:

MultiPointTripRequest

Origin

1:*

+PlaceContext

Specifies the origin situation from where the user wants to start.

Destination

1:*

+PlaceContext

Specifies the destination situation where the user is heading to.

Via

0:*

+TripVia

Ordered series of points where the journey must pass through. If more than one via point is given all of them must be obeyed - in the correct order. The server is allowed to replace a via stop by equivalent stops (in Transmodel modeled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia).

Via

0:*

+TripVia

Ordered series of points where the journey must pass through. If more than one via point is given all of them must be obeyed - in the correct order. The server is allowed to replace a via stop by equivalent stops (in Transmodel modelled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia).

NotVia

0:*

+NotVia

Not-via restrictions for a TRIP, i.e. SCHEDULED STOP POINTs or STOP PLACEs that the TRIP is not allowed to pass through. If more than one not via point is given all of them must be obeyed.

NoChangeAt

0:*

+NoChangeAt

no-change-at restrictions for a TRIP, i.e. SCHEDULED STOP POINTs or STOP PLACEs at which no TRANSFER is allowed within a TRIP (in Transmodel this would be an extension to TRIP MOBILITY FILTER).

Params

0:1

+MultiPointTripParam

Options to control the search behaviour and response contents.

CalcTime

0:1

Calc

Calculation time.

ErrorCondition

0:*

+OJPError

OJP generic problem for the whole delivery.

MultiPointTripResponse

MultiPointType

0:1

MultiPointType

The MultiPointType should be returned, because it may differ from the one asked. Many systems will support only a subset of the MultiPointTypes and it is important to know, what the result is based on.

MultiPointTripResponse

MultiPointType

0:1

MultiPointType

The MultiPointType should be returned because it may differ from the one asked. Many systems will support only a subset of the MultiPointTypes and it is important to know, what the result is based on.

MultiPointTripResponseContext

0:1

+ResponseContext

Context to hold trip response objects that occur frequently.

MultiPointTripResult

0:*

+MultiPointTripResult

The trip results found by the server.

→‍siri:Extensions

0:1

→‍siri:Extensions

→‍siri:Extensions

0:1

→‍siri:Extensions

2.33. The toplevel element OJPTripRefineRequest

OJPTripRefineRequest

+OJPTripRefineRequest (↔ siri:AbstractFunctionalServiceRequest)

The trip refinement service retrieves additional or updated information (e.g., real-time data) about a given, previously retrieved trip. It does not depend on the assumption that the trip has been retrieved from the same server; it may, in fact, even stem from another source than a OJP system. -An example scenario may involve a trip retrieved from a system A and one wishes to refine the trip with real time information from another system B. As it cannot be ascertained that both systems use identical objcet IDs, this is signalled by setting ExternalObjectRefs to true. -System B, being confronted with external IDs, must try to recognise the relevant objects in another way and retrieve them in its own database. In the response it will use its own object IDs. In order to maintain a consistent mapping, it is imperative that system B reflects the structure of the refine request precisely in its response (principle of structure maintenance).

2.34. The complex type OJPTripRefineRequestStructure

+An example scenario may involve a trip retrieved from a system A and one wishes to refine the trip with real time information from another system B. As it cannot be ascertained that both systems use identical object IDs, this is signalled by setting ExternalObjectRefs to true. +System B, being confronted with external IDs, must try to recognise the relevant objects in another way and retrieve them in its own database. In the response it will use its own object IDs. To maintain a consistent mapping, it is imperative that system B reflects the structure of the refine request precisely in its response (principle of structure maintenance).

OJPTripRefineRequestStructure

+AbstractOJPServiceRequest

2.34. The complex type OJPTripRefineRequestStructure

@@ -272,12 +272,12 @@

OJP - Open API for distributed Journey

OJPTripRefineRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

TripRefineRequest

RefineParams

0:1

+TripRefineParam

Options to control the refine

→‍siri:Extensions

0:1

→‍siri:Extensions

2.35. The toplevel element OJPTripRefineDelivery

OJPTripRefineDelivery

+OJPTripRefineDelivery (↔ siri:AbstractFunctionalServiceDelivery)

The trip refinement service retrieves additional or updated information (e.g., real-time data) about a given, previously retrieved trip. It does not depend on the assumption that the trip has been retrieved from the same server; it may, in fact, even stem from another source than a OJP system. -An example scenario may involve a trip retrieved from a system A and one wishes to refine the trip with real time information from another system B. As it cannot be ascertained that both systems use identical objcet IDs, this is signalled by setting ExternalObjectRefs to true. -System B, being confronted with external IDs, must try to recognise the relevant objects in another way and retrieve them in its own database. In the response it will use its own object IDs. In order to maintain a consistent mapping, it is imperative that system B reflects the structure of the refine request precisely in its response (principle of structure maintenance).

2.36. The complex type OJPTripRefineDeliveryStructure

+An example scenario may involve a trip retrieved from a system A and one wishes to refine the trip with real time information from another system B. As it cannot be ascertained that both systems use identical object IDs, this is signalled by setting ExternalObjectRefs to true. +System B, being confronted with external IDs, must try to recognise the relevant objects in another way and retrieve them in its own database. In the response it will use its own object IDs. To maintain a consistent mapping, it is imperative that system B reflects the structure of the refine request precisely in its response (principle of structure maintenance).

OJPTripRefineDeliveryStructure

siri:AbstractServiceDeliveryStructure

2.36. The complex type OJPTripRefineDeliveryStructure

+An example scenario may involve a trip retrieved from a system A and one wishes to refine the trip with real time information from another system B. As it cannot be ascertained that both systems use identical object IDs, this is signalled by setting ExternalObjectRefs to true. +System B, being confronted with external IDs, must try to recognise the relevant objects in another way and retrieve them in its own database. In the response it will use its own object IDs. To maintain a consistent mapping, it is imperative that system B reflects the structure of the refine request precisely in its response (principle of structure maintenance).

@@ -362,11 +362,11 @@

OJP - Open API for distributed Journey

4. OJP/OJP_Fare.xsd - Request and response definitions for general, stop-specific and trip-specific fare information

4.1. Simple type definitions

OJPTripRefineDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

→‍OJPTripRefineRequest

0:1

→‍OJPTripRefineRequest

The trip refinement service retrieves additional or updated information (e.g., real-time data) about a given, previously retrieved trip. It does not depend on the assumption that the trip has been retrieved from the same server; it may, in fact, even stem from another source than a OJP system. -An example scenario may involve a trip retrieved from a system A and one wishes to refine the trip with real time information from another system B. As it cannot be ascertained that both systems use identical objcet IDs, this is signalled by setting ExternalObjectRefs to true. -System B, being confronted with external IDs, must try to recognise the relevant objects in another way and retrieve them in its own database. In the response it will use its own object IDs. In order to maintain a consistent mapping, it is imperative that system B reflects the structure of the refine request precisely in its response (principle of structure maintenance).

ServiceResponseContext

DataFrameRef

0:1

siri:DataFrameRefStructure

identifier of the set of data being used by an information system, which allows a comparison to be made with the versions of data being used by overlapping systems.

CalcTime

0:1

Calc

Calculation time.

ErrorCondition

0:*

+OJPError

OJP generic problem for the whole delivery.

FareResultObjectIdType

ObjectIdType

Type for identifier of a NeTEx Object.

4.2. The FareRequestGroup group

-

FareRequestGroup

Fare request structure.

The element contains one of the following elements:

FareRequest

a

MultiTripFareRequest

-1:1

+MultiTripFareRequest

A request to calculate aggregated FARE information of multiple single trips.

b

PlaceFareRequest

-1:1

+PlaceFareRequest

A request for place-related FARE information.

c

StaticFareRequest

-1:1

+StaticFareRequest

A request for general/static FARE information.

d

StopFareRequest

-1:1

+StopFareRequest

A request for stop-related FARE information.

e

TripFareRequest

-1:1

+TripFareRequest

A request to calculate the FARE information of a single trip.

Params

0:1

+FareParam

Parameter to filter the response contents.

4.3. The complex type StopFareRequestStructure

StopFareRequestStructure

Sub-request: stop-related fare information.

The element contains a sequence of the following elements:

→‍siri:StopPointRef

1:1

→‍siri:StopPointRef

Reference to the stop point.

Date

0:1

xs:date

Date for which to retrieve Fare information.

4.4. The complex type PlaceFareRequestStructure

PlaceFareRequestStructure

Sub-request: PLACE related fare information. This doesn't make a lot of sense for addresses, topographic place and coordinates. However, STOP PLACE, SCHEDULED STOP POINT and POINT OF INTEREST are different.

The element contains a sequence of the following elements:

Place

1:1

+Place

Place to get FAREs from (usually use only StopPoint, StopPlace and PointOfInterest).

Date

0:1

xs:date

Date for which to retrieve Fare information.

→‍FareProductRef

0:*

→‍FareProductRef

Reference to a FareProduct. If no FareProductRef is specified the responding system should reply with information about all available fare products.

4.5. The complex type StaticFareRequestStructure

StaticFareRequestStructure

General Fare information. May depend on date.

The element contains a sequence of the following elements:

Date

0:1

xs:date

Date for which to retrieve Fare information.

→‍FareProductRef

0:*

→‍FareProductRef

Reference to a FareProduct. If no FareProductRef is specified the responding system should reply with information about all available fare products.

4.6. The complex type TripFareRequestStructure

TripFareRequestStructure

Structure of a Single Trip Fare Request.

The element contains a sequence of the following elements:

TripContext

0:1

+ResponseContext

Context to hold trip related objects that occur frequently. Especially necessary, when the system answering the fare request is not the same as the one that did the trip request.

Trip

1:1

+Trip

A complete trip from origin to destination

4.7. The complex type MultiTripFareRequestStructure

MultiTripFareRequestStructure

Structure of a Multi Trip Fare Request.

The element contains a sequence of the following elements:

TripContext

0:1

+ResponseContext

Context to hold trip related objects that occur frequently.

Trip

1:*

+Trip

Multiple complete trips from multiple origins and multiple destination

4.8. The FareResponseGroup group

+

FareResponseGroup

4.3. The complex type StopFareRequestStructure

StopFareRequestStructure

Sub-request: stop-related fare information.

The element contains a sequence of the following elements:

→‍siri:StopPointRef

1:1

→‍siri:StopPointRef

Reference to the stop point.

Date

0:1

xs:date

Date for which to retrieve Fare information.

4.4. The complex type PlaceFareRequestStructure

PlaceFareRequestStructure

Sub-request: PLACE related fare information. This doesn't make a lot of sense for addresses, topographic place, and coordinates. However, STOP PLACE, SCHEDULED STOP POINT and POINT OF INTEREST are different.

The element contains a sequence of the following elements:

Place

1:1

+Place

Place to get FAREs from (usually use only StopPoint, StopPlace and PointOfInterest).

Date

0:1

xs:date

Date for which to retrieve Fare information.

→‍FareProductRef

0:*

→‍FareProductRef

Reference to a FareProduct. If no FareProductRef is specified, the responding system should reply with information about all available fare products.

4.5. The complex type StaticFareRequestStructure

StaticFareRequestStructure

General Fare information. May depend on date.

The element contains a sequence of the following elements:

Date

0:1

xs:date

Date for which to retrieve Fare information.

→‍FareProductRef

0:*

→‍FareProductRef

Reference to a FareProduct. If no FareProductRef is specified, the responding system should reply with information about all available fare products.

4.6. The complex type TripFareRequestStructure

TripFareRequestStructure

Structure of a Single Trip Fare Request.

The element contains a sequence of the following elements:

TripContext

0:1

+ResponseContext

Context to hold trip related objects that occur frequently. Especially necessary, when the system answering the fare request is not the same as the one that did the trip request.

Trip

1:1

+Trip

A complete trip from origin to destination

4.7. The complex type MultiTripFareRequestStructure

MultiTripFareRequestStructure

Structure of a Multi Trip Fare Request.

The element contains a sequence of the following elements:

TripContext

0:1

+ResponseContext

Context to hold trip related objects that occur frequently.

Trip

1:*

+Trip

Multiple complete trips from multiple origins and multiple destination

4.8. The FareResponseGroup group

-

FareResponseGroup

FareResponse

FareResponseContext

0:1

+ResponseContext

Context to hold trip response objects that occur frequently.

FareResult

0:*

+FareResult

Fare result choice element.

4.9. The complex type FareResultStructure

FareResultStructure

Wrapper element for Fare results.

The element contains a sequence of the following elements:

Id

1:1

FareResultObjectId

ID of this result.

ErrorCondition

0:*

+OJPError

Problems related to this FARE result.

FareEstimated

0:1

xs:boolean

Whether the fare is only estimated by the service. Estimated can mean different things: For example, the fare may vary depending on age, PassengerCategory, FareClass, EntitlementProducts. It can also mean that the fare structure used by the service is not entirely accurate or that other factors, such as the time a shared vehicle is used, need to be factored into the price. As a rule, the price should then be given as an approximate and probably lower limit of the actual price. Default is TRUE.

Then, the element contains one of the following elements:

a

MultiTripFareResult

-1:*

+MultiTripFareResult

Fare and FareProducts for multiple trips.

b

PlaceFareResult

-1:1

+PlaceFareResult

Place-related Fare information.

c

StaticFareResult

-1:1

+StaticFareResult

Static Fare information.

d

StopFareResult

-1:1

+StopFareResult

Stop-related Fare information.

e

TripFareResult

-1:*

+TripFareResult

Fare and FareProducts for a given trip.

4.10. The complex type StopFareResultStructure

StopFareResultStructure

Stop-related Fare information.

The element contains a sequence of the following elements:

TariffZoneListInArea

1:*

+TariffZoneListInArea

One or more lists of Fare zones that belong to a Fare authority/area.

Extension

0:1

xs:anyType

4.11. The complex type PlaceFareResultStructure

PlaceFareResultStructure

PLACE-related Fare information.

The element contains a sequence of the following elements:

Place

1:1

+Place

The involved PLACE. Usually a StopPoint, StopPlace or PointOfInterest.

FareProduct

0:*

+FareProduct

[related to FARE PRODUCT in TM and NeTEx] different FARE PRODUCTs that may be available with related information.

StaticInfoUrl

0:*

+WebLink

URL to information page on the web.

Extension

0:1

xs:anyType

4.12. The complex type StaticFareResultStructure

StaticFareResultStructure

General Fare information.

The element contains a sequence of the following elements:

FareProduct

0:*

+FareProduct

[related to FARE PRODUCT in TM and NeTEx] different FARE PRODUCTs that may be available with related information.

StaticInfoUrl

0:*

+WebLink

URL to information page on the web.

Extension

0:1

xs:anyType

4.13. The complex type TripFareProductReferenceStructure

TripFareProductReferenceStructure

Element that connects FareProducts to trips. A TripFareProduct is a FAREPRODUCT covering a part or the whole of a TRIP from boarding the first public transport vehicle to alighting from the last public transport vehicle (corresponds to a package of PREASSIGNED FARE PRODUCTs)

The element contains a sequence of the following elements:

→‍FareProductRef

1:1

→‍FareProductRef

Reference to a FareProduct.

FromTripIdRef

1:1

Identifies the "valid from" trip.

FromLegIdRef

0:1

LegObjectId

Identifies the "valid from" LEG. If missing, then valid from the first LEG.

ToTripIdRef

1:1

Identifies the "valid to" trip.

ToLegIdRef

0:1

LegObjectId

Identifies the "valid to" LEG. If missing, then valid to the last LEG.

4.14. The complex type MultiTripFareResultStructure

MultiTripFareResultStructure

Structure of a Multi Trip Fare Request result

The element contains a sequence of the following elements:

TripFareProductReference

1:*

+TripFareProductReference

Non-empty list of trip references in the corresponding MultiTripFareRequestStructure

FareProduct

0:*

+FareProduct

Zero, one or more FareProducts that are valid for the referenced trips / part of trips.

PassedZones

0:1

+TariffZoneListInArea

The set of passed zones.

StaticInfoUrl

0:*

+WebLink

URL to Fare information pages on the web.

-

5. OJP/OJP_FareSupport.xsd - Supporting definitions for fare information on passenger trips

5.1. Simple type definitions

BookingAccessEnumeration

public | authorisedPublic | staff | other

Allowed values for Booking Access.

BookingMethodEnumeration

callDriver | callOffice | online | other | phoneAtStop | text | mobileApp | atOffice | none

Allowed values for a booking method.

BookingObjectIdType

ObjectIdType

Type for identifier of a BOOKING Object.

BookingProcessEnumeration

xs:normalizedString

Allowed values for Booking Process UIC 7037 Code list.

ContactTypeEnumeration

any | information | reservations | lostProperty | publicRelations | complaints | emergency | other

Allowed values for CONTACT role.

EntitlementProductCodeType

xs:NMTOKEN

Identifier of an ENTITLEMENT PRODUCT (e.g. BahnCard50, BahnCard50First, military card, concessionary card, ...). It is defined by the fare authority.

FareAuthorityCodeType

xs:NMTOKEN

Identifier of a Fare Authority.

FareProblemTypeEnumeration

FARE_OUTOFAREA | FARE_JOURNEYNOTPERMITTED | FARE_ADDITIONALCHARGES | FARE_ADDITIONALTICKETS | FARE_ROUTENOTFEASIBLE | FARE_ALREADYCOVERED | FARE_DATEOUTOFRANGE | FARE_STOPPOINTUNKNOWN | FARE_OTHER

Types of problems that may be returned in responses to FARE requests.

FareProductIdType

xs:NMTOKEN

Identifier of a FareProduct

GroupBookingEnumeration

xs:normalizedString

Allowed values for Group Booking.

PassengerCategoryEnumeration

Adult | Child | Senior | Youth | Disabled | Dog | Bicycle | Motorcycle | Car | Truck | Group

[a simplified and specialised view of USER PROFILE in TM and NeTEx] classification of passengers by age or other factors that may determine the fare they will need to pay.

PhoneType

xs:normalizedString

Type for an International phone number. + Country + MSISDN e.g. +41 675601 etc.

PurchaseMomentEnumeration

xs:normalizedString

Allowed values for Purchase Moment.

PurchaseWhenEnumeration

xs:normalizedString

Allowed values for Purchase when.

TariffZoneCodeType

xs:NMTOKEN

Identifier of a fare zone.

5.2. The complex type BookingNotesStructure

BookingNotesStructure

A structure for an ordered list of booking notes.

The element contains only one element:

BookingNote

1:*

+InternationalText

Note about booking the LINE.

5.3. The complex type FareAuthorityRefStructure

FareAuthorityRefStructure

FareAuthorityCode

Reference to a Fare Authority ([a specialisation of an ORGANISATION in TMv6] ORGANISATION which has the RESPONSIBILITY ROLE for the definition of FARE PRODUCTs).

5.4. The toplevel element FareAuthorityRef

FareAuthorityRef

+FareAuthorityRef

Reference to a Fare Authority.

5.5. The FareAuthorityGroup group

+

FareAuthorityGroup

Group of attributes for an ORGANISATION which has the RESPONSIBILITY ROLE for the definition of FARE PRODUCTs

4.9. The complex type FareResultStructure

FareResultStructure

Wrapper element for Fare results.

The element contains a sequence of the following elements:

Id

1:1

FareResultObjectId

ID of this result.

ErrorCondition

0:*

+OJPError

Problems related to this FARE result.

FareEstimated

0:1

xs:boolean

Whether the fare is only estimated by the service. Estimated can mean different things: For example, the fare may vary depending on age, PassengerCategory, FareClass, EntitlementProducts. It can also mean that the fare structure used by the service is not entirely accurate or that other factors, such as the time a shared vehicle is used, need to be factored into the price. As a rule, the price should then be given as an approximate and probably lower limit of the actual price. Default is TRUE.

Then, the element contains one of the following elements:

a

MultiTripFareResult

-1:*

+MultiTripFareResult

Fare and FareProducts for multiple trips.

b

PlaceFareResult

-1:1

+PlaceFareResult

Place-related Fare information.

c

StaticFareResult

-1:1

+StaticFareResult

Static Fare information.

d

StopFareResult

-1:1

+StopFareResult

Stop-related Fare information.

e

TripFareResult

-1:*

+TripFareResult

Fare and FareProducts for a given trip.

4.10. The complex type StopFareResultStructure

StopFareResultStructure

Stop-related Fare information.

The element contains a sequence of the following elements:

TariffZoneListInArea

1:*

+TariffZoneListInArea

One or more lists of Fare zones that belong to a Fare authority/area.

Extension

0:1

xs:anyType

4.11. The complex type PlaceFareResultStructure

PlaceFareResultStructure

PLACE-related Fare information.

The element contains a sequence of the following elements:

Place

1:1

+Place

The involved PLACE. Usually,a StopPoint, StopPlace or PointOfInterest.

FareProduct

0:*

+FareProduct

[related to FARE PRODUCT in TM and NeTEx] different FARE PRODUCTs that may be available with related information.

StaticInfoUrl

0:*

+WebLink

URL to information page on the web.

Extension

0:1

xs:anyType

4.12. The complex type StaticFareResultStructure

StaticFareResultStructure

General Fare information.

The element contains a sequence of the following elements:

FareProduct

0:*

+FareProduct

[related to FARE PRODUCT in TM and NeTEx] different FARE PRODUCTs that may be available with related information.

StaticInfoUrl

0:*

+WebLink

URL to information page on the web.

Extension

0:1

xs:anyType

4.13. The complex type TripFareProductReferenceStructure

TripFareProductReferenceStructure

Element that connects FareProducts to trips. A TripFareProduct is a FAREPRODUCT covering a part or the whole of a TRIP from boarding the first public transport vehicle to alighting from the last public transport vehicle (corresponds to a package of PREASSIGNED FARE PRODUCTs)

The element contains a sequence of the following elements:

→‍FareProductRef

1:1

→‍FareProductRef

Reference to a FareProduct.

FromTripIdRef

1:1

Identifies the "valid from" trip.

FromLegIdRef

0:1

LegObjectId

Identifies the "valid from" LEG. If missing, then valid from the first LEG.

ToTripIdRef

1:1

Identifies the "valid to" trip.

ToLegIdRef

0:1

LegObjectId

Identifies the "valid to" LEG. If missing, then valid to the last LEG.

4.14. The complex type MultiTripFareResultStructure

MultiTripFareResultStructure

Structure of a Multi Trip Fare Request result

The element contains a sequence of the following elements:

TripFareProductReference

1:*

+TripFareProductReference

Non-empty list of trip references in the corresponding MultiTripFareRequestStructure

FareProduct

0:*

+FareProduct

Zero, one or more FareProducts that are valid for the referenced trips / part of trips.

PassedZones

0:1

+TariffZoneListInArea

The set of passed zones.

StaticInfoUrl

0:*

+WebLink

URL to Fare information pages on the web.

+

5. OJP/OJP_FareSupport.xsd - Supporting definitions for fare information on passenger trips

5.1. Simple type definitions

BookingAccessEnumeration

public | authorisedPublic | staff | other

Allowed values for Booking Access.

BookingMethodEnumeration

callDriver | callOffice | online | other | phoneAtStop | text | mobileApp | atOffice | none

Allowed values for a booking method.

BookingObjectIdType

ObjectIdType

Type for identifier of a BOOKING Object.

BookingProcessEnumeration

xs:normalizedString

Allowed values for Booking Process UIC 7037 Code list.

ContactTypeEnumeration

any | information | reservations | lostProperty | publicRelations | complaints | emergency | other

Allowed values for CONTACT role.

EntitlementProductCodeType

xs:NMTOKEN

Identifier of an ENTITLEMENT PRODUCT (e.g., BahnCard50, BahnCard50First, military card, concessionary card). It is defined by the fare authority.

FareAuthorityCodeType

xs:NMTOKEN

Identifier of a Fare Authority.

FareProblemTypeEnumeration

FARE_OUTOFAREA | FARE_JOURNEYNOTPERMITTED | FARE_ADDITIONALCHARGES | FARE_ADDITIONALTICKETS | FARE_ROUTENOTFEASIBLE | FARE_ALREADYCOVERED | FARE_DATEOUTOFRANGE | FARE_STOPPOINTUNKNOWN | FARE_OTHER

Types of problems that may be returned in responses to FARE requests.

FareProductIdType

xs:NMTOKEN

Identifier of a FareProduct

GroupBookingEnumeration

xs:normalizedString

Allowed values for Group Booking.

PassengerCategoryEnumeration

Adult | Child | Senior | Youth | Disabled | Dog | Bicycle | Motorcycle | Car | Truck | Group

[a simplified and specialised view of USER PROFILE in TM and NeTEx] classification of passengers by age or other factors that may determine the fare they will need to pay.

PhoneType

xs:normalizedString

Type for an International phone number. + Country + MSISDN e.g., +41 675601 etc.

PurchaseMomentEnumeration

xs:normalizedString

Allowed values for Purchase Moment.

PurchaseWhenEnumeration

xs:normalizedString

Allowed values for Purchase when.

TariffZoneCodeType

xs:NMTOKEN

Identifier of a fare zone.

5.2. The complex type BookingNotesStructure

BookingNotesStructure

A structure for an ordered list of booking notes.

The element contains only one element:

BookingNote

1:*

+InternationalText

Note about booking the LINE.

5.3. The complex type FareAuthorityRefStructure

FareAuthorityRefStructure

FareAuthorityCode

Reference to a Fare Authority ([a specialisation of an ORGANISATION in TMv6] ORGANISATION which has the RESPONSIBILITY ROLE for the definition of FARE PRODUCTs).

5.4. The toplevel element FareAuthorityRef

FareAuthorityRef

+FareAuthorityRef

Reference to a Fare Authority.

5.5. The FareAuthorityGroup group

FareAuthorityGroup

Group of attributes for an ORGANISATION which has the RESPONSIBILITY ROLE for the definition of FARE PRODUCTs

FareAuthority

→‍FareAuthorityRef

1:1

→‍FareAuthorityRef

Reference to a Fare Authority.

FareAuthorityText

1:1

xs:string

Textual description or name of Fare authority.

5.6. The complex type TariffZoneRefStructure

TariffZoneRefStructure

Reference to a fare zone.

5.7. The toplevel element TariffZoneRef

TariffZoneRef

+TariffZoneRef

Reference to a fare zone.

5.8. The complex type TariffZoneStructure

TariffZoneStructure

[a more clearly defined equivalent of TARIFF ZONE in TM and NeTEx] A ZONE used to define a zonal fare structure in a zone-counting or zone-matrix system.

The element contains a sequence of the following elements:

→‍TariffZoneRef

1:1

→‍TariffZoneRef

Reference to a fare zone.

TariffZoneText

1:1

xs:string

Text describing the fare zone. Passengers will recognize the fare zone by this text. Often published on Fare Zone Maps.

5.9. The complex type TariffZoneListInAreaStructure

@@ -384,17 +384,17 @@

OJP - Open API for distributed Journey

-

TariffZoneListInAreaStructure

List of fare zones within the area of a Fare Authority.

The element contains a sequence of the following elements:

BookingUrl

0:1

+WebLink

URL for booking.

BookingNotes

0:1

+BookingNotes

Notes about booking the LINE.

Extension

0:1

xs:anyType

5.18. The complex type BookingArrangementsContainerStructure

BookingArrangementsContainerStructure

Container for multiple booking arrangements.

The element contains a sequence of the following elements:

BookingArrangement

1:*

+BookingArrangements

[a more generalised form of BOOKING ARRANGEMENTS in TMv6] arrangement for booking any leg or legs of a journey.

Extension

0:1

xs:anyType

5.19. The complex type FareProductRefStructure

FareProductRefStructure

FareProductId

Reference to a FareProduct.

5.20. The toplevel element FareProductRef

FareProductRef

+FareProductRef

Reference to a FareProduct.

5.21. The complex type EntitlementProductListStructure

EntitlementProductListStructure

A list of ENTITLEMENT PRODUCTs

The element contains only one element:

EntitlementProduct

1:*

+EntitlementProduct

[a specific form of TRAVEL DOCUMENT in TM and NeTEx] Precondition to access a service or to purchase a FARE PRODUCT issued by an organisation that may not be a PT operator (e.g. military card, concessionary card, ...). In most cases, ENTITLEMENT PRODUCTs offer discounts, e.g. the "BahnCard50" of "Deutsche Bahn".

5.22. The complex type EntitlementProductStructure

EntitlementProductStructure

[a specific form of TRAVEL DOCUMENT in TM and NeTEx] Precondition to access a service or to purchase a FARE PRODUCT issued by an organisation that may not be a PT operator (e.g. military card, concessionary card, ...). In most cases, ENTITLEMENT PRODUCTs offer discounts, e.g. the "BahnCard50" of "Deutsche Bahn".

The element contains a sequence of the following elements:

→‍FareAuthorityRef

1:1

→‍FareAuthorityRef

Reference to the fare authority that issued the ENTITLEMENT PRODUCT

EntitlementProductRef

1:1

EntitlementProductCode

Identifier of the ENTITLEMENT PRODUCT (e.g. BahnCard50, BahnCard50First, ...)

ValidityPeriod

0:1

siri:HalfOpenTimestampOutputRangeStructure

Validity period of the ENTITLEMENT PRODUCT

EntitlementProductName

1:1

xs:string

Name of the ENTITLEMENT PRODUCT

5.23. The complex type FareProductStructure

+

FareProductStructure

[related to FARE PRODUCT in TM and NeTEx] different FARE PRODUCTs that may be available with related information

The element contains a sequence of the following elements:

FareProductId

1:1

FareProductId

Identifier of a FareProduct

FareProductName

1:1

xs:string

Printable FareProduct name

5.18. The complex type BookingArrangementsContainerStructure

BookingArrangementsContainerStructure

Container for multiple booking arrangements.

The element contains a sequence of the following elements:

BookingArrangement

1:*

+BookingArrangements

[a more generalised form of BOOKING ARRANGEMENTS in TMv6] arrangement for booking any leg or legs of a journey.

Extension

0:1

xs:anyType

5.19. The complex type FareProductRefStructure

FareProductRefStructure

FareProductId

Reference to a FareProduct.

5.20. The toplevel element FareProductRef

FareProductRef

+FareProductRef

Reference to a FareProduct.

5.21. The complex type EntitlementProductListStructure

EntitlementProductListStructure

A list of ENTITLEMENT PRODUCTs

The element contains only one element:

EntitlementProduct

1:*

+EntitlementProduct

[a specific form of TRAVEL DOCUMENT in TM and NeTEx] Precondition to access a service or to purchase a FARE PRODUCT issued by an organisation that may not be a PT operator (e.g., military card, concessionary card). In most cases, ENTITLEMENT PRODUCTs offer discounts, e.g., the "BahnCard50" of "Deutsche Bahn".

5.22. The complex type EntitlementProductStructure

EntitlementProductStructure

[a specific form of TRAVEL DOCUMENT in TM and NeTEx] Precondition to access a service or to purchase a FARE PRODUCT issued by an organisation that may not be a PT operator (e.g., military card, concessionary card). In most cases, ENTITLEMENT PRODUCTs offer discounts, e.g., the "BahnCard50" of "Deutsche Bahn".

The element contains a sequence of the following elements:

→‍FareAuthorityRef

1:1

→‍FareAuthorityRef

Reference to the fare authority that issued the ENTITLEMENT PRODUCT

EntitlementProductRef

1:1

EntitlementProductCode

Identifier of the ENTITLEMENT PRODUCT (e.g., BahnCard50, BahnCard50First)

ValidityPeriod

0:1

siri:HalfOpenTimestampOutputRangeStructure

Validity period of the ENTITLEMENT PRODUCT

EntitlementProductName

1:1

xs:string

Name of the ENTITLEMENT PRODUCT

5.23. The complex type FareProductStructure

- + - + - + @@ -407,11 +407,11 @@

OJP - Open API for distributed Journey

FareProductStructure

[related to FARE PRODUCT in TM and NeTEx] different FARE PRODUCTs that may be available with related information

The element contains a sequence of the following elements:

FareProductId

1:1

FareProductId

Identifier of a FareProduct

FareProductName

1:1

xs:string

Printable FareProduct name

FareAuthority

→‍FareAuthorityRef

1:1

→‍FareAuthorityRef

Reference to a Fare Authority.

FareAuthorityText

1:1

xs:string

Textual description or name of Fare authority.

ProtoProduct

0:1

xs:boolean

Is this product a proto product? Default is false. If true, it should not be shown to the user. In a distributed environment (e.g. EU-Spirit) partial systems may generate incomplete product information (proto product), which has to be processed further and combined with other information before it is a complete fare product and can be shown to the user. See https://eu-spirit.eu/

ProtoProduct

0:1

xs:boolean

Is this product a proto product? Default is false. If true, it should not be shown to the user. In a distributed environment (e.g., EU-Spirit) partial systems may generate incomplete product information (proto product), which has to be processed further and combined with other information before it is a complete fare product and can be shown to the user. See https://eu-spirit.eu/

FareProductPrice

Price

0:1

xs:decimal

FareProduct price as decimal number.

NetPrice

0:1

xs:decimal

Net FareProduct price as decimal number for accounting purposes.

Currency

0:1

xs:NMTOKEN

iso 4217 currency code, e.g. EUR for Euro or GBP for Pound Sterling

Currency

0:1

xs:NMTOKEN

iso 4217 currency code, e.g., EUR for Euro or GBP for Pound Sterling

VatRate

0:1

Percentage

Rate of value added tax.

FareQuota

0:1

xs:integer

Remaining offered tickets in this FARE PRODUCT. When absent, the number of remaining tickets is unknown or it is not limited. In most cases if the FareQuota is zero then the FareProduct is not shown.

FareProductValidity

FareClass

0:1

siri:FareClassEnumeration

Fare class for which the FareProduct is valid (Transmodel: CLASS OF USE).

RequiredCard

0:*

+EntitlementProduct

One or more ENTITLEMENT PRODUCTs required for the purchase of this FareProduct. In most cases, ENTITLEMENT PRODUCTs offer discounts, e.g. the "BahnCard50" of "Deutsche Bahn".

RequiredCard

0:*

+EntitlementProduct

One or more ENTITLEMENT PRODUCTs required for the purchase of this FareProduct. In most cases, ENTITLEMENT PRODUCTs offer discounts, e.g., the "BahnCard50" of "Deutsche Bahn".

ValidFor

0:*

PassengerCategory

Sequence of all passenger categories for which this FareProduct is valid.

ValidityDuration

0:1

xs:duration

Maximum duration of FareProduct validity starting with purchase of ticket or begin of journey (ticket validation).

ValidityDurationText

0:1

+InternationalText

Textual description of maximum validity duration.

Extension

0:1

xs:anyType

5.24. The FareProductPriceGroup group

- +

FareProductPriceGroup

[related to FARE PRODUCT PRICE in TM and NeTEx] price at which a FARE PRODUCT can be purchased.

FareProductPrice

Price

0:1

xs:decimal

FareProduct price as decimal number.

NetPrice

0:1

xs:decimal

Net FareProduct price as decimal number for accounting purposes.

Currency

0:1

xs:NMTOKEN

iso 4217 currency code, e.g. EUR for Euro or GBP for Pound Sterling

Currency

0:1

xs:NMTOKEN

iso 4217 currency code, e.g., EUR for Euro or GBP for Pound Sterling

VatRate

0:1

Percentage

Rate of value added tax.

5.25. The FareProductValidityGroup group

- + @@ -424,29 +424,29 @@

OJP - Open API for distributed Journey

FareProductValidityGroup

conditions of use for a particular FARE PRODUCT.

FareProductValidity

FareClass

0:1

siri:FareClassEnumeration

Fare class for which the FareProduct is valid (Transmodel: CLASS OF USE).

RequiredCard

0:*

+EntitlementProduct

One or more ENTITLEMENT PRODUCTs required for the purchase of this FareProduct. In most cases, ENTITLEMENT PRODUCTs offer discounts, e.g. the "BahnCard50" of "Deutsche Bahn".

RequiredCard

0:*

+EntitlementProduct

One or more ENTITLEMENT PRODUCTs required for the purchase of this FareProduct. In most cases, ENTITLEMENT PRODUCTs offer discounts, e.g., the "BahnCard50" of "Deutsche Bahn".

ValidFor

0:*

PassengerCategory

Sequence of all passenger categories for which this FareProduct is valid.

ValidityDuration

0:1

xs:duration

Maximum duration of FareProduct validity starting with purchase of ticket or begin of journey (ticket validation).

ValidityDurationText

0:1

+InternationalText

Textual description of maximum validity duration.

5.27. The LegRangeGroup group

-

LegRangeGroup

Range of LEGs (from - to) for which a Fare result (ticket) is valid.

LegRange

FromLegIdRef

1:1

LegObjectId

Identifies the "valid from" LEG.

ToLegIdRef

1:1

LegObjectId

Identifies the "valid to" LEG.

5.28. The complex type TripFareResultStructure

+

TripFareResultStructure

Structure of a single TripFareResult. This may cover the whole trip or only the part the service can answer. If only partial answers can be delivered, then this must be indicated with FARE_ADDITIONALTICKETS (as a warning). For a given trip multiple FareResults may need to be combined to get the whole tariff. A typical example may be classic public transport and a sharing leg. Some legs, e.g. TransferLegs and walking ContinuousLeg will never have a price. The service may include them in one of the tickets. If the whole trip is for free, then a TripFareResult with a price of 0 is expected. It is possible to have combined FareResults (e.g. for a bundle) and in addition price each leg individually.

The element contains a sequence of the following elements:

ErrorCondition

0:*

+OJPError

Result-specific error messages.

TripId

0:1

BookingId

0:1

BookingObjectId

5.28. The complex type TripFareResultStructure

-

TripFareResultStructure

Structure of a single TripFareResult. This may cover the whole trip or only the part the service can answer. If only partial answers can be delivered, then this must be indicated with FARE_ADDITIONALTICKETS (as a warning). For a given trip multiple FareResults may need to be combined to get the whole tariff. A typical example may be classic public transport and a sharing leg. Some legs, e.g., TransferLegs and walking ContinuousLeg will never have a price. The service may include them in one of the tickets. If the whole trip is for free, then a TripFareResult with a price of 0 is expected. It is possible to have combined FareResults (e.g., for a bundle) and in addition price each leg individually.

The element contains a sequence of the following elements:

ErrorCondition

0:*

+OJPError

Result-specific error messages.

TripId

0:1

BookingId

0:1

BookingObjectId

LegRange

FromLegIdRef

1:1

LegObjectId

Identifies the "valid from" LEG.

ToLegIdRef

1:1

LegObjectId

Identifies the "valid to" LEG.

PassedZones

0:1

+TariffZoneListInArea

The sequence of passed fare zones.

FareProduct

0:*

+FareProduct

One ore more FareProducts that are valid for this part of the trip.

StaticInfoUrl

0:*

+WebLink

URL to static information page on the web.

5.29. The complex type FarePassengerStructure

FarePassengerStructure

[a specialised form of USER PROFILE in TM and NeTEx] attributes of a passenger that influence the price to be paid by that passenger for a FARE PRODUCT.

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

a

Age

-1:1

xs:nonNegativeInteger

Age of the passenger on the day of travel.

b

PassengerCategory

-1:1

PassengerCategory

sequence of all passenger categories, for which this FareProduct is valid

EntitlementProducts

0:1

+EntitlementProductList

A list of ENTITLEMENT PRODUCTs.

Then, the element contains one of the following elements:

a

SalesPackageElementRef

-1:*

+FareProductRef

Id of a FareProduct that the passenger already holds and that may be used for the travel or parts of it.

b

ZonesAlreadyPaid

-1:1

+TariffZoneRefList

Fare zones for which the passenger already has a valid FareProduct.

5.30. The FareDataFilterGroup group

+

FareDataFilterGroup

Data filter group for Fare request.

PassedZones

0:1

+TariffZoneListInArea

The sequence of passed fare zones.

FareProduct

0:*

+FareProduct

One or more FareProducts that are valid for this part of the trip.

StaticInfoUrl

0:*

+WebLink

URL to static information page on the web.

5.29. The complex type FarePassengerStructure

FarePassengerStructure

[a specialised form of USER PROFILE in TM and NeTEx] attributes of a passenger that influence the price to be paid by that passenger for a FARE PRODUCT.

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

a

Age

-1:1

xs:nonNegativeInteger

Age of the passenger on the day of travel.

b

PassengerCategory

-1:1

PassengerCategory

sequence of all passenger categories, for which this FareProduct is valid

EntitlementProducts

0:1

+EntitlementProductList

A list of ENTITLEMENT PRODUCTs.

Then, the element contains one of the following elements:

a

SalesPackageElementRef

-1:*

+FareProductRef

Id of a FareProduct that the passenger already holds and that may be used for the travel or parts of it.

b

ZonesAlreadyPaid

-1:1

+TariffZoneRefList

Fare zones for which the passenger already has a valid FareProduct.

5.30. The FareDataFilterGroup group

- +

FareDataFilterGroup

Data filter group for Fare request.

FareDataFilter

FareAuthorityFilter

0:*

+FareAuthorityRef

Fare authority for which to retrieve Fare information.

PassengerCategory

0:*

PassengerCategory

sequence of all passenger categories, for which this FareProduct is valid

FareClass

0:1

siri:FareClassEnumeration

Fare class for which to retrieve FareProducts. Refers to TYPE OF FARE CLASS (e.g. first class). Transmodel: CLASS OF USE.

FareClass

0:1

siri:FareClassEnumeration

Fare class for which to retrieve FareProducts. Refers to TYPE OF FARE CLASS (e.g., first class). Transmodel: CLASS OF USE.

5.31. The complex type FareParamStructure

- +

FareParamStructure

[related to the FARE parameter model in TM and NeTEx] parameters which are used to determine the price to be paid for a FARE PRODUCT by a specific passenger.

The element contains a sequence of the following elements:

FareDataFilter

FareAuthorityFilter

0:*

+FareAuthorityRef

Fare authority for which to retrieve Fare information.

PassengerCategory

0:*

PassengerCategory

sequence of all passenger categories, for which this FareProduct is valid

FareClass

0:1

siri:FareClassEnumeration

Fare class for which to retrieve FareProducts. Refers to TYPE OF FARE CLASS (e.g. first class). Transmodel: CLASS OF USE.

FareClass

0:1

siri:FareClassEnumeration

Fare class for which to retrieve FareProducts. Refers to TYPE OF FARE CLASS (e.g., first class). Transmodel: CLASS OF USE.

Traveller

0:*

+FarePassenger

Number of travellers that will make the journey and for which Fare information needs to be gathered.

AccessModeList

0:1

+AccessModesListOf

ACCESS MODEs to consider (usually only one). This is only used in very special cases. E.g. for carTransportRail. It indicates if one uses a car, truck, motorcycle or bike. The Access mode may result in no transportation being possible.

Extension

0:1

xs:anyType

5.32. The toplevel element FareProblemType

FareProblemType

FareProblemType (↔ ErrorType)

6. OJP/OJP_Lines.xsd - Request and response definitions for information on lines

6.1. Simple type definitions

LineInformationProblemTypeEnumeration

LINEINFORMATION_LINEUNKNOWN | LINEINFORMATION_OTHER

Types of problems that may be returned in responses to LINE INFORMATION requests.

6.2. The LineInformationResponseGroup group

-

LineInformationResponseGroup

Line Information response group.

LineInformationResponse

LineResult

0:*

+LineResult

6.3. The complex type LineResultStructure

LineResultStructure

The element contains a sequence of the following elements:

ErrorCondition

0:*

+OJPError

Problems related to this Line result.

LineRef

1:1

siri:LineRefStructure

Reference to the LINE.

→‍siri:PublishedLineName

0:1

→‍siri:PublishedLineName

Name or Number by which the LINE is known to the public.

DirectionRef

0:1

siri:DirectionRefStructure

DIRECTION of LINE.

RouteGeometry

0:*

+LinearShape

The LINE's route geometry. A line can have multiple ROUTEs and each has its own geometry. The first should be the "main" geometry.

AreaGeometry

0:*

+Area

The LINE's main area. Used for MOBILITY SERVICES that cover one or more areas. The interconnection between the areas is not calculated (e.g. exclusion zones can't be modelled). Don't mix RouteGeometry and AreaGeometry in a response.

Mode

0:*

+Mode

List of transport modes that are supported by this line.

6.4. The toplevel element LineInformationProblemType

LineInformationProblemType

LineInformationProblemType (↔ ErrorType)

+

6.3. The complex type LineResultStructure

LineResultStructure

The element contains a sequence of the following elements:

ErrorCondition

0:*

+OJPError

Problems related to this Line result.

LineRef

1:1

siri:LineRefStructure

Reference to the LINE.

→‍siri:PublishedLineName

0:1

→‍siri:PublishedLineName

Name or Number by which the LINE is known to the public.

DirectionRef

0:1

siri:DirectionRefStructure

DIRECTION of LINE.

RouteGeometry

0:*

+LinearShape

The LINE's route geometry. A line can have multiple ROUTEs, and each has its own geometry. The first should be the "main" geometry.

AreaGeometry

0:*

+Area

The LINE's main area. Used for MOBILITY SERVICES that cover one or more areas. The interconnection between the areas is not calculated (e.g., exclusion zones can't be modelled). Don't mix RouteGeometry and AreaGeometry in a response.

Mode

0:*

+Mode

List of transport modes that are supported by this line.

6.4. The toplevel element LineInformationProblemType

LineInformationProblemType

LineInformationProblemType (↔ ErrorType)

7. OJP/OJP_Locations.xsd - Request and response definitions for location information

7.1. Simple type definitions

PlaceTypeEnumeration

stop | address | poi | coord | location | topographicPlace

PlaceUsageEnumeration

origin | via | destination

7.2. The LocationInformationRequestGroup group

- +

LocationInformationRequestGroup

The element contains one of the following elements:

LocationInformationRequest

a

InitialInput

-1:1

+InitialLocationInput

Initial input for the location information request. This input defines what is originally looked for. Be aware that this also can contain PLACEs.

b

PlaceRef

-1:1

+PlaceRef

LOCATION / PLACE for further refinement. If a Place in a previous response was marked as not "complete" it can be refined by putting it here. If Places are organised hierarchically it may be reasonable to identify the Place in a top-down approach with several steps of refining a Place on each level of hierarchy. Following this approach an initial request retrieves a first list of top-level Places (e.g. streets) which are to be refined in a subsequent request to the next level (e.g. house number intervals). The objects of the current level are presented to the user for selection. The object reference of the selected object is then sent in the next request for further refinement.

The element contains one of the following elements:

LocationInformationRequest

a

InitialInput

-1:1

+InitialLocationInput

Initial input for the location information request. This input defines what is originally looked for. Be aware that this also can contain PLACEs.

b

PlaceRef

-1:1

+PlaceRef

LOCATION / PLACE for further refinement. If a Place in a previous response was marked as not "complete" it can be refined by putting it here. If Places are organised hierarchically, it may be reasonable to identify the Place in a top-down approach with several steps of refining a Place on each level of hierarchy. Following this approach an initial request retrieves a first list of top-level Places (e.g., streets) which are to be refined in a subsequent request to the next level (e.g., house number intervals). The objects of the current level are presented to the user for selection. The object reference of the selected object is then sent in the next request for further refinement.

Restrictions

0:1

+PlaceParam

E.g. place types (stops, addresses, POIs) or specific place attributes

7.3. The LocationInformationResponseGroup group

-

LocationInformationResponseGroup

LocationInformationResponse

LocationInformationResponseContext

0:1

+ResponseContext

Context to hold response objects that occur frequently.

ContinueAt

0:1

xs:nonNegativeInteger

If the response returns less results than expected, the value of skip can be used in a follow-up request to get further results. It tells the server to skip the given number of results in its response.

PlaceResult

0:*

+PlaceResult

The place/location objects found by the service are ordered in descending order of how well they match the input data. The first result in the list matches best.

7.4. The complex type InitialLocationInputStructure

InitialLocationInputStructure

The element contains a sequence of the following elements:

Name

0:1

xs:string

Name of the LOCATION object which is looked for. This is usually the user's input. If not given, the name of the resulting location objects is not relevant.

GeoPosition

0:1

siri:LocationStructure

Coordinate where to look for locations/places. If given, the result should prefer locations/place objects near to this GeoPosition.

GeoRestriction

0:1

+GeoRestrictions

Restricts the resulting location/place objects to the given geographical area.

AllowedSystem

0:*

siri:ParticipantRefStructure

Used in distributed environments. e.g. EU-Spirit. If none is given, the location/place information request refers to all known systems (in EU-Spirit "passive servers"). If at least one is given, the location/place information request refers only to the given systems (in EU-Spirit "passive servers"). In EU-Spirit the system IDs were previously called "provider code". See https://eu-spirit.eu/

7.5. The complex type PlaceParamStructure

+

PlaceParamStructure

The element contains a sequence of the following elements:

7.4. The complex type InitialLocationInputStructure

InitialLocationInputStructure

The element contains a sequence of the following elements:

Name

0:1

xs:string

Name of the LOCATION object which is looked for. This is usually the user's input. If not given, the name of the resulting location objects is not relevant.

GeoPosition

0:1

siri:LocationStructure

Coordinate where to look for locations/places. If given, the result should prefer locations/place objects near to this GeoPosition.

GeoRestriction

0:1

+GeoRestrictions

Restricts the resulting location/place objects to the given geographical area.

AllowedSystem

0:*

siri:ParticipantRefStructure

Used in distributed environments. e.g., EU-Spirit. If none is given, the location/place information request refers to all known systems (in EU-Spirit "passive servers"). If at least one is given, the location/place information request refers only to the given systems (in EU-Spirit "passive servers"). In EU-Spirit the system IDs were previously called "provider code". See https://eu-spirit.eu/

7.5. The complex type PlaceParamStructure

@@ -460,16 +460,16 @@

OJP - Open API for distributed Journey

- +

PlaceParamStructure

The element contains a sequence of the following elements:

PlaceDataFilter

Type

0:*

PlaceType

Allowed location/place object types. If none is given, all types are allowed.

Usage

0:1

PlaceUsage

Defines, whether location/place objects for origin, via, or destination are searched.

Modes

0:1

+ModeFilter

Allowed public transport modes. Defines, which public transport modes must be available at the returned location/place objects. Applies only to stops.

IncludePtModes

0:1

xs:boolean

Tells the service to include the available public transport modes at returned stops.

IncludeOperators

0:1

xs:boolean

Tells the service to include the available operators at returned stops.

PlaceSorting

SortingMethod

0:1

xs:string

If there are multiple sorting methods supported by the system, the client can choose one of the existing. Which methods are available needs to be known to the client and may differ from system to system. Therefore use with care.

PlaceSorting

SortingMethod

0:1

xs:string

If there are multiple sorting methods supported by the system, the client can choose one of the existing. Which methods are available needs to be known to the client and may differ from system to system. Therefore, use with care.

GeoPosition

0:1

siri:LocationStructure

WGS84 coordinates position. Locations closer to this GeoPosition are preferred.

MinimalProbability

0:1

xs:float

Ignore locations with a lower probability.

Extension

0:1

xs:anyType

7.6. The complex type GeoRestrictionsStructure

GeoRestrictionsStructure

The element contains one of the following elements:

a

Area

-1:1

+GeoArea

Area defined by a polyline.

b

Circle

-1:1

+GeoCircle

Area defined by a circle.

c

Rectangle

-1:1

+GeoRectangle

Area defined by a rectangle.

7.7. The complex type GeoCircleStructure

GeoCircleStructure

The element contains a sequence of the following elements:

Center

1:1

siri:LocationStructure

Centre position of the circle.

Radius

1:1

siri:DistanceType

Radius in metres.

7.8. The complex type GeoRectangleStructure

GeoRectangleStructure

The element contains a sequence of the following elements:

UpperLeft

1:1

siri:LocationStructure

Upper-left (north-west) corner of the rectangle.

LowerRight

1:1

siri:LocationStructure

Lower-right (south-east) corner of the rectangle.

7.9. The complex type GeoAreaStructure

GeoAreaStructure

[specialisation of ZONE in TMv6] a LINK SEQUENCE (one-dimensional) forming the boundary of a ZONE -

The element contains only one element:

PolylinePoint

3:*

siri:LocationStructure

Vertices of a polyline defining an area.

7.10. The complex type PlaceResultStructure

+

PlaceResultStructure

The element contains a sequence of the following elements:

ErrorCondition

0:*

+OJPError

Problems related to this LOCATION result.

Place

1:1

+Place

The Place / Location object.

Complete

1:1

xs:boolean

States whether the included location/place is complete or needs further refinement. Only complete locations/places are fully resolved and can be used in e.g. trip requests. Incomplete locations/places have to be refined entering them once again into a LocationInformationRequest.

Probability

0:1

Probability, that this result is the one meant by the user's input. Value should be between 0 and 1.

The element contains only one element:

PolylinePoint

3:*

siri:LocationStructure

Vertices of a polyline defining an area.

7.10. The complex type PlaceResultStructure

-

PlaceResultStructure

The element contains a sequence of the following elements:

ErrorCondition

0:*

+OJPError

Problems related to this LOCATION result.

Place

1:1

+Place

The Place / Location object.

Complete

1:1

xs:boolean

States whether the included location/place is complete or needs further refinement. Only complete locations/places are fully resolved and can be used in e.g., trip requests. Incomplete locations/places must be refined entering them once again into a LocationInformationRequest.

Probability

0:1

Probability, that this result is the one meant by the user's input. Value should be between 0 and 1.

System

0:1

siri:ParticipantRefStructure

Stores the system reference, where to ask for actual locations corresponding to this city name result. In order to get actual locations, a new location information request using the system ID of this result is needed.

Operators

0:1

+OperatorRefs_Rel

List of operators operating at this place object. This list should only be filled if this is explicitly requested.

7.11. The PlacePolicyGroup group

+

PlacePolicyGroup

System

0:1

siri:ParticipantRefStructure

Stores the system reference, where to ask for actual locations corresponding to this city name result. To get actual locations, a new location information request using the system ID of this result is needed.

Operators

0:1

+OperatorRefs_Rel

List of operators operating at this place object. This list should only be filled if this is explicitly requested.

7.11. The PlacePolicyGroup group

@@ -483,7 +483,7 @@

OJP - Open API for distributed Journey

PlacePolicyGroup

PlacePolicy

Language

0:*

xs:language

Preferred language in which to return text values.

NumberOfResults

0:1

xs:positiveInteger

Maximum number of results to be returned. The service is allowed to return fewer objects if reasonable or otherwise appropriate. If the number of matching objects is expected to be large (e.g.: in the case that all objects should be delivered) this parameter can be used to partition the response delivery into smaller chunks. The place information service is expected to support a response volume of at least 500 objects within one single response.

ContinueAt

0:1

xs:nonNegativeInteger

Tells the server to skip the mentioned number of results in its response. Can be used in a follow-up request to get further results. The value is usually taken from the previous response.

TopographicPlaceRef

0:*

+TopographicPlaceRef

If at least one is set, only location/place objects within the given localities are allowed.

PointOfInterestFilter

0:1

+PointOfInterestFilter

Filter to narrow down POI searches.

7.13. The PlaceSortingGroup group

- +

PlaceSortingGroup

PlaceSorting

SortingMethod

0:1

xs:string

If there are multiple sorting methods supported by the system, the client can choose one of the existing. Which methods are available needs to be known to the client and may differ from system to system. Therefore use with care.

PlaceSorting

SortingMethod

0:1

xs:string

If there are multiple sorting methods supported by the system, the client can choose one of the existing. Which methods are available needs to be known to the client and may differ from system to system. Therefore, use with care.

GeoPosition

0:1

siri:LocationStructure

WGS84 coordinates position. Locations closer to this GeoPosition are preferred.

MinimalProbability

0:1

xs:float

Ignore locations with a lower probability.

7.14. The ExchangePointsRequestGroup group

@@ -499,7 +499,7 @@

OJP - Open API for distributed Journey

- +

ExchangePointsRequestGroup

AdjacentSystem

0:*

siri:ParticipantRefStructure

One or more adjacent systems to which the exchange points should be retrieved.

ExchangePointsPolicy

Language

0:*

xs:language

Preferred language in which to return text values.

NumberOfResults

0:1

xs:positiveInteger

Maximum number of results to be returned. The service is allowed to return fewer objects if reasonable or otherwise appropriate. If the number of matching objects is expected to be large (e.g. in the case that all objects should be delivered) this parameter can be used to partition the response delivery into smaller chunks. The location information service is expected to support a response volume of at least 500 location objects within one single response.

NumberOfResults

0:1

xs:positiveInteger

Maximum number of results to be returned. The service is allowed to return fewer objects if reasonable or otherwise appropriate. If the number of matching objects is expected to be large (e.g., in the case that all objects should be delivered) this parameter can be used to partition the response delivery into smaller chunks. The location information service is expected to support a response volume of at least 500 location objects within one single response.

ContinueAt

0:1

xs:nonNegativeInteger

Tells the server to skip the mentioned number of results in its response. Can be used in a follow-up request to get further results. The value is usually taken from the previous response.

Extension

0:1

xs:anyType

7.16. The ExchangePointsDataFilterGroup group

@@ -511,25 +511,25 @@

OJP - Open API for distributed Journey

ExchangePointsDataFilterGroup

ExchangePointsDataFilter

Type

0:*

PlaceType

Allowed location/place object types. If none is given, all types are allowed.

AdjacentSystem

0:*

siri:ParticipantRefStructure

One or more adjacent systems to which the exchange points should be retrieved.

7.17. The ExchangePointsPolicyGroup group

- +

ExchangePointsPolicyGroup

ExchangePointsPolicy

Language

0:*

xs:language

Preferred language in which to return text values.

NumberOfResults

0:1

xs:positiveInteger

Maximum number of results to be returned. The service is allowed to return fewer objects if reasonable or otherwise appropriate. If the number of matching objects is expected to be large (e.g. in the case that all objects should be delivered) this parameter can be used to partition the response delivery into smaller chunks. The location information service is expected to support a response volume of at least 500 location objects within one single response.

NumberOfResults

0:1

xs:positiveInteger

Maximum number of results to be returned. The service is allowed to return fewer objects if reasonable or otherwise appropriate. If the number of matching objects is expected to be large (e.g., in the case that all objects should be delivered) this parameter can be used to partition the response delivery into smaller chunks. The location information service is expected to support a response volume of at least 500 location objects within one single response.

ContinueAt

0:1

xs:nonNegativeInteger

Tells the server to skip the mentioned number of results in its response. Can be used in a follow-up request to get further results. The value is usually taken from the previous response.

7.18. The ExchangePointsResponseGroup group

-

ExchangePointsResponseGroup

ExchangePointsResponse

ExchangePointsResponseContext

0:1

+ResponseContext

Context to hold trip response objects that occur frequently.

ContinueAt

0:1

xs:nonNegativeInteger

If the response returns less results than expected, the value of skip can be used in a follow-up request to get further results. It tells the server to skip the given number of results in its response.

ExchangePointsResult

0:*

+ExchangePointsResult

The exchange points found by the service.

7.19. The complex type ExchangePointsResultStructure

ExchangePointsResultStructure

The element contains a sequence of the following elements:

ErrorCondition

0:*

+OJPError

Problems related to this EXCHANGE POINTS result.

Place

1:1

+Place

Place object that describes this exchange point.

TravelDurationEstimate

0:1

xs:duration

Rough estimate of the travel duration from the specified reference location/place to this exchange point.

WaitDuration

0:1

xs:duration

Duration needed at this exchange point to change from one service to another. If a journey planning orchestrator puts together a trip at this exchange point, it has to take care, that feeding arrival and fetching departure are at least this duration apart.

BorderPoint

0:1

xs:boolean

Flag if this exchange point is an administrative border point where timetables are cut off while services still may run through and connect the regions. At this kind of points passengers may continue their journey within the same service. Default is FALSE.

Mode

0:*

+Mode

List of transport modes that call at this place object. This list should only be filled in case of stop points or stop places – and only when explicitly requested.

Priority

0:1

Percent

The priority of the exchange point. 100 is the maximum. The priority can be used to select given ExchangePoints more often (e.g. because the station is a main hub).

+

7.19. The complex type ExchangePointsResultStructure

ExchangePointsResultStructure

The element contains a sequence of the following elements:

ErrorCondition

0:*

+OJPError

Problems related to this EXCHANGE POINTS result.

Place

1:1

+Place

Place object that describes this exchange point.

TravelDurationEstimate

0:1

xs:duration

Rough estimate of the travel duration from the specified reference location/place to this exchange point.

WaitDuration

0:1

xs:duration

Duration needed at this exchange point to change from one service to another. If a journey planning orchestrator puts together a trip at this exchange point, it must take care, that feeding arrival and fetching departure are at least this duration apart.

BorderPoint

0:1

xs:boolean

Flag if this exchange point is an administrative border point where timetables are cut off while services still may run through and connect the regions. At this kind of points passengers may continue their journey within the same service. Default is FALSE.

Mode

0:*

+Mode

List of transport modes that call at this place object. This list should only be filled in case of stop points or stop places – and only when explicitly requested.

Priority

0:1

Percent

The priority of the exchange point. 100 is the maximum. The priority can be used to select given ExchangePoints more often (e.g., because the station is a main hub).

8. OJP/OJP_PlaceSupport.xsd - Supporting definitions for location information

8.1. Simple type definitions

AddressCodeType

xs:normalizedString

Identifier of an Address

ExchangePointsProblemTypeEnumeration

EXCHANGEPOINTS_NORESULTS | EXCHANGEPOINTS_UNKNOWNDESTINATIONSYSTEM | EXCHANGEPOINTS_UNKNOWNADJACENTSYSTEM | EXCHANGEPOINTS_OTHER

Types of problems that may be returned in responses to EXCHANGE POINTS requests

LocationProblemTypeEnumeration

LOCATION_NORESULTS | LOCATION_UNSUPPORTEDTYPE | LOCATION_UNSUPPORTEDCOMBINATION | LOCATION_NOREFINEMENT | LOCATION_USAGEIGNORED | LOCATION_UNSUPPORTEDPTMODES | LOCATION_UNSUPPORTEDLOCALITY | LOCATION_UNSUPPORTEDSORTINGMETHOD | LOCATION_OTHER

Types of problems that may be returned in responses to LOCATION requests.

PlaceObjectIdType

ObjectIdType

Type for identifier of a NeTEx Object.

PointOfInterestCodeType

xs:normalizedString

Identifier of a Point of Interest

StopPlaceCodeType

xs:normalizedString

Identifier of a Stop Place

TopographicPlaceCodeType

xs:normalizedString

Identifier of a TopographicPlace

8.2. The StopPointGroup group

- +

StopPointGroup

A stop point with id and name

StopPoint

→‍siri:StopPointRef

1:1

→‍siri:StopPointRef

Reference to a stop point.

StopPointName

1:1

+InternationalText

Name or description of stop point for use in passenger information.

NameSuffix

0:1

+InternationalText

Additional description of the stop point that may be appended to the name if enough space is available. E.g. "opposite main entrance".

PlannedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. According to planned timetable.

EstimatedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. As to the latest realtime status.

EstimatedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. As to the latest real-time status.

8.3. The complex type StopPointStructure

- + @@ -550,7 +550,7 @@

OJP - Open API for distributed Journey

-

StopPointStructure

[an extended view of SCHEDULED STOP POINT in TMv6] a SCHEDULED STOP POINT extended by ACCESSIBILITY LIMITATION attributes and with identifier and name where passengers can board or alight from vehicles

The element contains a sequence of the following elements:

StopPoint

→‍siri:StopPointRef

1:1

→‍siri:StopPointRef

Reference to a stop point.

StopPointName

1:1

+InternationalText

Name or description of stop point for use in passenger information.

NameSuffix

0:1

+InternationalText

Additional description of the stop point that may be appended to the name if enough space is available. E.g. "opposite main entrance".

PlannedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. According to planned timetable.

EstimatedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. As to the latest realtime status.

EstimatedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. As to the latest real-time status.

PrivateCode

0:*

+PrivateCode

Code of this stop point in private/foreign/proprietary coding schemes.

ParentRef

0:1

+StopPlaceRef

Reference to the stop place to which this stop point belongs.

→‍TopographicPlaceRef

0:1

→‍TopographicPlaceRef

If at least one is set, only location/place objects within the given localities are allowed.If at least one is set, only location/place objects within the given localities are allowed.Reference to a TopographicPlace

StopAttributes

WheelchairAccessible

0:1

xs:boolean

Whether this stop is accessible for wheelchair users.

Lighting

0:1

xs:boolean

Whether this stop is lit.

StopAttributes

WheelchairAccessible

0:1

xs:boolean

Whether this stop is accessible for wheelchair users.

Lighting

0:1

xs:boolean

Whether this stop is lit.

Covered

0:1

xs:boolean

Whether this stop offers protection from weather conditions like rain, snow, storm etc.

8.10. The complex type TopographicPlaceRefStructure

TopographicPlaceRefStructure

Reference to a TopographicPlace

8.11. The toplevel element TopographicPlaceRef

TopographicPlaceRef

+TopographicPlaceRef

Reference to a TopographicPlace

8.12. The complex type TopographicPlaceStructure

TopographicPlaceStructure

[TMv6] A type of PLACE providing the topographical context when searching for or presenting travel information, for example as the origin or destination of a trip. It may be of any size (e.g. County,City, Town, Village) and of different specificity (e.g. Greater London, London, West End, Westminster, St James's).

The element contains a sequence of the following elements:

TopographicPlaceCode

1:1

TopographicPlace ID.

TopographicPlaceName

1:1

+InternationalText

Name or description of TopographicPlace for use in passenger information.

PrivateCode

0:*

+PrivateCode

Code of this TopographicPlace in private/foreign/proprietary coding schemes.

ParentRef

0:1

+TopographicPlaceRef

Reference to a parent TopographicPlace.

ReferredSystem

0:1

siri:ParticipantRefStructure

Used in distributed environments (e.g. EU-Spirit). If set, this topographic place resides within the given system (in EU-Spirit "passive server"). This system can be queried for actual places within this topographic place. This is used in an distributed environment for a two-steps place identification. In EU-Spirit the system IDs were previously called "provider code". See https://eu-spirit.eu/

Area

0:1

+Area

Area covered by the locality described as a polygon.

8.13. The complex type PointOfInterestRefStructure

PointOfInterestRefStructure

PointOfInterestCode

Reference to a Point of Interest

8.14. The toplevel element PointOfInterestRef

PointOfInterestRef

+PointOfInterestRef

Reference to a Point of Interest

8.15. The complex type PointOfInterestStructure

PointOfInterestStructure

[corresponds to POINT OF INTEREST in TMv6 with related information] type of PLACE to or through which passengers may wish to navigate as part of their journey and which is modelled in detail by journey planners.

The element contains a sequence of the following elements:

PublicCode

1:1

PointOfInterestCode

ID of this Point of Interest.

Name

1:1

+InternationalText

Name or description of point of interest for use in passenger information.

NameSuffix

0:1

+InternationalText

Additional description of the point of interest that may be appended to the name if enough space is available. E.g. "Exhibition Center".

PointOfInterestCategory

0:*

+PointOfInterestCategory

Categories this POI is associated with. Order indicates descending relevance.

PrivateCode

0:*

+PrivateCode

Code of this point of interest in private/foreign/proprietary coding schemes.

→‍TopographicPlaceRef

0:1

→‍TopographicPlaceRef

If at least one is set, only location/place objects within the given localities are allowed.If at least one is set, only location/place objects within the given localities are allowed.Reference to a TopographicPlace

POIAdditionalInformation

0:1

+PointOfInterestAdditionalInformation

Additional information for this POI (e.g. information on available parking slots, charging infrastructure, sharing vehicles).

8.16. The complex type PointOfInterestCategoryStructure

PointOfInterestCategoryStructure

[a view of POINT OF INTEREST CLASSIFICATION in TMv6] categorisation of POINTs OF INTEREST in respect of the activities undertaken at them (defined by key-value-pairs).

The element contains one of the following elements:

a

OsmTag

-1:*

+OsmTag

OpenStreetMap tag structure (key-value)

b

PointOfInterestClassification

-1:*

xs:string

Classification of the POI (when it is not from OSM). The codification of the classification Id may include de codification source (for example "IGN:[classificationCode]")

8.17. The complex type PointOfInterestAdditionalInformationStructure

PointOfInterestAdditionalInformationStructure

Generic structure for additional information on POIs.

The element contains only one element:

POIAdditionalInformation

1:*

+CategoryKeyValue

POI additional information is a set of key/value pairs that are associated with defined categories.

8.18. The complex type CategoryKeyValueType

CategoryKeyValueType

Category Key Value triplets. Category can be empty. Several such elements form the information necessary for a given category.

The element contains a sequence of the following elements:

Category

0:1

xs:string

Key

1:1

xs:string

Value

1:1

xs:string

8.19. The complex type OsmTagStructure

OsmTagStructure

Structure of an OpenStreetMap tag.

The element contains a sequence of the following elements:

Tag

1:1

xs:NMTOKEN

Name of OpenStreetMap tag (amenity, leisure, tourism, bike, ...)

Value

1:1

xs:NMTOKEN

Value for OpenStreetMap tag (charging_station, hostel, yes, ...)

8.20. The complex type PointOfInterestFilterStructure

PointOfInterestFilterStructure

Filter POIs by category.

The element contains a sequence of the following elements:

Exclude

0:1

xs:boolean

Whether categories in list are to include or exclude from search. Default is FALSE.

PointOfInterestCategory

0:*

+PointOfInterestCategory

These POI categories can be used to filter POIs. If more than one is given the filtering is by logical "OR" (when Exclude=FALSE) and logical "AND" (when Exclude=TRUE).

8.21. The complex type AddressRefStructure

AddressRefStructure

AddressCode

Reference to an Address

8.22. The toplevel element AddressRef

AddressRef

+AddressRef

Reference to an Address

8.23. The AddressDetailGroup group

+

AddressDetailGroup

An address with its name entities

8.10. The complex type TopographicPlaceRefStructure

TopographicPlaceRefStructure

Reference to a TopographicPlace

8.11. The toplevel element TopographicPlaceRef

TopographicPlaceRef

+TopographicPlaceRef

Reference to a TopographicPlace

8.12. The complex type TopographicPlaceStructure

TopographicPlaceStructure

[TMv6] A type of PLACE providing the topographical context when searching for or presenting travel information, for example as the origin or destination of a trip. It may be of any size (e.g., County,City, Town, Village) and of different specificity (e.g., Greater London, London, West End, Westminster, St James's).

The element contains a sequence of the following elements:

TopographicPlaceCode

1:1

TopographicPlace ID.

TopographicPlaceName

1:1

+InternationalText

Name or description of TopographicPlace for use in passenger information.

PrivateCode

0:*

+PrivateCode

Code of this TopographicPlace in private/foreign/proprietary coding schemes.

ParentRef

0:1

+TopographicPlaceRef

Reference to a parent TopographicPlace.

ReferredSystem

0:1

siri:ParticipantRefStructure

Used in distributed environments (e.g., EU-Spirit). If set, this topographic place resides within the given system (in EU-Spirit "passive server"). This system can be queried for actual places within this topographic place. This is used in a distributed environment for a two-steps place identification. In EU-Spirit the system IDs were previously called "provider code". See https://eu-spirit.eu/

Area

0:1

+Area

Area covered by the locality described as a polygon.

8.13. The complex type PointOfInterestRefStructure

PointOfInterestRefStructure

PointOfInterestCode

Reference to a Point of Interest

8.14. The toplevel element PointOfInterestRef

PointOfInterestRef

+PointOfInterestRef

Reference to a Point of Interest

8.15. The complex type PointOfInterestStructure

PointOfInterestStructure

[corresponds to POINT OF INTEREST in TMv6 with related information] type of PLACE to or through which passengers may wish to navigate as part of their journey and which is modelled in detail by journey planners.

The element contains a sequence of the following elements:

PublicCode

1:1

PointOfInterestCode

ID of this Point of Interest.

Name

1:1

+InternationalText

Name or description of point of interest for use in passenger information.

NameSuffix

0:1

+InternationalText

Additional description of the point of interest that may be appended to the name if enough space is available. E.g. "Exhibition Center".

PointOfInterestCategory

0:*

+PointOfInterestCategory

Categories this POI is associated with. Order indicates descending relevance.

PrivateCode

0:*

+PrivateCode

Code of this point of interest in private/foreign/proprietary coding schemes.

→‍TopographicPlaceRef

0:1

→‍TopographicPlaceRef

If at least one is set, only location/place objects within the given localities are allowed.If at least one is set, only location/place objects within the given localities are allowed.Reference to a TopographicPlace

POIAdditionalInformation

0:1

+PointOfInterestAdditionalInformation

Additional information for this POI (e.g., information on available parking slots, charging infrastructure, sharing vehicles).

8.16. The complex type PointOfInterestCategoryStructure

PointOfInterestCategoryStructure

[a view of POINT OF INTEREST CLASSIFICATION in TMv6] categorisation of POINTs OF INTEREST in respect of the activities undertaken at them (defined by key-value-pairs).

The element contains one of the following elements:

a

OsmTag

-1:*

+OsmTag

OpenStreetMap tag structure (key-value)

b

PointOfInterestClassification

-1:*

xs:string

Classification of the POI (when it is not from OSM). The codification of the classification Id may include de codification source (for example "IGN:[classificationCode]")

8.17. The complex type PointOfInterestAdditionalInformationStructure

PointOfInterestAdditionalInformationStructure

Generic structure for additional information on POIs.

The element contains only one element:

POIAdditionalInformation

1:*

+CategoryKeyValue

POI additional information is a set of key/value pairs that are associated with defined categories.

8.18. The complex type CategoryKeyValueType

CategoryKeyValueType

Category Key Value triplets. Category can be empty. Several such elements form the information necessary for a given category.

The element contains a sequence of the following elements:

Category

0:1

xs:string

Key

1:1

xs:string

Value

1:1

xs:string

8.19. The complex type OsmTagStructure

OsmTagStructure

Structure of an OpenStreetMap tag.

The element contains a sequence of the following elements:

Tag

1:1

xs:NMTOKEN

Name of OpenStreetMap tag (amenity, leisure, tourism, bike, ...)

Value

1:1

xs:NMTOKEN

Value for OpenStreetMap tag (charging_station, hostel, yes, ...)

8.20. The complex type PointOfInterestFilterStructure

PointOfInterestFilterStructure

Filter POIs by category.

The element contains a sequence of the following elements:

Exclude

0:1

xs:boolean

Whether categories in list are to include or exclude from search. Default is FALSE.

PointOfInterestCategory

0:*

+PointOfInterestCategory

These POI categories can be used to filter POIs. If more than one is given the filtering is by logical "OR" (when Exclude=FALSE) and logical "AND" (when Exclude=TRUE).

8.21. The complex type AddressRefStructure

AddressRefStructure

AddressCode

Reference to an Address

8.22. The toplevel element AddressRef

AddressRef

+AddressRef

Reference to an Address

8.23. The AddressDetailGroup group

@@ -566,20 +566,20 @@

OJP - Open API for distributed Journey

-

AddressDetailGroup

An address with its name entities

AddressDetail

CountryName

0:1

xs:string

Country of the address.

PostCode

0:1

xs:string

Postal code of the address.

TopographicPlaceName

0:1

xs:string

TopographicPlace name of the address. If set it should at least contain the city name.

Street

0:1

xs:string

Street name of the address.

HouseNumber

0:1

xs:string

House number of the address. If none is given, either a crossing street can be given, or the whole street is meant.

CrossRoad

0:1

xs:string

Crossing. This can be used to be more specific without using house numbers.

8.25. The complex type PlaceStructure

PlaceStructure

geographic PLACE of any type which may be specified as the origin or destination of a trip

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

a

Address

-1:1

+Address

Model of an address

b

PointOfInterest

-1:1

+PointOfInterest

Model of a POI

c

StopPlace

-1:1

+StopPlace

Model of a stop place

d

StopPoint

-1:1

+StopPoint

Model of a stop point

e

TopographicPlace

-1:1

+TopographicPlace

TopographicPlace. Region, village, or city.

Name

1:1

+InternationalText

Public name of the place.

GeoPosition

1:1

siri:LocationStructure

Position using WGS84/EPSG:4326 coordinates.

Mode

0:*

+Mode

List of transport modes that call at this place object. This list should only be filled in case of stop points or stop places – and only when explicitly requested.

AccessModeList

0:1

+AccessModesListOf

Access modes that are supported by this place.

SituationFullRefs

0:1

+SituationRefList

SITUATION reference. Mostly used for STOP PLACE, SCHEDULED STOP POINT (StopPoint). However, in future a situation reference may occur on many geographic elements (e.g. roads) as well.

Attribute

0:*

+GeneralAttribute

Attributes associated with this place. This is used, e.g., for details, OSM attributes oder key/value descriptions. Most of them will be implementation dependend (except OSM). From Transmodel, TYPE OF POINT might be a possible attribute.

Extension

0:1

xs:anyType

8.26. The complex type PlaceRefStructure

+

PlaceRefStructure

Reference to a geographic PLACE of any type which may be specified as the origin or destination of a trip.

The element contains only one element:

8.25. The complex type PlaceStructure

PlaceStructure

geographic PLACE of any type which may be specified as the origin or destination of a trip

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

a

Address

-1:1

+Address

Model of an address

b

PointOfInterest

-1:1

+PointOfInterest

Model of a POI

c

StopPlace

-1:1

+StopPlace

Model of a stop place

d

StopPoint

-1:1

+StopPoint

Model of a stop point

e

TopographicPlace

-1:1

+TopographicPlace

TopographicPlace. Region, village, or city.

Name

1:1

+InternationalText

Public name of the place.

GeoPosition

1:1

siri:LocationStructure

Position using WGS84/EPSG:4326 coordinates.

Mode

0:*

+Mode

List of transport modes that call at this place object. This list should only be filled in case of stop points or stop places – and only when explicitly requested.

AccessModeList

0:1

+AccessModesListOf

Access modes that are supported by this place.

SituationFullRefs

0:1

+SituationRefList

SITUATION reference. Mostly used for STOP PLACE, SCHEDULED STOP POINT (StopPoint). However, in future a situation reference may occur on many geographic elements (e.g., roads) as well.

Attribute

0:*

+GeneralAttribute

Attributes associated with this place. This is used, e.g., for details, OSM attributes or key/value descriptions. Most of them will be implementation dependent (except OSM). From Transmodel, TYPE OF POINT might be an attribute.

Extension

0:1

xs:anyType

8.26. The complex type PlaceRefStructure

- +

PlaceRefStructure

Reference to a geographic PLACE of any type which may be specified as the origin or destination of a trip.

The element contains only one element:

Then, the element contains one of the following elements:

PlaceRef

a

→‍siri:StopPointRef

-1:1

→‍siri:StopPointRef

Reference to a stop point.

b

→‍StopPlaceRef

-1:1

→‍StopPlaceRef

Reference to a Stop Place

c

→‍TopographicPlaceRef

-1:1

→‍TopographicPlaceRef

If at least one is set, only location/place objects within the given localities are allowed.If at least one is set, only location/place objects within the given localities are allowed.Reference to a TopographicPlace

d

→‍PointOfInterestRef

-1:1

→‍PointOfInterestRef

Reference to a Point of Interest

e

→‍AddressRef

-1:1

→‍AddressRef

Reference to an Address

f

GeoPosition

-1:1

siri:LocationStructure

WGS84 coordinates position.

Name

1:1

+InternationalText

Public name of the place.

AllowedSystemId

0:*

xs:normalizedString

Used in distributed environments. e.g. EU-Spirit. If none is given, the place information request refers to all known systems (in EU-Spirit "passive servers"). If at least one is given, the place information request refers only to the given systems (in EU-Spirit "passive servers"). In EU-Spirit the system IDs were previously called "provider code". See https://eu-spirit.eu/

AllowedSystemId

0:*

xs:normalizedString

Used in distributed environments. e.g., EU-Spirit. If none is given, the place information request refers to all known systems (in EU-Spirit "passive servers"). If at least one is given, the place information request refers only to the given systems (in EU-Spirit "passive servers"). In EU-Spirit the system IDs were previously called "provider code". See https://eu-spirit.eu/

8.27. The PlaceRefGroup group

- +

PlaceRefGroup

Group for reference to a geographic PLACE of any type which may be specified as the origin or destination of a trip.

The element contains one of the following elements:

PlaceRef

a

→‍siri:StopPointRef

-1:1

→‍siri:StopPointRef

Reference to a stop point.

b

→‍StopPlaceRef

-1:1

→‍StopPlaceRef

Reference to a Stop Place

c

→‍TopographicPlaceRef

-1:1

→‍TopographicPlaceRef

If at least one is set, only location/place objects within the given localities are allowed.If at least one is set, only location/place objects within the given localities are allowed.Reference to a TopographicPlace

d

→‍PointOfInterestRef

-1:1

→‍PointOfInterestRef

Reference to a Point of Interest

e

→‍AddressRef

-1:1

→‍AddressRef

Reference to an Address

f

GeoPosition

-1:1

siri:LocationStructure

WGS84 coordinates position.

Name

1:1

+InternationalText

Public name of the place.

AllowedSystemId

0:*

xs:normalizedString

Used in distributed environments. e.g. EU-Spirit. If none is given, the place information request refers to all known systems (in EU-Spirit "passive servers"). If at least one is given, the place information request refers only to the given systems (in EU-Spirit "passive servers"). In EU-Spirit the system IDs were previously called "provider code". See https://eu-spirit.eu/

AllowedSystemId

0:*

xs:normalizedString

Used in distributed environments. e.g., EU-Spirit. If none is given, the place information request refers to all known systems (in EU-Spirit "passive servers"). If at least one is given, the place information request refers only to the given systems (in EU-Spirit "passive servers"). In EU-Spirit the system IDs were previously called "provider code". See https://eu-spirit.eu/

8.28. The toplevel element LocationProblemType

LocationProblemType

LocationProblemType (↔ ErrorType)

8.29. The toplevel element ExchangePointsProblemType

ExchangePointsProblemType

ExchangePointsProblemType (↔ ErrorType)

9. OJP/OJP_StopEvents.xsd - Request and response definitions for arrivals and departures of public transport services at stops

9.1. Simple type definitions

- +

HierarchyEnumeration

local | no | down | all

Indicates for which parts of the hierarchy of the StopPlace(s) stop events should be provided (if known by the server). "local" (default) is the local server setting. "no" will include no hierarchy and only provide the given StopPlace / StopPoint. "down" will include all lower StopPoints/StopPlaces in the hierarchy, if - such a hierarchy exists. "all" does include all StopPoints/StopPlaces for the meta station, if it is known. How + such a hierarchy exists. "all" does include all StopPoints/StopPlaces for the meta station if it is known. How to use this: if you indicate the reference to a train station and the parameter is set to "down", the departures/ arrivals at the associated bus stations will show as well. If you have the ScheduledStopPoint of platform B of the local bus and it is associated with 3 other stations, you will get all these arrivals/departures as well, @@ -602,15 +602,15 @@

OJP - Open API for distributed Journey

IncludeOperatingDays

0:1

xs:boolean

Whether operating day information of this stop event should be included in the response.

UseRealtimeData

0:1

UseRealtimeData

Whether real-time information of this stop event should be used in the response. Default is "full"

IncludePlacesContext

0:1

xs:boolean

Whether the place context is needed. If a requestor has that information already, the response can be made slimmer, when set to false. Default is true.

IncludeSituationsContext

0:1

xs:boolean

Wheter the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true

IncludeSituationsContext

0:1

xs:boolean

Whether the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true

IncludeStopHierarchy

0:1

Hierarchy

Indicates for which parts of the hierarchy of the StopPlace(s) stop events should be provided (if known by the server). "local" (default) is the local server setting. "no" will include no hierarchy and only provide the given StopPlace / StopPoint. "down" will include all lower StopPoints/ StopPlaces in the hierarchy, if such a hierarchy exists. "all" does include all StopPoints/StopPlaces - for the meta station, if it is known. How to use this: if you indicate the reference to a train station + for the meta station if it is known. How to use this: if you indicate the reference to a train station and the parameter is set to "down", the departures/arrivals at the associated bus stations will show as well. If you have the ScheduledStopPoint of platform B of the local bus and it is associated with 3 other - stations, you will get all these arrivals/departures as well, if the parameter is set to "all". + stations, you will get all these arrivals/departures as well if the parameter is set to "all".

Extension

0:1

xs:anyType

9.4. The StopEventDataFilterGroup group

@@ -627,23 +627,23 @@

OJP - Open API for distributed Journey

- +

StopEventDataFilterGroup

Request data filters

StopEventDataFilter

ModeFilter

0:1

+ModeFilter

MODEs to be excluded or included in stop events. We on purpose don't use ModeOfOperationFilter in the stop event service.

IncludeOperatingDays

0:1

xs:boolean

Whether operating day information of this stop event should be included in the response.

UseRealtimeData

0:1

UseRealtimeData

Whether real-time information of this stop event should be used in the response. Default is "full"

IncludePlacesContext

0:1

xs:boolean

Whether the place context is needed. If a requestor has that information already, the response can be made slimmer, when set to false. Default is true.

IncludeSituationsContext

0:1

xs:boolean

Wheter the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true

IncludeSituationsContext

0:1

xs:boolean

Whether the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true

IncludeStopHierarchy

0:1

Hierarchy

Indicates for which parts of the hierarchy of the StopPlace(s) stop events should be provided (if known by the server). "local" (default) is the local server setting. "no" will include no hierarchy and only provide the given StopPlace / StopPoint. "down" will include all lower StopPoints/ StopPlaces in the hierarchy, if such a hierarchy exists. "all" does include all StopPoints/StopPlaces - for the meta station, if it is known. How to use this: if you indicate the reference to a train station + for the meta station if it is known. How to use this: if you indicate the reference to a train station and the parameter is set to "down", the departures/arrivals at the associated bus stations will show as well. If you have the ScheduledStopPoint of platform B of the local bus and it is associated with 3 other - stations, you will get all these arrivals/departures as well, if the parameter is set to "all". + stations, you will get all these arrivals/departures as well if the parameter is set to "all".

9.7. The StopEventResponseGroup group

StopEventResponseGroup

Response structure for departure and arrival events at stops

StopEventResponse

StopEventResponseContext

0:1

+ResponseContext

Container for data that is referenced multiple times.

StopEventResult

0:*

+StopEventResult

Enclosing element for stop event data.

9.8. The complex type StopEventResultStructure

StopEventResultStructure

Wrapper element for a single stop event result.

The element contains a sequence of the following elements:

Id

1:1

StopEventResultObjectId

ID of this result.

ErrorCondition

0:*

+OJPError

Problems related to this STOPEVENT result.

StopEvent

1:1

+StopEvent

Stop event data element.

9.9. The complex type StopEventStructure

- -

StopEventStructure

Stop event structure.

The element contains a sequence of the following elements:

PreviousCall

0:*

+CallAtNearStop

Calls at stops that happen before this stop event (service pattern of this vehicle journey before this stop event).

ThisCall

1:1

+CallAtNearStop

The call of this vehicle journey at this stop.

OnwardCall

0:*

+CallAtNearStop

Calls at stops that happen after this stop event (rest of the service pattern of the vehicle journey).

Service

1:1

+DatedJourney

Service that calls at this stop.

OperatingDays

OperatingDays

0:1

+OperatingDays

Bit string definition of operating days.

OperatingDaysDescription

0:1

+InternationalText

Textual description of the operation days, e.g. "monday to friday" or "not on holidays".

SituationFullRefs

0:1

+SituationRefList

For SITUATIONs that affect the whole StopEvent. Otherwise References for SITUATIONs can be added at the different CALL elements

Extension

0:1

xs:anyType

9.10. The complex type CallAtNearStopStructure

CallAtNearStopStructure

indication of the walk distance and time to a nearby stop where relevant.

The element contains a sequence of the following elements:

CallAtStop

1:1

+CallAtStop

[same as CALL in SIRI] the meeting of a VEHICLE JOURNEY with a specific SCHEDULED STOP POINT .

WalkDistance

0:1

siri:DistanceType

Distance from request LOCATION / PLACE (e.g. address) to this stop in metres.

WalkDuration

0:1

xs:duration

Walking duration from request LOCATION / PLACE (e.g. address) to this stop. All user options taken into account (e.g. walk speed).

9.11. The toplevel element StopEventProblemType

StopEventProblemType

StopEventProblemType (↔ ErrorType)

+

OperatingDaysDescription

0:1

+InternationalText

Textual description of the operation days, e.g., "Monday to Friday" or "not on holidays".

+

SituationFullRefs

0:1

+SituationRefList

For SITUATIONs that affect the whole StopEvent. Otherwise References for SITUATIONs can be added at the different CALL elements

Extension

0:1

xs:anyType

9.10. The complex type CallAtNearStopStructure

CallAtNearStopStructure

indication of the walk distance and time to a nearby stop where relevant.

The element contains a sequence of the following elements:

CallAtStop

1:1

+CallAtStop

[same as CALL in SIRI] the meeting of a VEHICLE JOURNEY with a specific SCHEDULED STOP POINT.

WalkDistance

0:1

siri:DistanceType

Distance from request LOCATION / PLACE (e.g., address) to this stop in metres.

WalkDuration

0:1

xs:duration

Walking duration from request LOCATION / PLACE (e.g., address) to this stop. All user options considered (e.g., walk speed).

9.11. The toplevel element StopEventProblemType

StopEventProblemType

StopEventProblemType (↔ ErrorType)

10. OJP/OJP_TripInfo.xsd - Request and response definitions for information on a single trip

10.1. Simple type definitions

IncludeFormationEnumeration

none | vehiclefeature | full

Possible values how to include formations in the basic filters

TripInfoProblemTypeEnumeration

TRIPINFO_JOURNEYREFUNKNOWN | TRIPINFO_VEHICLEUNKNOWN | TRIPINFO_NOJOURNEYFOUND | TRIPINFO_NOGEOINFO | TRIPINFO_NOREALTIME | TRIPINFO_OTHER

Types of problems that may be returned in responses to TripInfo requests.

10.2. The TripInfoRequestGroup group

@@ -682,16 +682,16 @@

OJP - Open API for distributed Journey

TripInfoRequestGroup

TripInfo request structure.

The element contains one of the following elements:

DatedJourneyRef

a

→‍JourneyRef

1:1

→‍JourneyRef

Reference to a Journey

10.6. The TripInfoResponseGroup group

-

TripInfoResponseGroup

TripInfo response structure.

TripInfoResponse

TripInfoResponseContext

0:1

+ResponseContext

Response context.

TripInfoResult

0:1

+TripInfoResult

Result structure.

10.7. The complex type TripInfoResultStructure

+

TripInfoResultStructure

TripInfo result structure containing the current status of a trip.

The element contains a sequence of the following elements:

ErrorCondition

0:*

+OJPError

Problems related to this TripInfo result.

PreviousCall

0:*

+CallAtStop

The stops this service already has called at. Including the current stop if service is currently at stop.

CurrentPosition

0:1

+VehiclePosition

Current position of this service.

OnwardCall

0:*

+CallAtStop

The stops this service still has to call at.

Service

0:1

+DatedJourney

Description of the service.

10.7. The complex type TripInfoResultStructure

- +

TripInfoResultStructure

TripInfo result structure containing the status of a trip.

The element contains a sequence of the following elements:

ErrorCondition

0:*

+OJPError

Problems related to this TripInfo result.

PreviousCall

0:*

+CallAtStop

The stops this service already has called at. Including the current stop if service is currently at stop.

CurrentPosition

0:1

+VehiclePosition

Current position of this service.

OnwardCall

0:*

+CallAtStop

The stops this service still has to call at.

Service

0:1

+DatedJourney

Description of the service.

OperatingDays

OperatingDays

0:1

+OperatingDays

Bit string definition of operating days.

OperatingDaysDescription

0:1

+InternationalText

Textual description of the operation days, e.g. "monday to friday" or "not on holidays".

OperatingDaysDescription

0:1

+InternationalText

Textual description of the operation days, e.g., "Monday to Friday" or "not on holidays".

→‍siri:ServiceFacilityGroup

JourneyTrack

0:1

+LegTrack

Geographic embedding of this journey. The entire journey is regarded as one leg.

Extension

0:1

xs:anyType

10.8. The toplevel element TripInfoProblemType

TripInfoProblemType

TripInfoProblemType (↔ ErrorType)

-

11. OJP/OJP_Trips.xsd - Request and response definitions for trip requests and distributed journey planning

11.1. Simple type definitions

- -

AccessFeatureStatusEnumeration

unknown | available | partiallyAvailable | notAvailable

Allowed values for status of the access feature.

AccessFeatureTypeEnumeration

elevator | stairs | seriesOfStairs | singleStep | seriesOfSingleSteps | escalator | travelator | ramp | footpath | shuttle | other | unkown

Allowed values for a AccessFeature.

AccessibilityFeatureTypesEnumeration

lowFloorAccess | stepFreeAccess | accessWithSteps | slidingStep | raisedKerb | narrowEntrance | wheelchairLift | manualRamp | automaticRamp | suitableForWheelchairs | suitableForUnassistedWheelchairs | suitableForHeaviliyDisabled | suitableForPushchairs | suitableForBicycles | tactilePlatformEdges | tactileGuidingStrips | tactileOrAuditorySigns | visualSigns | elevatorWithTactileButtons | elevatorWithAcousticAnnouncements | audioInformation | audioForHearingImpaired | visualDisplays | displaysForVisuallyImpaired | largePrintTimetables | boardingAssistance | onboardAssistance | unaccompaniedMinorAssistance | barrier | validator

Allowed values for AccessibilityFeature (for mobility and sensory impairments, assistance and important elements to pay attention to).

ExtendToFrontOrBackType

extendToFront | extendToBack

Prefer earlier or later times.

FeasibilityEnumeration

allAccessFeaturesAvailable | accessFeatureNotAvailable | accessFeaturePartiallyAvailable | accessFeatureWithUnknownAvailability | seeSituations

Allowed values for the feasibility of a TRIP or part of a TRIP.

GuidanceAdviceEnumeration

origin | destination | continue | keep | turn | leave | enter | enter_roundabout | stay_in_roundabout | leave_roundabout | enter_builtup_area | leave_builtup_area | freewayAccessRamp | unknown_lane_choice | left_lane | middle_lane | right_lane | unknown_turning_kind

Various types of guidance advice given to traveller. Suitable values may differ by MODE (e.g. a car driver needs different advice than a person walking for a transfer.

LegObjectIdType

ObjectIdType

Type for identifier of a NeTEx Object.

MultiPointTripResultObjectIdType

ObjectIdType

Type for identifier of a NeTEx Object.

MultiPointTypeEnumeration

anyPoint | eachOrigin | eachDestination | eachOriginDestination | somePoints

How the multiple origin/destination points should be considered. - Note: Unfortunately this element was underdefined before and this resulted in different implementations. +

11. OJP/OJP_Trips.xsd - Request and response definitions for trip requests and distributed journey planning

11.1. Simple type definitions

AccessFeatureStatusEnumeration

unknown | available | partiallyAvailable | notAvailable

Allowed values for status of the access feature.

AccessFeatureTypeEnumeration

elevator | stairs | seriesOfStairs | singleStep | seriesOfSingleSteps | escalator | travelator | ramp | footpath | shuttle | other | unknown

Allowed values for a AccessFeature.

AccessibilityFeatureTypesEnumeration

lowFloorAccess | stepFreeAccess | accessWithSteps | slidingStep | raisedKerb | narrowEntrance | wheelchairLift | manualRamp | automaticRamp | suitableForWheelchairs | suitableForUnassistedWheelchairs | suitableForHeaviliyDisabled | suitableForPushchairs | suitableForBicycles | tactilePlatformEdges | tactileGuidingStrips | tactileOrAuditorySigns | visualSigns | elevatorWithTactileButtons | elevatorWithAcousticAnnouncements | audioInformation | audioForHearingImpaired | visualDisplays | displaysForVisuallyImpaired | largePrintTimetables | boardingAssistance | onboardAssistance | unaccompaniedMinorAssistance | barrier | validator

Allowed values for AccessibilityFeature (for mobility and sensory impairments, assistance and crucial elements to pay attention to).

ExtendToFrontOrBackType

extendToFront | extendToBack

Prefer earlier or later times.

FeasibilityEnumeration

allAccessFeaturesAvailable | accessFeatureNotAvailable | accessFeaturePartiallyAvailable | accessFeatureWithUnknownAvailability | seeSituations

Allowed values for the feasibility of a TRIP or part of a TRIP.

GuidanceAdviceEnumeration

origin | destination | continue | keep | turn | leave | enter | enter_roundabout | stay_in_roundabout | leave_roundabout | enter_builtup_area | leave_builtup_area | freewayAccessRamp | unknown_lane_choice | left_lane | middle_lane | right_lane | unknown_turning_kind

Several types of guidance advice given to traveller. Suitable values may differ by MODE (e.g., a car driver needs different advice than a person walking for a transfer.

LegObjectIdType

ObjectIdType

Type for identifier of a NeTEx Object.

MultiPointTripResultObjectIdType

ObjectIdType

Type for identifier of a NeTEx Object.

MultiPointTypeEnumeration

anyPoint | eachOrigin | eachDestination | eachOriginDestination | somePoints

How the multiple origin/destination points should be considered. + Note: Unfortunately, this element was underdefined before and this resulted in different implementations. Note: MultiPointType trumps the number of results. If the algorithm thinks it necessary to provide more results, it should. -

OptimisationMethodEnumeration

fastest | minChanges | leastWalking | leastCost | leastDistance | earliestArrival | latestDeparture | earliestArrivalAndLatestDeparture | minNonLevelEntrances | minStairs | bestForVisualImpairment | bestForAuditoryImpairment | environmentalSafety | extraSafe | extraReliable | scenic | quietTravel

The types of algorithm that can be used for planning a journey (fastest, least walking, etc.). Only one method can be used. Each one really is a whole set of a policy, which is defined below. E.g. fastest also includes least transfers as a second criteria, some modes are excluded usually by default. Implementations might differ (slightly). Also some strategies might not be implemented. The most important strategies are marked.

TransitionEnumeration

up | down | level | upAndDown | downAndUp

Transition types for interchanges.

TripChangeProblemTypeEnumeration

TRIPCHANGE_NOLATERTRIPFOUND | TRIPCHANGE_NOEARLIERTRIPFOUND | TRIPCHANGE_INVALIDLEGREF | TRIPCHANGE_INVALIDOPERATOR | TRIPCHANGE_NOVEHICLEAVAILABLE | TRIPCHANGE_OTHER

Types of problems that may be returned in responses to TRIPCHANGE requests.

TripObjectIdType

ObjectIdType

Type for identifier of a TRIP Object.

TripProblemTypeEnumeration

TRIP_NOTRIPFOUND | TRIP_ORIGINUNKNOWN | TRIP_DESTINATIONUNKNOWN | TRIP_VIAUNKNOWN | TRIP_NOTVIAUNKNOWN | TRIP_NOCHANGEATUNKNOWN | TRIP_NOORIGIN | TRIP_NODESTINATION | TRIP_ORIGINDESTINATIONIDENTICAL | TRIP_DATETIMEERROR | TRIP_TIMEWINDOWTOOLARGE | TRIP_DEPARTUREAFTERARRIVAL | TRIP_DATEOUTOFRANGE | TRIP_ORIGINEQUIVALENT | TRIP_DESTINATIONEQUIVALENT | TRIP_VIAEQUIVALENT | TRIP_REALTIMEINCOMPLETE | TRIP_ITTIMEEXTENDED | TRIP_ITMODECHANGED | TRIP_INCONVENIENTWAITING | TRIP_RESTRICTEDRESULTSDROPPED | TRIP_MULTIPOINT_NOTALLPOINTSCOVERED | TRIP_MULTIPOINT_TOOMANYPOINTS | TRIP_MULTIPOINT_TYPE_NOT_SUPPORTED | TRIP_REFINE_LEG_UNKNOWN | REFINE_OBJECTNOTFOUND | REFINE_PROFILENOTSUPPORTED | TRIP_OTHER

Types of problems that may be returned in responses to Trip requests.

TripResultObjectIdType

ObjectIdType

Type for identifier of a NeTEx Object.

TurnActionEnumeration

straight_on | half_right | right | sharp_right | uturn | sharp_left | left | half_left | up | down | unknown_turn_action

The range of possible turns that can be described.

11.2. The TripRequestGroup group

+

TripRequestGroup

Trip request structure.

OptimisationMethodEnumeration

fastest | minChanges | leastWalking | leastCost | leastDistance | earliestArrival | latestDeparture | earliestArrivalAndLatestDeparture | minNonLevelEntrances | minStairs | bestForVisualImpairment | bestForAuditoryImpairment | environmentalSafety | extraSafe | extraReliable | scenic | quietTravel

The types of algorithms that can be used for planning a journey (fastest, least walking, etc.). Only one method can be used. Each one really is a whole set of a policy, which is defined below. E.g., fastest also includes least transfers as a second criteria, some modes are excluded usually by default. Implementations might differ (slightly). Also, some strategies might not be implemented. The most important strategies are marked.

TransitionEnumeration

up | down | level | upAndDown | downAndUp

Transition types for interchanges.

TripChangeProblemTypeEnumeration

TRIPCHANGE_NOLATERTRIPFOUND | TRIPCHANGE_NOEARLIERTRIPFOUND | TRIPCHANGE_INVALIDLEGREF | TRIPCHANGE_INVALIDOPERATOR | TRIPCHANGE_NOVEHICLEAVAILABLE | TRIPCHANGE_OTHER

Types of problems that may be returned in responses to TRIPCHANGE requests.

TripObjectIdType

ObjectIdType

Type for identifier of a TRIP Object.

TripProblemTypeEnumeration

TRIP_NOTRIPFOUND | TRIP_ORIGINUNKNOWN | TRIP_DESTINATIONUNKNOWN | TRIP_VIAUNKNOWN | TRIP_NOTVIAUNKNOWN | TRIP_NOCHANGEATUNKNOWN | TRIP_NOORIGIN | TRIP_NODESTINATION | TRIP_ORIGINDESTINATIONIDENTICAL | TRIP_DATETIMEERROR | TRIP_TIMEWINDOWTOOLARGE | TRIP_DEPARTUREAFTERARRIVAL | TRIP_DATEOUTOFRANGE | TRIP_ORIGINEQUIVALENT | TRIP_DESTINATIONEQUIVALENT | TRIP_VIAEQUIVALENT | TRIP_REALTIMEINCOMPLETE | TRIP_ITTIMEEXTENDED | TRIP_ITMODECHANGED | TRIP_INCONVENIENTWAITING | TRIP_RESTRICTEDRESULTSDROPPED | TRIP_MULTIPOINT_NOTALLPOINTSCOVERED | TRIP_MULTIPOINT_TOOMANYPOINTS | TRIP_MULTIPOINT_TYPE_NOT_SUPPORTED | TRIP_REFINE_LEG_UNKNOWN | REFINE_OBJECTNOTFOUND | REFINE_PROFILENOTSUPPORTED | TRIP_OTHER

Types of problems that may be returned in responses to Trip requests.

TripResultObjectIdType

ObjectIdType

Type for identifier of a NeTEx Object.

TurnActionEnumeration

straight_on | half_right | right | sharp_right | uturn | sharp_left | left | half_left | up | down | unknown_turn_action

The range of possible turns that can be described.

11.2. The TripRequestGroup group

- + @@ -721,8 +721,8 @@

OJP - Open API for distributed Journey

- - + + | | `easy` | @@ -771,17 +771,17 @@

OJP - Open API for distributed Journey

- + - + - + @@ -789,15 +789,15 @@

OJP - Open API for distributed Journey

- + - + -

TripRequestGroup

Trip request structure.

TripRequest

Origin

1:*

+PlaceContext

Specifies the origin situation from where the user wants to start.

Destination

1:*

+PlaceContext

Specifies the destination situation where the user is heading to.

Via

0:*

+TripVia

Ordered series of points where the journey must pass through. If more than one via point is given all of them must be obeyed - in the correct order. The server is allowed to replace a via stop by equivalent stops. @@ -710,7 +710,7 @@

OJP - Open API for distributed Journey

BaseTripMobilityFilter

NoSingleStep

0:1

xs:boolean

The user is not able to pass over (or wants to avoid) single steps. Stairs and non-level entrances are not excluded.

NoStairs

0:1

xs:boolean

The user is not able to walk up/down stairs.

NoStairs

0:1

xs:boolean

The user is not able to walk up/downstairs.

NoEscalator

0:1

xs:boolean

The user is not able to use an escalator.

NoElevator

0:1

xs:boolean

The user is not able to use an elevator.

NoRamp

0:1

xs:boolean

The user is not able to use a ramp.

TripMobilityFilter

BikeTransport

0:1

xs:boolean

The user wants to carry a bike on public transport (could be extended in future to transporting big luggage/animals/etc).

WalkSpeed

0:1

OpenPercent

Deviation from average walking speed in percent. 100% percent is average speed. Less than 100 % slower, Greater than 150% faster.

AdditionalTransferTime

0:1

xs:duration

Additional time added to all transfers (also to transfers between individual to public transport, not modeled in Transmodel).

HikingProfile

0:1

Users hiking profile. The main element to control general walking behaviour is WalkSpeed (together with accessibility constraints). Note: possible explanations in German can be found here: https://akademie.alpinewelten.com/bergwandern/klassifizierung-von-wanderwegen

AdditionalTransferTime

0:1

xs:duration

Additional time added to all transfers (also to transfers between individual to public transport, not modelled in Transmodel).

HikingProfile

0:1

Users hiking profile. The main element to control general walking behaviour is WalkSpeed (together with accessibility constraints). Note: explanations in German can be found here: https://akademie.alpinewelten.com/bergwandern/klassifizierung-von-wanderwegen

Then, the element contains one of the following elements:

NumberOfResults

a

NumberOfResultsBefore

0:1

xs:nonNegativeInteger

The desired number of trip results before the given time (at origin or destination).

a

NumberOfResultsAfter

0:1

xs:nonNegativeInteger

The desired number of trip results after the given time (at origin or destination).

BaseTripPolicy

b

NumberOfResults

-0:1

xs:positiveInteger

The number of trip results that the user wants to see at least (TRIP REQUEST POLICY.maximumNumberofJourneys). Be aware that some implementatins will deliver one of the TripResults before the indicated departure time. This means one always has to check the results against the parameters before using them.

BaseTripPolicy

b

NumberOfResults

-0:1

xs:positiveInteger

The number of trip results that the user wants to see at least (TRIP REQUEST POLICY.maximumNumberofJourneys). Be aware that some implementations will deliver one of the TripResults before the indicated departure time. This means one always must check the results against the parameters before using them.

TimeWindow

0:1

xs:duration

Time window in which the trips should be, starting from the time specified in PlaceContext. Implements TRIP REQUEST.FlexibilityWindow. All trips within the window should be provided by the implementation.

UseRealtimeData

0:1

UseRealtimeData

The way real-time data should be used in the calculation of the trip.

ImmediateTripStart

0:1

xs:boolean

Whether the trip calculation should find a solution that starts immediately (e.g. because the user is already on the way) instead of finding the latest possible start opportunity. Default is FALSE.

ImmediateTripStart

0:1

xs:boolean

Whether the trip calculation should find a solution that starts immediately (e.g., because the user is already on the way) instead of finding the latest possible start opportunity. Default is FALSE.

TransferLimit

0:1

xs:nonNegativeInteger

The maximum number of interchanges the user will accept per trip.

OptimisationMethod

0:1

OptimisationMethod

The type of algorithm to be used in the calculation of the trip (fastest, least walking, etc.).

ConsiderElevationData

0:1

xs:boolean

Whether the trip calculation should take elevation data into account (bike, foot). Default is FALSE.

IncludeAllRestrictedLines

0:1

xs:boolean

There might exist lines that have special restrictions and are not generally available to the public. E.g. school buses, company shuttles. dragLifts need to have an ACCESS MODE ski. Lines with ACCESS MODE bicycle will be included as well. If this flag is set, then existing restricted lines are considered by the router, irrespective of the selected passenger categories or the MotorisedMainTravelMode. The results are marked as restricted in the ServiceGroup. The usage could also be detailed with Attribute elements. Restricted trumps PassengerCategory, for example. If Restricted is set to true, all services are displayed.

PassengerCategory

0:*

PassengerCategory

Sequence of all passenger categories, for which this search shall be conducted. In rare cases additional offerings may be available (e.g., demand responsive service with certain areas being reserved for seniors). If multiple PassengerCategories are provided, then Services are shown when they are available for at least one PassengerCategory.

Then, the element contains one of the following elements:

The element contains a sequence of the following elements:

TripPolicy

ItModeToCover

-0:*

+ItModes

For each MODE or MODE OF OPERATION combination in this list a separate monomodal trip shall be found - in addition to inter-modal solutions.

IncludeAlternativeOptions

-0:1

xs:boolean

Whether alternative options should be presented as well. Mainly important for dominated journeys or in the case of ContinuousLegs the second-best route. Should be optimised for the user expectance (see. e.g https://theses.hal.science/tel-01848737). However, what the alternative options are may vary widely depending on the optimisation methods and filters.

b

MotorisedMainTravelMode

-0:1

xs:boolean

The MotorisedMainTravelMode defines whether the trip planner works in PT mode (or pure IT mode) or includes carTransportRail and the like. If set to true (e.g. because one travels by car, truck or motorcycle), then carTransportRail, ferry are used together with roads.

Then, the element contains one of the following elements:

The element contains a sequence of the following elements:

TripPolicy

ItModeToCover

-0:*

+ItModes

For each MODE or MODE OF OPERATION combination in this list a separate monomodal trip shall be found - in addition to inter-modal solutions.

IncludeAlternativeOptions

-0:1

xs:boolean

Whether alternative options should be presented as well. Mainly important for dominated journeys or in the case of ContinuousLegs the second-best route. Should be optimised for the user expectance (see. e.g https://theses.hal.science/tel-01848737). However, what the alternative options are may vary widely depending on the optimisation methods and filters.

b

MotorisedMainTravelMode

-0:1

xs:boolean

The MotorisedMainTravelMode defines whether the trip planner works in PT mode (or pure IT mode) or includes carTransportRail and the like. If set to true (e.g., because one travels by car, truck or motorcycle), then carTransportRail, ferry are used together with roads.

BaseTripContentFilter

IncludeTrackSections

0:1

xs:boolean

Whether the result should include TrackSection elements to describe the geographic route of each journey leg.

IncludeTurnDescription

0:1

xs:boolean

Whether the result should include turn-by-turn instructions for each journey leg.

IncludeAccessFeatures

0:1

xs:boolean

Whether the result should include the access features (stairs, elevator, etc.) on each path link.

IncludeAccessFeaturesStatus

0:1

xs:boolean

Whether the result should include real time status of access features to indicate broken equipment.

IncludeAccessibilityDetails

0:*

AccessibilityDetailsProfile

Which accessibility features and other accessibility-related information to retrieve (e.g. guidance text for the visually impaired).

IncludeAccessibilityDetails

0:*

AccessibilityDetailsProfile

Which accessibility features and other accessibility-related information to retrieve (e.g., guidance text for the visually impaired).

IncludePlacesContext

0:1

xs:boolean

Whether the place context is needed. If a requestor has that information already, the response can be made slimmer, when set to false. Default is true.

IncludeSituationsContext

0:1

xs:boolean

Wheter the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true

IncludeSituationsContext

0:1

xs:boolean

Whether the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true.

TripContentFilter

IncludeIntermediateStops

0:1

xs:boolean

Whether the result should include intermediate stops (between the passenger's board and alight stops).

IncludeFare

0:1

xs:boolean

Whether the result should include fare information.

IncludeOperatingDays

0:1

xs:boolean

Whether the result should include operating day information - as encoded bit string and in natural language.

TripSummaryOnly

0:1

xs:boolean

If true, then the response will contain only summaries of the found trips. Default is false.

FareParam

0:1

+FareParam

Parameters for fare calculation. Only used if IncludeFare is set (TripContentFilterGroup).

Extension

0:1

xs:anyType

11.4. The TripDataFilterGroup group

+

TripDataFilterGroup

Data to be included/excluded from search, e.g. modes, operators (Transmodel: TRIP REQUEST FILTER).

FareParam

0:1

+FareParam

Parameters for fare calculation. Only used if IncludeFare is set (TripContentFilterGroup).

Extension

0:1

xs:anyType

11.4. The TripDataFilterGroup group

@@ -808,21 +808,21 @@

OJP - Open API for distributed Journey

- + - + - +

TripDataFilterGroup

Data to be included/excluded from search, e.g., modes, operators (Transmodel: TRIP REQUEST FILTER).

TripDataFilter

ModeAndModeOfOperationFilter

0:*

+ModeAndModeOfOperationFilter

MODEs and MODEs OF OPERATION to be considered in trip calculation. If only MODE is used, then it is for all MODE OF OPERATION. If combinations of MODE and MODE OF OPERATION are used (multiples), then all combinations are to be considered.

LineFilter

0:1

+LineDirectionFilter

Lines/Directions to include/exclude.

OperatorFilter

0:1

+OperatorFilter

Transport operators to include/exclude.

The element contains one of the following elements:

NumberOfResults

a

NumberOfResultsBefore

0:1

xs:nonNegativeInteger

The desired number of trip results before the given time (at origin or destination).

a

NumberOfResultsAfter

0:1

xs:nonNegativeInteger

The desired number of trip results after the given time (at origin or destination).

BaseTripPolicy

b

NumberOfResults

-0:1

xs:positiveInteger

The number of trip results that the user wants to see at least (TRIP REQUEST POLICY.maximumNumberofJourneys). Be aware that some implementatins will deliver one of the TripResults before the indicated departure time. This means one always has to check the results against the parameters before using them.

BaseTripPolicy

b

NumberOfResults

-0:1

xs:positiveInteger

The number of trip results that the user wants to see at least (TRIP REQUEST POLICY.maximumNumberofJourneys). Be aware that some implementations will deliver one of the TripResults before the indicated departure time. This means one always must check the results against the parameters before using them.

TimeWindow

0:1

xs:duration

Time window in which the trips should be, starting from the time specified in PlaceContext. Implements TRIP REQUEST.FlexibilityWindow. All trips within the window should be provided by the implementation.

UseRealtimeData

0:1

UseRealtimeData

The way real-time data should be used in the calculation of the trip.

ImmediateTripStart

0:1

xs:boolean

Whether the trip calculation should find a solution that starts immediately (e.g. because the user is already on the way) instead of finding the latest possible start opportunity. Default is FALSE.

ImmediateTripStart

0:1

xs:boolean

Whether the trip calculation should find a solution that starts immediately (e.g., because the user is already on the way) instead of finding the latest possible start opportunity. Default is FALSE.

TransferLimit

0:1

xs:nonNegativeInteger

The maximum number of interchanges the user will accept per trip.

OptimisationMethod

0:1

OptimisationMethod

The type of algorithm to be used in the calculation of the trip (fastest, least walking, etc.).

ConsiderElevationData

0:1

xs:boolean

Whether the trip calculation should take elevation data into account (bike, foot). Default is FALSE.

IncludeAllRestrictedLines

0:1

xs:boolean

There might exist lines that have special restrictions and are not generally available to the public. E.g. school buses, company shuttles. dragLifts need to have an ACCESS MODE ski. Lines with ACCESS MODE bicycle will be included as well. If this flag is set, then existing restricted lines are considered by the router, irrespective of the selected passenger categories or the MotorisedMainTravelMode. The results are marked as restricted in the ServiceGroup. The usage could also be detailed with Attribute elements. Restricted trumps PassengerCategory, for example. If Restricted is set to true, all services are displayed.

PassengerCategory

0:*

PassengerCategory

Sequence of all passenger categories, for which this search shall be conducted. In rare cases additional offerings may be available (e.g., demand responsive service with certain areas being reserved for seniors). If multiple PassengerCategories are provided, then Services are shown when they are available for at least one PassengerCategory.

The element contains one of the following elements:

The element contains a sequence of the following elements:

TripPolicy

ItModeToCover

-0:*

+ItModes

For each MODE or MODE OF OPERATION combination in this list a separate monomodal trip shall be found - in addition to inter-modal solutions.

IncludeAlternativeOptions

-0:1

xs:boolean

Whether alternative options should be presented as well. Mainly important for dominated journeys or in the case of ContinuousLegs the second-best route. Should be optimised for the user expectance (see. e.g https://theses.hal.science/tel-01848737). However, what the alternative options are may vary widely depending on the optimisation methods and filters.

b

MotorisedMainTravelMode

-0:1

xs:boolean

The MotorisedMainTravelMode defines whether the trip planner works in PT mode (or pure IT mode) or includes carTransportRail and the like. If set to true (e.g. because one travels by car, truck or motorcycle), then carTransportRail, ferry are used together with roads.

The element contains one of the following elements:

The element contains a sequence of the following elements:

TripPolicy

ItModeToCover

-0:*

+ItModes

For each MODE or MODE OF OPERATION combination in this list a separate monomodal trip shall be found - in addition to inter-modal solutions.

IncludeAlternativeOptions

-0:1

xs:boolean

Whether alternative options should be presented as well. Mainly important for dominated journeys or in the case of ContinuousLegs the second-best route. Should be optimised for the user expectance (see. e.g https://theses.hal.science/tel-01848737). However, what the alternative options are may vary widely depending on the optimisation methods and filters.

b

MotorisedMainTravelMode

-0:1

xs:boolean

The MotorisedMainTravelMode defines whether the trip planner works in PT mode (or pure IT mode) or includes carTransportRail and the like. If set to true (e.g., because one travels by car, truck or motorcycle), then carTransportRail, ferry are used together with roads.

11.6. The TripMobilityFilterGroup group

- + @@ -833,8 +833,8 @@

OJP - Open API for distributed Journey

- - + + | | `easy` | @@ -885,9 +885,9 @@

OJP - Open API for distributed Journey

- + - + @@ -896,32 +896,32 @@

OJP - Open API for distributed Journey

TripMobilityFilterGroup

Parameters the user can set to restrict the mobility options - particularly for interchanging.

BaseTripMobilityFilter

NoSingleStep

0:1

xs:boolean

The user is not able to pass over (or wants to avoid) single steps. Stairs and non-level entrances are not excluded.

NoStairs

0:1

xs:boolean

The user is not able to walk up/down stairs.

NoStairs

0:1

xs:boolean

The user is not able to walk up/downstairs.

NoEscalator

0:1

xs:boolean

The user is not able to use an escalator.

NoElevator

0:1

xs:boolean

The user is not able to use an elevator.

NoRamp

0:1

xs:boolean

The user is not able to use a ramp.

TripMobilityFilter

BikeTransport

0:1

xs:boolean

The user wants to carry a bike on public transport (could be extended in future to transporting big luggage/animals/etc).

WalkSpeed

0:1

OpenPercent

Deviation from average walking speed in percent. 100% percent is average speed. Less than 100 % slower, Greater than 150% faster.

AdditionalTransferTime

0:1

xs:duration

Additional time added to all transfers (also to transfers between individual to public transport, not modeled in Transmodel).

HikingProfile

0:1

Users hiking profile. The main element to control general walking behaviour is WalkSpeed (together with accessibility constraints). Note: possible explanations in German can be found here: https://akademie.alpinewelten.com/bergwandern/klassifizierung-von-wanderwegen

AdditionalTransferTime

0:1

xs:duration

Additional time added to all transfers (also to transfers between individual to public transport, not modelled in Transmodel).

HikingProfile

0:1

Users hiking profile. The main element to control general walking behaviour is WalkSpeed (together with accessibility constraints). Note: explanations in German can be found here: https://akademie.alpinewelten.com/bergwandern/klassifizierung-von-wanderwegen

IncludeTurnDescription

0:1

xs:boolean

Whether the result should include turn-by-turn instructions for each journey leg.

IncludeAccessFeatures

0:1

xs:boolean

Whether the result should include the access features (stairs, elevator, etc.) on each path link.

IncludeAccessFeaturesStatus

0:1

xs:boolean

Whether the result should include real time status of access features to indicate broken equipment.

IncludeAccessibilityDetails

0:*

AccessibilityDetailsProfile

Which accessibility features and other accessibility-related information to retrieve (e.g. guidance text for the visually impaired).

IncludeAccessibilityDetails

0:*

AccessibilityDetailsProfile

Which accessibility features and other accessibility-related information to retrieve (e.g., guidance text for the visually impaired).

IncludePlacesContext

0:1

xs:boolean

Whether the place context is needed. If a requestor has that information already, the response can be made slimmer, when set to false. Default is true.

IncludeSituationsContext

0:1

xs:boolean

Wheter the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true

IncludeSituationsContext

0:1

xs:boolean

Whether the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true.

TripContentFilter

IncludeIntermediateStops

0:1

xs:boolean

Whether the result should include intermediate stops (between the passenger's board and alight stops).

IncludeFare

0:1

xs:boolean

Whether the result should include fare information.

11.8. The complex type NotViaStructure

NotViaStructure

Not-via restrictions for a TRIP, i.e. SCHEDULED STOP POINTs or STOP PLACEs that the TRIP is not allowed to pass through

The element contains only one element:

Then, the element contains one of the following elements:

a

→‍siri:StopPointRef

-1:1

→‍siri:StopPointRef

Reference to a not-via stop point.

b

→‍StopPlaceRef

-1:1

→‍StopPlaceRef

Reference to a not-via stop place.

11.9. The complex type NoChangeAtStructure

NoChangeAtStructure

No-change-at restrictions for a TRIP, i.e. SCHEDULED STOP POINTs or STOP PLACEs at which no TRANSFER is allowed within a TRIP.

The element contains only one element:

Then, the element contains one of the following elements:

a

→‍siri:StopPointRef

-1:1

→‍siri:StopPointRef

Reference to a no-change stop point.

b

→‍StopPlaceRef

-1:1

→‍StopPlaceRef

Reference to a no-change stop place.

11.10. The complex type TariffzoneFilterStructure

TariffzoneFilterStructure

The element contains a sequence of the following elements:

Exclude

0:1

xs:boolean

Whether to include or exclude given tariff zones in the list from the search. Default is to include.

TariffZones

1:1

+TariffZoneListInArea

List of fare zones to include or exclude.

11.11. The TripResponseGroup group

-

TripResponseGroup

Trip response structure.

TripResponse

TripResponseContext

0:1

+ResponseContext

Context to hold trip response objects that occur frequently.

TripResult

0:*

+TripResult

The trip results found by the server.

11.12. The complex type TripResultStructure

TripResultStructure

Structure for a single trip result and associated problems.

The element contains a sequence of the following elements:

Id

1:1

Id of this trip result for referencing purposes. Unique within trip response.

ErrorCondition

0:*

+OJPError

Problems related to this Trip result.

Then, the element contains one of the following elements:

a

Trip

-1:1

+Trip

Detailed information on trip.

b

TripSummary

-1:1

+TripSummary

Summary on trip. Only if requestor set TripSummaryOnly in request.

TripFare

0:*

+TripFareResult

Fare and fare product information for this trip as a whole or parts of it.

IsAlternativeOption

0:1

xs:boolean

When the result is an alternative option from IncludeAlternativeOptions, then the flag should be set to true. If it is an alternative option this means that the server decided to add this result for its own reasons: e.g. to push a certain trip leg, because it believes that it might better suit at least some possible customers. Such options are not an optimal fit to the criteria that were in the request. The client may therefore disregard such results depending on the use case.

11.13. The complex type TripSummaryStructure

+

TripSummaryStructure

Structure for trip overview information (only implementation related and therefore not modeled in Transmodel).

The element contains a sequence of the following elements:

TripId

1:1

Id of this trip for referencing purposes. Unique within trip response.

Origin

0:1

+PlaceRef

Describes the origin situation of this trip.

Destination

0:1

+PlaceRef

Describes the arrival situation of this trip.

Duration

0:1

xs:duration

Overall duration of the trip (TRIP attribute, not detailed in Transmodel, available from constituing LEGs).

StartTime

0:1

xs:dateTime

Departure time at origin (TRIP attribute, not detailed in Transmodel, available from constituing LEGs).

EndTime

0:1

xs:dateTime

Arrival time at destination (TRIP attribute, not detailed in Transmodel, available from constituing LEGs).

PTLegs

0:1

xs:nonNegativeInteger

Number of public transport legs.

Distance

0:1

siri:DistanceType

Trip distance (TRIP attribute, not detailed in Transmodel, available from constituing LEGs).

11.12. The complex type TripResultStructure

TripResultStructure

Structure for a single trip result and associated problems.

The element contains a sequence of the following elements:

Id

1:1

Id of this trip result for referencing purposes. Unique within trip response.

ErrorCondition

0:*

+OJPError

Problems related to this Trip result.

Then, the element contains one of the following elements:

a

Trip

-1:1

+Trip

Detailed information on trip.

b

TripSummary

-1:1

+TripSummary

Summary on trip. Only if requestor set TripSummaryOnly in request.

TripFare

0:*

+TripFareResult

Fare and fare product information for this trip as a whole or parts of it.

IsAlternativeOption

0:1

xs:boolean

When the result is an alternative option from IncludeAlternativeOptions, then the flag should be set to true. If it is an alternative option this means that the server decided to add this result for its own reasons: e.g., to push a certain trip leg, because it believes that it might better suit at least some possible customers. Such options are not an optimal fit to the criteria that were in the request. The client may therefore disregard such results depending on the use case.

11.13. The complex type TripSummaryStructure

- -

TripSummaryStructure

Structure for trip overview information (only implementation related and therefore not modelled in Transmodel).

The element contains a sequence of the following elements:

TripId

1:1

Id of this trip for referencing purposes. Unique within trip response.

Origin

0:1

+PlaceRef

Describes the origin situation of this trip.

Destination

0:1

+PlaceRef

Describes the arrival situation of this trip.

Duration

0:1

xs:duration

Overall duration of the trip (TRIP attribute, not detailed in Transmodel, available from constituting LEGs).

StartTime

0:1

xs:dateTime

Departure time at origin (TRIP attribute, not detailed in Transmodel, available from constituting LEGs).

EndTime

0:1

xs:dateTime

Arrival time at destination (TRIP attribute, not detailed in Transmodel, available from constituting LEGs).

PTLegs

0:1

xs:nonNegativeInteger

Number of public transport legs.

Distance

0:1

siri:DistanceType

Trip distance (TRIP attribute, not detailed in Transmodel, available from constituting LEGs).

OperatingDays

OperatingDays

0:1

+OperatingDays

Bit string definition of operating days.

OperatingDaysDescription

0:1

+InternationalText

Textual description of the operation days, e.g. "monday to friday" or "not on holidays".

Feasibility

0:*

Feasibility

Information about the feasibility of the TRIP, in particular with respect to the access features used.

SituationFullRefs

0:1

+SituationRefList

A list of references to SITUATIONs.

Extension

0:1

xs:anyType

11.14. The complex type TripStructure

+ +

TripStructure

[an extended form of PT TRIP in TM and NeTEx as it also includes the initial and final access legs to and from public transport] whole journey from passenger origin to passenger destination in one or more LEGs

The element contains a sequence of the following elements:

Id

1:1

Id of this trip for referencing purposes. Unique within trip response.

Duration

1:1

xs:duration

Overall duration of the trip (TRIP attribute, not detailed in Transmodel, available from constituing LEGs).

StartTime

1:1

xs:dateTime

Departure time at origin (TRIP attribute, not detailed in Transmodel, available from constituing LEGs).

EndTime

1:1

xs:dateTime

Arrival time at destination (TRIP attribute, not detailed in Transmodel, available from constituing LEGs).

Transfers

1:1

xs:nonNegativeInteger

Number of interchanges.

Distance

0:1

siri:DistanceType

Trip distance (TRIP attribute, not detailed in Transmodel, available from constituing LEGs).

Leg

1:*

+Leg

Legs of the trip (Transmodel: LEG or MONITORED LEG). Note: There is always a TransferLeg between two TimedLegs. There can be a TransferLeg between two ContinuousLegs (e.g. because some special time consuming action is necessary like a car hire). There can be a TransferLeg between a ContinuousLeg and a TimedLeg for the same reason. There aren't two consecutive TransferLegs.

OperatingDaysDescription

0:1

+InternationalText

Textual description of the operation days, e.g., "Monday to Friday" or "not on holidays".

Feasibility

0:*

Feasibility

Information about the feasibility of the TRIP, in particular with respect to the access features used.

SituationFullRefs

0:1

+SituationRefList

A list of references to SITUATIONs.

Extension

0:1

xs:anyType

11.14. The complex type TripStructure

- + -

TripStructure

[an extended form of PT TRIP in TM and NeTEx as it also includes the initial and final access legs to and from public transport] whole journey from passenger origin to passenger destination in one or more LEGs

The element contains a sequence of the following elements:

Id

1:1

Id of this trip for referencing purposes. Unique within trip response.

Duration

1:1

xs:duration

Overall duration of the trip (TRIP attribute, not detailed in Transmodel, available from constituting LEGs).

StartTime

1:1

xs:dateTime

Departure time at origin (TRIP attribute, not detailed in Transmodel, available from constituting LEGs).

EndTime

1:1

xs:dateTime

Arrival time at destination (TRIP attribute, not detailed in Transmodel, available from constituting LEGs).

Transfers

1:1

xs:nonNegativeInteger

Number of interchanges.

Distance

0:1

siri:DistanceType

Trip distance (TRIP attribute, not detailed in Transmodel, available from constituting LEGs).

Leg

1:*

+Leg

Legs of the trip (Transmodel: LEG or MONITORED LEG). Note: There is always a TransferLeg between two TimedLegs. There can be a TransferLeg between two ContinuousLegs (e.g., because some special time consuming action is necessary like a car hire). There can be a TransferLeg between a ContinuousLeg and a TimedLeg for the same reason. There aren't two consecutive TransferLegs.

OperatingDays

OperatingDays

0:1

+OperatingDays

Bit string definition of operating days.

OperatingDaysDescription

0:1

+InternationalText

Textual description of the operation days, e.g. "monday to friday" or "not on holidays".

OperatingDaysDescription

0:1

+InternationalText

Textual description of the operation days, e.g., "Monday to Friday" or "not on holidays".

TripStatus

Unplanned

0:1

xs:boolean

Whether this trip is an additional one that has not been planned. Default is false.

Cancelled

0:1

xs:boolean

Whether this trip is cancelled and will not be run. Default is false.

Deviation

0:1

xs:boolean

Whether this trip deviates from the planned service pattern. Default is false.

Delayed

0:1

xs:boolean

Whether this trip is delayed. Default is false.

Infeasible

0:1

xs:boolean

Whether this trip cannot be used, due to operational delays and impossible transfers. Default is false.

Feasibility

0:*

Feasibility

Information about the feasibility of the TRIP, in particular with respect to the access features used.

SituationFullRefs

0:1

+SituationRefList

A list of references to SITUATIONs.

Extension

0:1

xs:anyType

11.15. The complex type LegStructure

+

LegStructure

A single stage of a TRIP that is made without change of MODE or service (ie: between each interchange). Implements LEG from TM 6.2.

The element contains a sequence of the following elements:

Id

1:1

LegObjectId

Id of this leg. Unique within trip result.

ParticipantRef

0:1

siri:ParticipantRefStructure

[equivalent of PARTICIPANT in SIRI] IT system that is participating in a communication with other participant(s)

Duration

0:1

xs:duration

The duration of the LEG (e.g. from Transmodel PT RIDE LEG.Duration).

Then, the element contains one of the following elements:

a

ContinuousLeg

-1:1

+ContinuousLeg

A specialised type of RIDE LEG in with Timed=false, a PERSONAL LEG or an ACCESS LEG TM 6 and NeTEx. LEG of a TRIP that is not bound to a timetable.

b

TimedLeg

-1:1

+TimedLeg

Corresponds to a RIDE or PT RIDE LEG in TM 6.2 with the attribute Timed (with related information). Passenger LEG with timetabled schedule.

c

TransferLeg

-1:1

+TransferLeg

TRANSFER LEG or CONNECTION LEG according to TM 6.2. Description of a LEG which links other LEGs where a TRANSFER or CONNECTION between different LOCATIONs is required.

Feasibility

0:*

Feasibility

Information about the feasibility of the TRIP, in particular with respect to the access features used.

SituationFullRefs

0:1

+SituationRefList

A list of references to SITUATIONs.

Extension

0:1

xs:anyType

11.15. The complex type LegStructure

LegStructure

A single stage of a TRIP that is made without change of MODE or service (e.g., between each interchange). Implements LEG from TM 6.2.

The element contains a sequence of the following elements:

Id

1:1

LegObjectId

Id of this leg. Unique within trip result.

ParticipantRef

0:1

siri:ParticipantRefStructure

[equivalent of PARTICIPANT in SIRI] IT system that is participating in a communication with other participant(s)

Duration

0:1

xs:duration

The duration of the LEG (e.g., from Transmodel PT RIDE LEG.Duration).

Then, the element contains one of the following elements:

a

ContinuousLeg

-1:1

+ContinuousLeg

A specialised type of RIDE LEG in with Timed=false, a PERSONAL LEG or an ACCESS LEG TM 6 and NeTEx. LEG of a TRIP that is not bound to a timetable.

b

TimedLeg

-1:1

+TimedLeg

Corresponds to a RIDE or PT RIDE LEG in TM 6.2 with the attribute Timed (with related information). Passenger LEG with timetabled schedule.

c

TransferLeg

-1:1

+TransferLeg

TRANSFER LEG or CONNECTION LEG according to TM 6.2. Description of a LEG which links other LEGs where a TRANSFER or CONNECTION between different LOCATIONs is required.

Sustainability

EmissionCO2

0:1

+EmissionCO2

Estimation of CO2 emissions.

Changed

0:1

xs:boolean

TRUE if leg got changed by TripChange-Request.

11.16. The complex type TimedLegStructure

- - + +

TimedLegStructure

Corresponds to a RIDE or PT RIDE LEG in TM 6.2 with the attribute Timed (with related information). Passenger LEG with timetabled schedule.

The element contains a sequence of the following elements:

LegBoard

1:1

+LegBoard

Stop/Station where boarding is done

LegIntermediate

0:*

+LegIntermediate

Information about the intermediate passed stop points.

LegAlight

1:1

+LegAlight

Stop/Station to alight

Service

1:1

+DatedJourney

Service that is used for this leg.

LegAttribute

0:*

+LegAttribute

Attributes that are not valid on the whole service, but only on parts of the journey leg.

OperatingDays

OperatingDays

0:1

+OperatingDays

Bit string definition of operating days.

OperatingDaysDescription

0:1

+InternationalText

Textual description of the operation days, e.g. "monday to friday" or "not on holidays".

LegTrack

0:1

+LegTrack

Geographic embedding of this leg.

ParallelService

0:*

+ParallelService

Services running combined with at least parts of this journey, e.g. wing trains. The contained stop sequence interval refers to the original journey.

OperatingDaysDescription

0:1

+InternationalText

Textual description of the operation days, e.g., "Monday to Friday" or "not on holidays".

LegTrack

0:1

+LegTrack

Geographic embedding of this leg.

ParallelService

0:*

+ParallelService

Services running combined with at least parts of this journey, e.g., wing trains. The contained stop sequence interval refers to the original journey.

Sustainability

EmissionCO2

0:1

+EmissionCO2

Estimation of CO2 emissions.

Extension

0:1

xs:anyType

11.17. The complex type TransferLegStructure

- - + + @@ -933,65 +933,65 @@

OJP - Open API for distributed Journey

-

TransferLegStructure

TRANSFER LEG or CONNECTION LEG according to TM 6.2. Description of a LEG which links other LEGs where a TRANSFER or CONNECTION between different LOCATIONs is required.

The element contains a sequence of the following elements:

TransferType

1:*

TransferType

TYPE that is used for this interchange between public services (TYPE OF TRANSFER, but also ACCESS MODE and PERSONAL MODE as far as a TRANSFER is concerned). In some constellations multiple TransferType are possible.

LegStart

1:1

+PlaceRef

Stop/Station/Place where boarding is done (can be a PLACE, SCHEDULED STOP POINT or a VEHICLE MEETING POINT)

LegEnd

1:1

+PlaceRef

Stop/Station/Place to alight (can be a PLACE, SCHEDULED STOP POINT or a VEHICLE MEETING POINT).

TimeWindow

TimeWindowStart

0:1

xs:dateTime

Time at which window begins.

TimeWindowEnd

0:1

xs:dateTime

Time at which window ends.

TransferDuration

Duration

1:1

xs:duration

Overall duration of this interchange (Transmodel: PT CONNECTION LEG.MEAN INTERCHANGE TIME).

WalkDuration

0:1

xs:duration

Walk time as part of the overall interchange duration (in Transmodel might be modeled as TRANSFER.CONNECTION.DefaultDuration).

BufferTime

0:1

xs:duration

Buffer time as part of the overall interchange duration. Buffer times, e.g. check in/out times, sometimes are mandatory for using certain services as e.g. airplanes, ferries or highspeed trains.

WalkDuration

0:1

xs:duration

Walk time as part of the overall interchange duration (in Transmodel might be modelled as TRANSFER.CONNECTION.DefaultDuration).

BufferTime

0:1

xs:duration

Buffer time as part of the overall interchange duration. Buffer times, e.g., check in/out times, sometimes are mandatory for using certain services as e.g., airplanes, ferries or highspeed trains.

Interchange

InterchangeRef

0:1

siri:InterchangeRefStructure

Reference of an INTERCHANGE.

ExtraInterchange

0:1

xs:boolean

Whether this interchange is an addition to the plan. Can only be used when both participants recognise the same schedule version. If omitted, defaults to 'false': the interchange is not an addition. (since SIRI 2.1)

TimeWindowEnd

0:1

xs:dateTime

Time at which window ends.

Duration

1:1

xs:duration

Duration of this leg according to user preferences like walking speed.

LegDescription

0:1

+InternationalText

Title or summary of this leg for overview.

Length

0:1

Length

Length of the leg.

LegTrack

0:1

+LegTrack

Detailed description of each element of this leg including geometric projection.

PathGuidance

0:1

+PathGuidance

Structured model further describing this interchange, its geographic embedding and accessibility (LEG.PATH GUIDANCE).

Feasibility

0:*

Feasibility

Information about the feasibility of the ContinuousLeg, in particular with respect to the access features used.

SituationFullRefs

0:1

+SituationRefList

A list of references to SITUATIONs.

Sustainability

EmissionCO2

0:1

+EmissionCO2

Estimation of CO2 emissions.

Extension

0:1

xs:anyType

11.19. The complex type LegBoardStructure

+

LegBoardStructure

Describes the the situation at a stop or station at which the passenger boards a Leg of a trip including time-related information.

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

Extension

0:1

xs:anyType

11.19. The complex type LegBoardStructure

- - + + - +

LegBoardStructure

Describes the situation at a stop or station at which the passenger boards a Leg of a trip including time-related information.

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

StopPoint

a

→‍siri:StopPointRef

1:1

→‍siri:StopPointRef

Reference to a stop point.

a

StopPointName

1:1

+InternationalText

Name or description of stop point for use in passenger information.

a

NameSuffix

0:1

+InternationalText

Additional description of the stop point that may be appended to the name if enough space is available. E.g. "opposite main entrance".

a

PlannedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. According to planned timetable.

a

EstimatedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. As to the latest realtime status.

b

GeoPosition

-1:1

siri:LocationStructure

ServiceArrival

0:1

+ServiceArrival

Contains ARRIVAL times (timetable, recorded, estimated, timing bands estimated) and the ARRIVAL formation.

ServiceDeparture

1:1

+ServiceDeparture

Contains DEPARTURE times (timetable, recorded, estimated, timing bands estimated) and the DEPARTURE formation.

DistributorInterchangeId

0:1

xs:normalizedString

Interchange identifier of the distributing line/service at its boarding. This is not a reference. This identifier is used to recognize in a distributed environment (e.g. EU-Spirit), that two systems refer to the same line (or service) while using their own internal references. In EU-Spirit this is used to decide whether an interchange is in fact a stay-seated scanario (aka "line ID"). See https://eu-spirit.eu/

MeetsViaRequest

0:1

xs:boolean

This stop fulfils one of the via requirements stated in the request data.

a

EstimatedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. As to the latest real-time status.

b

GeoPosition

-1:1

siri:LocationStructure

ServiceArrival

0:1

+ServiceArrival

Contains ARRIVAL times (timetable, recorded, estimated, timing bands estimated) and the ARRIVAL formation.

ServiceDeparture

1:1

+ServiceDeparture

Contains DEPARTURE times (timetable, recorded, estimated, timing bands estimated) and the DEPARTURE formation.

DistributorInterchangeId

0:1

xs:normalizedString

Interchange identifier of the distributing line/service at its boarding. This is not a reference. This identifier is used to recognize in a distributed environment (e.g., EU-Spirit), that two systems refer to the same line (or service) while using their own internal references. In EU-Spirit this is used to decide whether an interchange is in fact a stay-seated scanario (aka "line ID"). See https://eu-spirit.eu/

MeetsViaRequest

0:1

xs:boolean

This stop fulfils one of the via requirements stated in the request data.

StopCallStatus

Order

0:1

xs:positiveInteger

Sequence number of this stop in the service pattern of the journey.

RequestStop

0:1

xs:boolean

The vehicle journey calls at this stop only on demand.

UnplannedStop

0:1

xs:boolean

This stop has not been planned by the planning department.

NotServicedStop

0:1

xs:boolean

The vehicle will not call at this stop despite earlier planning.

NoBoardingAtStop

0:1

xs:boolean

Boarding will not be allowed at this stop of this journey.

NoAlightingAtStop

0:1

xs:boolean

Alighting will not be allowed at this stop of this journey.

The element contains a sequence of the following elements:

→‍siri:ExpectedDepartureOccupancy

0:*

→‍siri:ExpectedDepartureOccupancy

The Occupancy structure from SIRI can be used here. It is recommended to mainly have one ExpectedDepartureOccupancy for each FareClass and mainly focus on OccupancyLevel and OccupancyPercentage. For more details have a look at the SIRI documentation.

→‍siri:ExpectedDepartureCapacities

0:*

→‍siri:ExpectedDepartureCapacities

The Capacity structure also will probably rarely be used and parsed. When used, then it mainly show elements that are important for accessibility.

The element contains a sequence of the following elements:

→‍siri:ExpectedDepartureOccupancy

0:*

→‍siri:ExpectedDepartureOccupancy

The Occupancy structure from SIRI can be used here. It is recommended to mainly have one ExpectedDepartureOccupancy for each FareClass and mainly focus on OccupancyLevel and OccupancyPercentage. For more details have a look at the SIRI documentation.

→‍siri:ExpectedDepartureCapacities

0:*

→‍siri:ExpectedDepartureCapacities

The Capacity structure also will probably rarely be used and parsed. When used, then it mainly shows elements that are important for accessibility.

Attribute

0:*

+GeneralAttribute

Note or attribute.

11.20. The complex type LegAlightStructure

- - + + - +

LegAlightStructure

Describes the situation at a stop or station at which the passenger alights from a Leg of a trip including time-related information

The element contains a sequence of the following elements:

StopPoint

→‍siri:StopPointRef

1:1

→‍siri:StopPointRef

Reference to a stop point.

StopPointName

1:1

+InternationalText

Name or description of stop point for use in passenger information.

NameSuffix

0:1

+InternationalText

Additional description of the stop point that may be appended to the name if enough space is available. E.g. "opposite main entrance".

PlannedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. According to planned timetable.

EstimatedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. As to the latest realtime status.

ServiceArrival

1:1

+ServiceArrival

describes the arrival situation at the leg alight stop point ( group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME)

ServiceDeparture

0:1

+ServiceDeparture

describes the departure situation at this leg alight stop point (empty for last leg) ( group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME)

FeederInterchangeId

0:1

xs:normalizedString

Interchange identifier of the feeding line/service at its alighting. This is not a reference. This identifier is used to recognize in a distributed environment (e.g. EU-Spirit), that two systems refer to the same line (or service) while using their own internal references. In EU-Spirit this is used to decide whether an interchange is in fact a stay-seated scenario (aka "line id"). See https://eu-spirit.eu/

MeetsViaRequest

0:1

xs:boolean

This stop fulfils one of the via requirements stated in the request data.

EstimatedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. As to the latest real-time status.

ServiceArrival

1:1

+ServiceArrival

describes the arrival situation at the leg alight stop point (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME)

ServiceDeparture

0:1

+ServiceDeparture

describes the departure situation at this leg alight stop point (empty for last leg) (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME)

FeederInterchangeId

0:1

xs:normalizedString

Interchange identifier of the feeding line/service at its alighting. This is not a reference. This identifier is used to recognize in a distributed environment (e.g., EU-Spirit), that two systems refer to the same line (or service) while using their own internal references. In EU-Spirit this is used to decide whether an interchange is in fact a stay-seated scenario (aka "line id"). See https://eu-spirit.eu/

MeetsViaRequest

0:1

xs:boolean

This stop fulfils one of the via requirements stated in the request data.

StopCallStatus

Order

0:1

xs:positiveInteger

Sequence number of this stop in the service pattern of the journey.

RequestStop

0:1

xs:boolean

The vehicle journey calls at this stop only on demand.

UnplannedStop

0:1

xs:boolean

This stop has not been planned by the planning department.

NotServicedStop

0:1

xs:boolean

The vehicle will not call at this stop despite earlier planning.

NoBoardingAtStop

0:1

xs:boolean

Boarding will not be allowed at this stop of this journey.

NoAlightingAtStop

0:1

xs:boolean

Alighting will not be allowed at this stop of this journey.

The element contains a sequence of the following elements:

→‍siri:ExpectedDepartureOccupancy

0:*

→‍siri:ExpectedDepartureOccupancy

The Occupancy structure from SIRI can be used here. It is recommended to mainly have one ExpectedDepartureOccupancy for each FareClass and mainly focus on OccupancyLevel and OccupancyPercentage. For more details have a look at the SIRI documentation.

→‍siri:ExpectedDepartureCapacities

0:*

→‍siri:ExpectedDepartureCapacities

The Capacity structure also will probably rarely be used and parsed. When used, then it mainly show elements that are important for accessibility.

The element contains a sequence of the following elements:

→‍siri:ExpectedDepartureOccupancy

0:*

→‍siri:ExpectedDepartureOccupancy

The Occupancy structure from SIRI can be used here. It is recommended to mainly have one ExpectedDepartureOccupancy for each FareClass and mainly focus on OccupancyLevel and OccupancyPercentage. For more details have a look at the SIRI documentation.

→‍siri:ExpectedDepartureCapacities

0:*

→‍siri:ExpectedDepartureCapacities

The Capacity structure also will probably rarely be used and parsed. When used, then it mainly shows elements that are important for accessibility.

Attribute

0:*

+GeneralAttribute

Note or attribute.

11.21. The complex type LegIntermediateStructure

- - + + - + -

LegIntermediateStructure

Describes the situation at a stop or station that lies between the LegBoard and LegAlight stop or station including time-related information.

The element contains a sequence of the following elements:

StopPoint

→‍siri:StopPointRef

1:1

→‍siri:StopPointRef

Reference to a stop point.

StopPointName

1:1

+InternationalText

Name or description of stop point for use in passenger information.

NameSuffix

0:1

+InternationalText

Additional description of the stop point that may be appended to the name if enough space is available. E.g. "opposite main entrance".

PlannedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. According to planned timetable.

EstimatedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. As to the latest realtime status.

ServiceArrival

1:1

+ServiceArrival

describes the arrival situation a this leg board stop point (empty for first leg) ( group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME)

ServiceDeparture

1:1

+ServiceDeparture

describes the departure situation at this leg board stop point ( group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME)

MeetsViaRequest

0:1

xs:boolean

This stop fulfils one of the via requirements stated in the request data.

EstimatedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. As to the latest real-time status.

ServiceArrival

1:1

+ServiceArrival

describes the arrival situation at this leg board stop point (empty for first leg) (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME)

ServiceDeparture

1:1

+ServiceDeparture

describes the departure situation at this leg board stop point (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME)

MeetsViaRequest

0:1

xs:boolean

This stop fulfils one of the via requirements stated in the request data.

StopCallStatus

Order

0:1

xs:positiveInteger

Sequence number of this stop in the service pattern of the journey.

RequestStop

0:1

xs:boolean

The vehicle journey calls at this stop only on demand.

UnplannedStop

0:1

xs:boolean

This stop has not been planned by the planning department.

NotServicedStop

0:1

xs:boolean

The vehicle will not call at this stop despite earlier planning.

NoBoardingAtStop

0:1

xs:boolean

Boarding will not be allowed at this stop of this journey.

NoAlightingAtStop

0:1

xs:boolean

Alighting will not be allowed at this stop of this journey.

The element contains a sequence of the following elements:

→‍siri:ExpectedDepartureOccupancy

0:*

→‍siri:ExpectedDepartureOccupancy

The Occupancy structure from SIRI can be used here. It is recommended to mainly have one ExpectedDepartureOccupancy for each FareClass and mainly focus on OccupancyLevel and OccupancyPercentage. For more details have a look at the SIRI documentation.

→‍siri:ExpectedDepartureCapacities

0:*

→‍siri:ExpectedDepartureCapacities

The Capacity structure also will probably rarely be used and parsed. When used, then it mainly show elements that are important for accessibility.

The element contains a sequence of the following elements:

→‍siri:ExpectedDepartureOccupancy

0:*

→‍siri:ExpectedDepartureOccupancy

The Occupancy structure from SIRI can be used here. It is recommended to mainly have one ExpectedDepartureOccupancy for each FareClass and mainly focus on OccupancyLevel and OccupancyPercentage. For more details have a look at the SIRI documentation.

→‍siri:ExpectedDepartureCapacities

0:*

→‍siri:ExpectedDepartureCapacities

The Capacity structure also will probably rarely be used and parsed. When used, then it mainly shows elements that are important for accessibility.

Attribute

0:*

+GeneralAttribute

Note or attribute.

11.22. The complex type PathGuidanceStructure

PathGuidanceStructure

Description of a piece of a TRIP. May include geographic information, turn instructions and accessibility information.

The element contains only one element:

PathGuidanceSection

1:*

+PathGuidanceSection

A view of LEG TRACK including PATH JUNCTION information, PATH LINK information and PATH GUIDANCE. One or more path guidance sections that form the LEG. For a good PATH GUIDANCE a fine granularity of the sections may be needed. This may also depend on the MODE and the type of guidance required.

11.23. The complex type PathGuidanceSectionStructure

PathGuidanceSectionStructure

An extended definition of a NAVIGATION PATH in TMv6 and PATH GUIDANCE to include the textual navigation instructions. Description of a part of a TRIP. May include geographic information, turn instructions and accessibility information.

The element contains a sequence of the following elements:

TrackSection

0:1

+TrackSection

An aggregate of information that may be leaning on LEG TRACK together with duration and length that can be used for representing the leg on a map. The points may be STOP PLACE, SCHEDULED STOP POINT, coordinates or ADDRESSes.

TurnDescription

0:1

+InternationalText

Textual description of a traveller manoeuvre. Contains information from manoeuvre, TurnAction, and TrackSection.RoadName.

GuidanceAdvice

0:1

GuidanceAdvice

Various types of guidance advice given to traveller (according to Transmodel a view of a LEG TRACK and PATH GUIDANCE).

TurnAction

0:1

TurnAction

The range of possible turns that can be described (according to Transmodel a view of a LEG TRACK and PATH GUIDANCE).

RoadName

0:1

+InternationalText

Road name

Follow

0:*

+Follow

Signs, roads, POI to follow.

DirectionHint

0:1

+InternationalText

Textual direction hint for better understanding, e.g. "follow signs to Hamburg" (according to Transmodel a view of a LEG TRACK and PATH GUIDANCE).

AbsoluteBearing

0:1

siri:AbsoluteBearingType

Absolute bearing (sky direction) after the described manoeuvre.

PathLink

0:1

+PathLink

Description of the type of accessibility on this navigation section. This view is simplified in comparison to the NeTEx PathLink structure.

SituationFullRefs

0:1

+SituationRefList

A list of references to SITUATIONs.

11.24. The complex type FollowStructure

FollowStructure

The element contains one of the following elements:

a

FollowDirectionName

-1:1

+InternationalText

Follow a direction.

b

FollowExit

-1:1

+InternationalText

Follow an exit.

c

FollowRoadName

-1:1

+InternationalText

Follow a road/route.

d

FollowSignName

-1:1

+InternationalText

Follow a sign.

11.25. The TransferDurationGroup group

+

TransferDurationGroup

[an attribute of a CONNECTION (not INTERCHANGE) in TMv6] calculated duration in a response taking into ccount the request parameters.; TransferDuration plus waiting time is the minimum interval between arrival and departure time.

11.22. The complex type PathGuidanceStructure

PathGuidanceStructure

Description of a piece of a TRIP. May include geographic information, turn instructions and accessibility information.

The element contains only one element:

PathGuidanceSection

1:*

+PathGuidanceSection

A view of LEG TRACK including PATH JUNCTION information, PATH LINK information and PATH GUIDANCE. One or more path guidance sections that form the LEG. For a good PATH GUIDANCE, a fine granularity of the sections may be needed. This may also depend on the MODE and the type of guidance required.

11.23. The complex type PathGuidanceSectionStructure

PathGuidanceSectionStructure

An extended definition of a NAVIGATION PATH in TMv6 and PATH GUIDANCE to include the textual navigation instructions. Description of a part of a TRIP. May include geographic information, turn instructions and accessibility information.

The element contains a sequence of the following elements:

TrackSection

0:1

+TrackSection

An aggregate of information that may be leaning on LEG TRACK together with duration and length that can be used for representing the leg on a map. The points may be STOP PLACE, SCHEDULED STOP POINT, coordinates, or ADDRESSes.

TurnDescription

0:1

+InternationalText

Textual description of a traveller manoeuvre. Contains information from manoeuvre, TurnAction, and TrackSection.RoadName.

GuidanceAdvice

0:1

GuidanceAdvice

Several types of guidance advice given to traveller (according to Transmodel a view of a LEG TRACK and PATH GUIDANCE).

TurnAction

0:1

TurnAction

The range of possible turns that can be described (according to Transmodel a view of a LEG TRACK and PATH GUIDANCE).

RoadName

0:1

+InternationalText

Road name

Follow

0:*

+Follow

Signs, roads, POI to follow.

DirectionHint

0:1

+InternationalText

Textual direction hint for better understanding, e.g., "follow signs to Hamburg" (according to Transmodel a view of a LEG TRACK and PATH GUIDANCE).

AbsoluteBearing

0:1

siri:AbsoluteBearingType

Absolute bearing (sky direction) after the described manoeuvre.

PathLink

0:1

+PathLink

Description of the type of accessibility on this navigation section. This view is simplified in comparison to the NeTEx PathLink structure.

SituationFullRefs

0:1

+SituationRefList

A list of references to SITUATIONs.

11.24. The complex type FollowStructure

FollowStructure

The element contains one of the following elements:

a

FollowDirectionName

-1:1

+InternationalText

Follow a direction.

b

FollowExit

-1:1

+InternationalText

Follow an exit.

c

FollowRoadName

-1:1

+InternationalText

Follow a road/route.

d

FollowSignName

-1:1

+InternationalText

Follow a sign.

11.25. The TransferDurationGroup group

- - + +

TransferDurationGroup

[an attribute of a CONNECTION (not INTERCHANGE) in TMv6] calculated duration in a response taking into ccount the request parameters.; TransferDuration plus waiting time is the minimum interval between arrival and departure time.

TransferDuration

Duration

1:1

xs:duration

Overall duration of this interchange (Transmodel: PT CONNECTION LEG.MEAN INTERCHANGE TIME).

WalkDuration

0:1

xs:duration

Walk time as part of the overall interchange duration (in Transmodel might be modeled as TRANSFER.CONNECTION.DefaultDuration).

BufferTime

0:1

xs:duration

Buffer time as part of the overall interchange duration. Buffer times, e.g. check in/out times, sometimes are mandatory for using certain services as e.g. airplanes, ferries or highspeed trains.

WalkDuration

0:1

xs:duration

Walk time as part of the overall interchange duration (in Transmodel might be modelled as TRANSFER.CONNECTION.DefaultDuration).

BufferTime

0:1

xs:duration

Buffer time as part of the overall interchange duration. Buffer times, e.g., check in/out times, sometimes are mandatory for using certain services as e.g., airplanes, ferries or highspeed trains.

11.26. The InterchangeGroup group

-

InterchangeGroup

Adding interchange elements from SIRI to a transfer leg.

Interchange

InterchangeRef

0:1

siri:InterchangeRefStructure

Reference of an INTERCHANGE.

ExtraInterchange

0:1

xs:boolean

Whether this interchange is an addition to the plan. Can only be used when both participants recognise the same schedule version. If omitted, defaults to 'false': the interchange is not an addition. (since SIRI 2.1)

InterchangeCancellation

0:1

xs:boolean

Whether this interchange is a cancellation of a previously announced interchange (or planned according to the long-term timetable. Can only be used when both participants recognise the same schedule version. If omitted, defaults to 'false': the interchange is not cancelled. (since SIRI 2.1)

→‍siri:InterchangePropertyGroup

11.27. The complex type PathLinkStructure

PathLinkStructure

[TMv6] a link within a PLACE of or between two PLACEs (that is STOP PLACEs, ACCESS SPACEs or QUAYs, BOARDING POSITIONs, POINTs OF INTEREST etc or PATH JUNCTIONs) that represents a step in a possible route for pedestrians, cyclists or other out-of-vehicle passengers within or between a PLACE. Here we use a reduced form of a PATH LINK containing the description of the type of accessibility on this navigation section.

The element contains a sequence of the following elements:

Transition

0:1

Transition

Whether path is up, down or level.

AccessFeatureType

0:1

AccessFeatureType

Type of physical feature of PATH LINK.

Count

0:1

xs:positiveInteger

Number indicating how often the access feature occurs in this PathLink

AccessFeatureStatus

0:1

AccessFeatureStatus

Whether the access feature is available or out of service.

AccessFeatureStatusText

0:1

+InternationalText

Textual information about reduced availability of the access feature, in particular if AccessFeatureStatus is partiallyAvailable.

AccessibilityFeature

0:*

AccessibilityFeatureTypes

Presence of an accessibility feature on the PathLink.

→‍SituationFullRef

0:*

→‍SituationFullRef

Reference to a situation that affects the availability of the access feature.

From

0:1

+PathLinkEnd

Designations of level and place where this PathLink starts.

To

0:1

+PathLinkEnd

Designations of level and place where this PathLink ends.

11.28. The complex type PathLinkEndStructure

PathLinkEndStructure

Designations of a floor/level.

The element contains a sequence of the following elements:

LevelPublicCode

0:1

xs:normalizedString

Public identifier of the level as found on elevators and signs.

LevelName

0:1

+InternationalText

Official name of the level.

Id

0:1

PlaceObjectId

Id of the element at this end of the PathLink (typically a PLACE, e.g. where the elevator is located).

11.29. The MultiPointTripRequestGroup group

+

MultiPointTripRequestGroup

Multi-point trip request structure.

11.27. The complex type PathLinkStructure

PathLinkStructure

[TMv6] a link within a PLACE of or between two PLACEs (that is STOP PLACEs, ACCESS SPACEs or QUAYs, BOARDING POSITIONs, POINTs OF INTEREST etc or PATH JUNCTIONs) that represents a step in a possible route for pedestrians, cyclists, or other out-of-vehicle passengers within or between a PLACE. Here we use a reduced form of a PATH LINK containing the description of the type of accessibility on this navigation section.

The element contains a sequence of the following elements:

Transition

0:1

Transition

Whether path is up, down, or level.

AccessFeatureType

0:1

AccessFeatureType

Type of physical feature of PATH LINK.

Count

0:1

xs:positiveInteger

Number indicating how often the access feature occurs in this PathLink

AccessFeatureStatus

0:1

AccessFeatureStatus

Whether the access feature is available or out of service.

AccessFeatureStatusText

0:1

+InternationalText

Textual information about reduced availability of the access feature, in particular if AccessFeatureStatus is partiallyAvailable.

AccessibilityFeature

0:*

AccessibilityFeatureTypes

Presence of an accessibility feature on the PathLink.

→‍SituationFullRef

0:*

→‍SituationFullRef

Reference to a situation that affects the availability of the access feature.

From

0:1

+PathLinkEnd

Designations of level and place where this PathLink starts.

To

0:1

+PathLinkEnd

Designations of level and place where this PathLink ends.

11.28. The complex type PathLinkEndStructure

PathLinkEndStructure

Designations of a floor/level.

The element contains a sequence of the following elements:

LevelPublicCode

0:1

xs:normalizedString

Public identifier of the level as found on elevators and signs.

LevelName

0:1

+InternationalText

Official name of the level.

Id

0:1

PlaceObjectId

Id of the element at this end of the PathLink (typically a PLACE, e.g., where the elevator is located).

11.29. The MultiPointTripRequestGroup group

- + @@ -1004,7 +1004,7 @@

OJP - Open API for distributed Journey

- + @@ -1015,8 +1015,8 @@

OJP - Open API for distributed Journey

- - + + | | `easy` | @@ -1065,10 +1065,10 @@

OJP - Open API for distributed Journey

- + - + @@ -1083,9 +1083,9 @@

OJP - Open API for distributed Journey

- + - + @@ -1096,10 +1096,10 @@

OJP - Open API for distributed Journey

- + - + @@ -1108,7 +1108,7 @@

OJP - Open API for distributed Journey

MultiPointTripRequestGroup

Multi-point trip request structure.

MultiPointTripRequest

Origin

1:*

+PlaceContext

Specifies the origin situation from where the user wants to start.

Destination

1:*

+PlaceContext

Specifies the destination situation where the user is heading to.

Via

0:*

+TripVia

Ordered series of points where the journey must pass through. If more than one via point is given all of them must be obeyed - in the correct order. The server is allowed to replace a via stop by equivalent stops (in Transmodel modeled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia).

Via

0:*

+TripVia

Ordered series of points where the journey must pass through. If more than one via point is given all of them must be obeyed - in the correct order. The server is allowed to replace a via stop by equivalent stops (in Transmodel modelled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia).

NotVia

0:*

+NotVia

Not-via restrictions for a TRIP, i.e. SCHEDULED STOP POINTs or STOP PLACEs that the TRIP is not allowed to pass through. If more than one not via point is given all of them must be obeyed.

NoChangeAt

0:*

+NoChangeAt

no-change-at restrictions for a TRIP, i.e. SCHEDULED STOP POINTs or STOP PLACEs at which no TRANSFER is allowed within a TRIP (in Transmodel this would be an extension to TRIP MOBILITY FILTER).

Params

0:1

+MultiPointTripParam

Options to control the search behaviour and response contents.

BaseTripMobilityFilter

NoSingleStep

0:1

xs:boolean

The user is not able to pass over (or wants to avoid) single steps. Stairs and non-level entrances are not excluded.

NoStairs

0:1

xs:boolean

The user is not able to walk up/down stairs.

NoStairs

0:1

xs:boolean

The user is not able to walk up/downstairs.

NoEscalator

0:1

xs:boolean

The user is not able to use an escalator.

NoElevator

0:1

xs:boolean

The user is not able to use an elevator.

NoRamp

0:1

xs:boolean

The user is not able to use a ramp.

TripMobilityFilter

BikeTransport

0:1

xs:boolean

The user wants to carry a bike on public transport (could be extended in future to transporting big luggage/animals/etc).

WalkSpeed

0:1

OpenPercent

Deviation from average walking speed in percent. 100% percent is average speed. Less than 100 % slower, Greater than 150% faster.

AdditionalTransferTime

0:1

xs:duration

Additional time added to all transfers (also to transfers between individual to public transport, not modeled in Transmodel).

HikingProfile

0:1

Users hiking profile. The main element to control general walking behaviour is WalkSpeed (together with accessibility constraints). Note: possible explanations in German can be found here: https://akademie.alpinewelten.com/bergwandern/klassifizierung-von-wanderwegen

AdditionalTransferTime

0:1

xs:duration

Additional time added to all transfers (also to transfers between individual to public transport, not modelled in Transmodel).

HikingProfile

0:1

Users hiking profile. The main element to control general walking behaviour is WalkSpeed (together with accessibility constraints). Note: explanations in German can be found here: https://akademie.alpinewelten.com/bergwandern/klassifizierung-von-wanderwegen

Then, the element contains one of the following elements:

NumberOfResults

a

NumberOfResultsBefore

0:1

xs:nonNegativeInteger

The desired number of trip results before the given time (at origin or destination).

a

NumberOfResultsAfter

0:1

xs:nonNegativeInteger

The desired number of trip results after the given time (at origin or destination).

BaseTripPolicy

b

NumberOfResults

-0:1

xs:positiveInteger

The number of trip results that the user wants to see at least (TRIP REQUEST POLICY.maximumNumberofJourneys). Be aware that some implementatins will deliver one of the TripResults before the indicated departure time. This means one always has to check the results against the parameters before using them.

BaseTripPolicy

b

NumberOfResults

-0:1

xs:positiveInteger

The number of trip results that the user wants to see at least (TRIP REQUEST POLICY.maximumNumberofJourneys). Be aware that some implementations will deliver one of the TripResults before the indicated departure time. This means one always must check the results against the parameters before using them.

TimeWindow

0:1

xs:duration

Time window in which the trips should be, starting from the time specified in PlaceContext. Implements TRIP REQUEST.FlexibilityWindow. All trips within the window should be provided by the implementation.

UseRealtimeData

0:1

UseRealtimeData

The way real-time data should be used in the calculation of the trip.

ImmediateTripStart

0:1

xs:boolean

Whether the trip calculation should find a solution that starts immediately (e.g. because the user is already on the way) instead of finding the latest possible start opportunity. Default is FALSE.

ImmediateTripStart

0:1

xs:boolean

Whether the trip calculation should find a solution that starts immediately (e.g., because the user is already on the way) instead of finding the latest possible start opportunity. Default is FALSE.

TransferLimit

0:1

xs:nonNegativeInteger

The maximum number of interchanges the user will accept per trip.

OptimisationMethod

0:1

OptimisationMethod

The type of algorithm to be used in the calculation of the trip (fastest, least walking, etc.).

ConsiderElevationData

0:1

xs:boolean

Whether the trip calculation should take elevation data into account (bike, foot). Default is FALSE.

IncludeTurnDescription

0:1

xs:boolean

Whether the result should include turn-by-turn instructions for each journey leg.

IncludeAccessFeatures

0:1

xs:boolean

Whether the result should include the access features (stairs, elevator, etc.) on each path link.

IncludeAccessFeaturesStatus

0:1

xs:boolean

Whether the result should include real time status of access features to indicate broken equipment.

IncludeAccessibilityDetails

0:*

AccessibilityDetailsProfile

Which accessibility features and other accessibility-related information to retrieve (e.g. guidance text for the visually impaired).

IncludeAccessibilityDetails

0:*

AccessibilityDetailsProfile

Which accessibility features and other accessibility-related information to retrieve (e.g., guidance text for the visually impaired).

IncludePlacesContext

0:1

xs:boolean

Whether the place context is needed. If a requestor has that information already, the response can be made slimmer, when set to false. Default is true.

IncludeSituationsContext

0:1

xs:boolean

Wheter the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true

IncludeSituationsContext

0:1

xs:boolean

Whether the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true.

TripContentFilter

IncludeIntermediateStops

0:1

xs:boolean

Whether the result should include intermediate stops (between the passenger's board and alight stops).

IncludeFare

0:1

xs:boolean

Whether the result should include fare information.

The element contains one of the following elements:

NumberOfResults

a

NumberOfResultsBefore

0:1

xs:nonNegativeInteger

The desired number of trip results before the given time (at origin or destination).

a

NumberOfResultsAfter

0:1

xs:nonNegativeInteger

The desired number of trip results after the given time (at origin or destination).

BaseTripPolicy

b

NumberOfResults

-0:1

xs:positiveInteger

The number of trip results that the user wants to see at least (TRIP REQUEST POLICY.maximumNumberofJourneys). Be aware that some implementatins will deliver one of the TripResults before the indicated departure time. This means one always has to check the results against the parameters before using them.

BaseTripPolicy

b

NumberOfResults

-0:1

xs:positiveInteger

The number of trip results that the user wants to see at least (TRIP REQUEST POLICY.maximumNumberofJourneys). Be aware that some implementations will deliver one of the TripResults before the indicated departure time. This means one always must check the results against the parameters before using them.

TimeWindow

0:1

xs:duration

Time window in which the trips should be, starting from the time specified in PlaceContext. Implements TRIP REQUEST.FlexibilityWindow. All trips within the window should be provided by the implementation.

UseRealtimeData

0:1

UseRealtimeData

The way real-time data should be used in the calculation of the trip.

ImmediateTripStart

0:1

xs:boolean

Whether the trip calculation should find a solution that starts immediately (e.g. because the user is already on the way) instead of finding the latest possible start opportunity. Default is FALSE.

ImmediateTripStart

0:1

xs:boolean

Whether the trip calculation should find a solution that starts immediately (e.g., because the user is already on the way) instead of finding the latest possible start opportunity. Default is FALSE.

TransferLimit

0:1

xs:nonNegativeInteger

The maximum number of interchanges the user will accept per trip.

OptimisationMethod

0:1

OptimisationMethod

The type of algorithm to be used in the calculation of the trip (fastest, least walking, etc.).

ConsiderElevationData

0:1

xs:boolean

Whether the trip calculation should take elevation data into account (bike, foot). Default is FALSE.

MultiPointTripPolicy

MultiPointType

1:1

MultiPointType

If a solution for any one of multiple origin/destination points is sufficient. Or a distinct solution for each of the origin/destination points has to be found.

11.32. The MultiPointTripResponseGroup group

- +

MultiPointTripResponseGroup

Multi-point trip response structure.

MultiPointTripResponse

MultiPointType

0:1

MultiPointType

The MultiPointType should be returned, because it may differ from the one asked. Many systems will support only a subset of the MultiPointTypes and it is important to know, what the result is based on.

MultiPointTripResponse

MultiPointType

0:1

MultiPointType

The MultiPointType should be returned because it may differ from the one asked. Many systems will support only a subset of the MultiPointTypes and it is important to know, what the result is based on.

MultiPointTripResponseContext

0:1

+ResponseContext

Context to hold trip response objects that occur frequently.

MultiPointTripResult

0:*

+MultiPointTripResult

The trip results found by the server.

11.33. The complex type MultiPointTripResultStructure

@@ -1117,7 +1117,7 @@

OJP - Open API for distributed Journey

MultiPointTripResultStructure

Structure for a multipoint trip result and associated problems

The element contains a sequence of the following elements:

Id

1:1

MultiPoint

Id of this trip result for referencing purposes. Unique within multipoint-trip response.

ErrorCondition

0:*

+OJPError

Problems related to this trip result.

Then, the element contains one of the following elements:

a

Trip

-1:1

+Trip

Information on the trip.

b

TripSummary

-1:1

+TripSummary

Summary on trip. Only if requestor set TripSummaryOnly in request.

TripFare

0:*

+TripFareResult

Fare and fare product information for this trip as a whole or parts of it.

11.34. The MultiPointWaitTimeGroup group

-

MultiPointWaitTimeGroup

Group for wait times at origin/destination.

MultiPointWaitTime

OriginWaitTime

0:1

xs:duration

Additional wait time at origin of this trip.

DestinationWaitTime

0:1

xs:duration

Additional wait time at destination of this trip.

11.35. The TripStatusGroup group

+

TripStatusGroup

Parameters which describe the current status of a TRIP (will be added to MONITORED TRIP in Transmodel).

11.35. The TripStatusGroup group

@@ -1127,10 +1127,10 @@

OJP - Open API for distributed Journey

-

TripStatusGroup

Parameters which describe the status of a TRIP (will be added to MONITORED TRIP in Transmodel).

TripStatus

Unplanned

0:1

xs:boolean

Whether this trip is an additional one that has not been planned. Default is false.

Cancelled

0:1

xs:boolean

Whether this trip is cancelled and will not be run. Default is false.

Deviation

0:1

xs:boolean

Whether this trip deviates from the planned service pattern. Default is false.

TripRefineRequest

RefineParams

0:1

+TripRefineParam

Options to control the refine

TripResult

1:1

+TripResult

The trip result to be refined by the server.

TripResponseContext

0:1

+ResponseContext

Context to hold objects, which are referenced within the response.

11.37. The complex type TripRefineParamStructure

+

TripRefineParamStructure

Trip refinement request parameter structure.

The element contains a sequence of the following elements:

ForeignObjectRefs

0:1

xs:boolean

If true, then the request may contain object references from another system. Default is FALSE.

RefineLegRef

1:*

LegObjectId

Refers to the legs to be refined by the server. If none is given, then all legs are open for refinement (depending if the relevant system can refine them).

SystemId

0:1

xs:normalizedString

System reference to use for the refinement. If not specified the origin systems of each leg are used for the refinement.

11.37. The complex type TripRefineParamStructure

- + @@ -1141,8 +1141,8 @@

OJP - Open API for distributed Journey

- - + + | | `easy` | @@ -1191,17 +1191,17 @@

OJP - Open API for distributed Journey

- + - + - + @@ -1209,9 +1209,9 @@

OJP - Open API for distributed Journey

- + - + @@ -1225,7 +1225,7 @@

OJP - Open API for distributed Journey

-

TripRefineParamStructure

Trip refinement request parameter structure.

The element contains a sequence of the following elements:

ForeignObjectRefs

0:1

xs:boolean

If true, then the request may contain object references from another system. Default is FALSE.

RefineLegRef

1:*

LegObjectId

Refers to the legs to be refined by the server. If none is given, then all legs are open for refinement (depending on if the relevant system can refine them).

SystemId

0:1

xs:normalizedString

System reference to use for the refinement. If not specified, the origin systems of each leg are used for the refinement.

BaseTripMobilityFilter

NoSingleStep

0:1

xs:boolean

The user is not able to pass over (or wants to avoid) single steps. Stairs and non-level entrances are not excluded.

NoStairs

0:1

xs:boolean

The user is not able to walk up/down stairs.

NoStairs

0:1

xs:boolean

The user is not able to walk up/downstairs.

NoEscalator

0:1

xs:boolean

The user is not able to use an escalator.

NoElevator

0:1

xs:boolean

The user is not able to use an elevator.

NoRamp

0:1

xs:boolean

The user is not able to use a ramp.

TripMobilityFilter

BikeTransport

0:1

xs:boolean

The user wants to carry a bike on public transport (could be extended in future to transporting big luggage/animals/etc).

WalkSpeed

0:1

OpenPercent

Deviation from average walking speed in percent. 100% percent is average speed. Less than 100 % slower, Greater than 150% faster.

AdditionalTransferTime

0:1

xs:duration

Additional time added to all transfers (also to transfers between individual to public transport, not modeled in Transmodel).

HikingProfile

0:1

Users hiking profile. The main element to control general walking behaviour is WalkSpeed (together with accessibility constraints). Note: possible explanations in German can be found here: https://akademie.alpinewelten.com/bergwandern/klassifizierung-von-wanderwegen

AdditionalTransferTime

0:1

xs:duration

Additional time added to all transfers (also to transfers between individual to public transport, not modelled in Transmodel).

HikingProfile

0:1

Users hiking profile. The main element to control general walking behaviour is WalkSpeed (together with accessibility constraints). Note: explanations in German can be found here: https://akademie.alpinewelten.com/bergwandern/klassifizierung-von-wanderwegen

Then, the element contains one of the following elements:

NumberOfResults

a

NumberOfResultsBefore

0:1

xs:nonNegativeInteger

The desired number of trip results before the given time (at origin or destination).

a

NumberOfResultsAfter

0:1

xs:nonNegativeInteger

The desired number of trip results after the given time (at origin or destination).

BaseTripPolicy

b

NumberOfResults

-0:1

xs:positiveInteger

The number of trip results that the user wants to see at least (TRIP REQUEST POLICY.maximumNumberofJourneys). Be aware that some implementatins will deliver one of the TripResults before the indicated departure time. This means one always has to check the results against the parameters before using them.

BaseTripPolicy

b

NumberOfResults

-0:1

xs:positiveInteger

The number of trip results that the user wants to see at least (TRIP REQUEST POLICY.maximumNumberofJourneys). Be aware that some implementations will deliver one of the TripResults before the indicated departure time. This means one always must check the results against the parameters before using them.

TimeWindow

0:1

xs:duration

Time window in which the trips should be, starting from the time specified in PlaceContext. Implements TRIP REQUEST.FlexibilityWindow. All trips within the window should be provided by the implementation.

UseRealtimeData

0:1

UseRealtimeData

The way real-time data should be used in the calculation of the trip.

ImmediateTripStart

0:1

xs:boolean

Whether the trip calculation should find a solution that starts immediately (e.g. because the user is already on the way) instead of finding the latest possible start opportunity. Default is FALSE.

ImmediateTripStart

0:1

xs:boolean

Whether the trip calculation should find a solution that starts immediately (e.g., because the user is already on the way) instead of finding the latest possible start opportunity. Default is FALSE.

TransferLimit

0:1

xs:nonNegativeInteger

The maximum number of interchanges the user will accept per trip.

OptimisationMethod

0:1

OptimisationMethod

The type of algorithm to be used in the calculation of the trip (fastest, least walking, etc.).

ConsiderElevationData

0:1

xs:boolean

Whether the trip calculation should take elevation data into account (bike, foot). Default is FALSE.

IncludeAllRestrictedLines

0:1

xs:boolean

There might exist lines that have special restrictions and are not generally available to the public. E.g. school buses, company shuttles. dragLifts need to have an ACCESS MODE ski. Lines with ACCESS MODE bicycle will be included as well. If this flag is set, then existing restricted lines are considered by the router, irrespective of the selected passenger categories or the MotorisedMainTravelMode. The results are marked as restricted in the ServiceGroup. The usage could also be detailed with Attribute elements. Restricted trumps PassengerCategory, for example. If Restricted is set to true, all services are displayed.

PassengerCategory

0:*

PassengerCategory

Sequence of all passenger categories, for which this search shall be conducted. In rare cases additional offerings may be available (e.g., demand responsive service with certain areas being reserved for seniors). If multiple PassengerCategories are provided, then Services are shown when they are available for at least one PassengerCategory.

Then, the element contains one of the following elements:

The element contains a sequence of the following elements:

TripPolicy

ItModeToCover

-0:*

+ItModes

For each MODE or MODE OF OPERATION combination in this list a separate monomodal trip shall be found - in addition to inter-modal solutions.

IncludeAlternativeOptions

-0:1

xs:boolean

Whether alternative options should be presented as well. Mainly important for dominated journeys or in the case of ContinuousLegs the second-best route. Should be optimised for the user expectance (see. e.g https://theses.hal.science/tel-01848737). However, what the alternative options are may vary widely depending on the optimisation methods and filters.

b

MotorisedMainTravelMode

-0:1

xs:boolean

The MotorisedMainTravelMode defines whether the trip planner works in PT mode (or pure IT mode) or includes carTransportRail and the like. If set to true (e.g. because one travels by car, truck or motorcycle), then carTransportRail, ferry are used together with roads.

Then, the element contains one of the following elements:

The element contains a sequence of the following elements:

TripPolicy

ItModeToCover

-0:*

+ItModes

For each MODE or MODE OF OPERATION combination in this list a separate monomodal trip shall be found - in addition to inter-modal solutions.

IncludeAlternativeOptions

-0:1

xs:boolean

Whether alternative options should be presented as well. Mainly important for dominated journeys or in the case of ContinuousLegs the second-best route. Should be optimised for the user expectance (see. e.g https://theses.hal.science/tel-01848737). However, what the alternative options are may vary widely depending on the optimisation methods and filters.

b

MotorisedMainTravelMode

-0:1

xs:boolean

The MotorisedMainTravelMode defines whether the trip planner works in PT mode (or pure IT mode) or includes carTransportRail and the like. If set to true (e.g., because one travels by car, truck or motorcycle), then carTransportRail, ferry are used together with roads.

BaseTripContentFilter

IncludeTrackSections

0:1

xs:boolean

Whether the result should include TrackSection elements to describe the geographic route of each journey leg.

IncludeTurnDescription

0:1

xs:boolean

Whether the result should include turn-by-turn instructions for each journey leg.

IncludeAccessFeatures

0:1

xs:boolean

Whether the result should include the access features (stairs, elevator, etc.) on each path link.

IncludeAccessFeaturesStatus

0:1

xs:boolean

Whether the result should include real time status of access features to indicate broken equipment.

IncludeAccessibilityDetails

0:*

AccessibilityDetailsProfile

Which accessibility features and other accessibility-related information to retrieve (e.g. guidance text for the visually impaired).

IncludeAccessibilityDetails

0:*

AccessibilityDetailsProfile

Which accessibility features and other accessibility-related information to retrieve (e.g., guidance text for the visually impaired).

IncludePlacesContext

0:1

xs:boolean

Whether the place context is needed. If a requestor has that information already, the response can be made slimmer, when set to false. Default is true.

IncludeSituationsContext

0:1

xs:boolean

Wheter the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true

IncludeSituationsContext

0:1

xs:boolean

Whether the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true.

TripContentFilter

IncludeIntermediateStops

0:1

xs:boolean

Whether the result should include intermediate stops (between the passenger's board and alight stops).

IncludeFare

0:1

xs:boolean

Whether the result should include fare information.

TripChangeRequest

ChangeParams

0:1

+TripChangeParam

Options to control the change.

TripResult

1:1

+TripResult

The trip result to be changed by the server.

TripResponseContext

0:1

+ResponseContext

Context to hold objects, which are referenced within the response.

11.41. The complex type TripChangeParamStructure

TripChangeParamStructure

Trip change request parameter structure.

The element contains a sequence of the following elements:

ChangeLegRef

1:1

LegObjectId

Refers to the leg to be adapted by the server. Typical usage: either a transfer leg representing an interchange that is considered too short or a sharing leg for which the exact times shall be retrieved for a specific operator.

SystemId

0:1

xs:normalizedString

System reference to use for the refinement. If not specified the origin systems of each leg are used for the refinement.

ExtendToFrontOrBack

0:1

Extend

Whether to extend the initial time interval of the ChangeLeg towards the front or the back of the trip (earlier respectively later times).

AdditionalWaitingTime

0:1

xs:duration

Absolute time in minutes the passenger wants additionally to make the interchange. If another TransferLeg is needed (e.g. since another quay is used for the found arrival/departure) this is taken into account. If not passed, the next best arrival/departure is requested.

TripParams

0:1

+TripParam

Options to control the search behaviour and response contents. They should be largely the same as used as in the initial OJPTripRequest.

Extension

0:1

xs:anyType

11.42. The TripChangeResponseGroup group

+

TripChangeResponseGroup

Trip change response structure.

11.41. The complex type TripChangeParamStructure

TripChangeParamStructure

Trip change request parameter structure.

The element contains a sequence of the following elements:

ChangeLegRef

1:1

LegObjectId

Refers to the leg to be adapted by the server. Typical usage: either a transfer leg representing an interchange that is considered too short or a sharing leg for which the exact times shall be retrieved for a specific operator.

SystemId

0:1

xs:normalizedString

System reference to use for the refinement. If not specified, the origin systems of each leg are used for the refinement.

ExtendToFrontOrBack

0:1

Extend

Whether to extend the initial time interval of the ChangeLeg towards the front or the back of the trip (earlier respectively later times).

AdditionalWaitingTime

0:1

xs:duration

Absolute time in minutes the passenger wants additionally to make the interchange. If another TransferLeg is needed (e.g., since another quay is used for the found arrival/departure) this is taken into account. If not passed, the next best arrival/departure is requested.

TripParams

0:1

+TripParam

Options to control the search behaviour and response contents. They should be largely the same as used as in the initial OJPTripRequest.

Extension

0:1

xs:anyType

11.42. The TripChangeResponseGroup group

TripChangeResponseGroup

Trip change response structure.

TripChangeResponse

TripResponseContext

0:1

+ResponseContext

Context to hold trip response objects that occur frequently.

TripResult

0:1

+TripResult

The trip results refined by the server.

11.43. The toplevel element TripChangeProblemType

TripChangeProblemType

TripChangeProblemType (↔ ErrorType)

@@ -1234,8 +1234,8 @@

OJP - Open API for distributed Journey

StopPointName

1:1

+InternationalText

Name or description of stop point for use in passenger information.

NameSuffix

0:1

+InternationalText

Additional description of the stop point that may be appended to the name if enough space is available. E.g. "opposite main entrance".

PlannedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. According to planned timetable.

EstimatedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. As to the latest realtime status.

DisplayPriority

0:1

Priority

Priority of this via point to be displayed when space is limited.

12.3. The complex type ProductCategoryStructure

ProductCategoryStructure

Product category based on NeTEx/SIRI. A product category is a classification for VEHICLE JOURNEYs to express some common properties of journeys for marketing and fare products.

The element contains a sequence of the following elements:

Name

0:1

+InternationalText

Full name of this product category, e.g. "Autoreisezug" in Switzerland or "Dampfschiff"

ShortName

0:1

+InternationalText

Short name or acronym of the product category, likely to be published, e.g. "BAV", "ARZ", "TGV". The product category is more important for publication in Switzerland than Mode / Submode.

→‍ProductCategoryRef

0:1

→‍ProductCategoryRef

A reference to the product category. This is the internal code used within the reference frameworks (NeTEx, SIRI). It is usually not displayed, but interpreted by the technical system, e.g. "ch:1:TypeOfProductCategory:ARZ" (Autoreisezug in Switzerland) or "ch:1:TypeOfProductCategory:BAV".

12.4. The complex type TripViaStructure

TripViaStructure

VIA restrictions for a TRIP.

The element contains a sequence of the following elements:

ViaPoint

1:1

+PlaceRef

Reference to specify the via place.

DwellTime

0:1

xs:duration

Duration the passenger wants to stay at the via place. Default is 0.

12.5. The complex type ParallelServiceStructure

+ +

ParallelServiceStructure

Services running combined with at least parts of this journey, e.g. wing trains. The contained stop sequence interval refers to the original journey.

The element contains a sequence of the following elements:

EstimatedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. As to the latest real-time status.

DisplayPriority

0:1

Priority

Priority of this via point to be displayed when space is limited.

12.3. The complex type ProductCategoryStructure

ProductCategoryStructure

Product category based on NeTEx/SIRI. A product category is a classification for VEHICLE JOURNEYs to express some common properties of journeys for marketing and fare products.

The element contains a sequence of the following elements:

Name

0:1

+InternationalText

Full name of this product category, e.g., "Autoreisezug" in Switzerland or "Dampfschiff"

ShortName

0:1

+InternationalText

Short name or acronym of the product category, likely to be published, e.g., "BAV", "ARZ", "TGV". The product category is more important for publication in Switzerland than Mode / Submode.

→‍ProductCategoryRef

0:1

→‍ProductCategoryRef

A reference to the product category. This is the internal code used within the reference frameworks (NeTEx, SIRI). It is usually not displayed, but interpreted by the technical system, e.g., "ch:1:TypeOfProductCategory:ARZ" (Autoreisezug in Switzerland) or "ch:1:TypeOfProductCategory:BAV".

12.4. The complex type TripViaStructure

TripViaStructure

VIA restrictions for a TRIP.

The element contains a sequence of the following elements:

ViaPoint

1:1

+PlaceRef

Reference to specify the via place.

DwellTime

0:1

xs:duration

Duration the passenger wants to stay at the via place. Default is 0.

12.5. The complex type ParallelServiceStructure

@@ -1243,14 +1243,14 @@

OJP - Open API for distributed Journey

- - + + - - - - + + + + @@ -1279,14 +1279,14 @@

OJP - Open API for distributed Journey

- - + + - - - - + + + + @@ -1312,14 +1312,14 @@

OJP - Open API for distributed Journey

- - + + - - - - + + + + @@ -1345,7 +1345,7 @@

OJP - Open API for distributed Journey

ParallelServiceStructure

Services running combined with at least parts of this journey, e.g., wing trains. The contained stop sequence interval refers to the original journey.

The element contains a sequence of the following elements:

StopSequenceInterval

FromStopSequenceNumber

0:1

xs:positiveInteger

Stop sequence number, where the interval begins (inclusive). If missing, the interval begins at the beginning of the leg (or at the beginning of the journey for uses in StopEvents and TripInfo).

ToStopSequenceNumber

0:1

xs:positiveInteger

Stop sequence number, where the interval ends (inclusive). If missing, the interval ends at the end of the leg (or at the end of the journey for uses in StopEvents and TripInfo).

PublicCode

0:1

xs:normalizedString

Public code of the SERVICE JOURNEY (same meaning as in NeTEx). Examples: "512", "S8" or "Circle Line" or "ICE 488".

→‍siri:LineDirectionGroup

Service

Mode

1:1

+Mode

[a specialisation of MODE in TMv6] an extended range of VEHICLE MODEs, aggregating them with some SUBMODEs

ProductCategory

0:1

+ProductCategory

A product category for the service. This is a classification defined in NeTEx/SIRI used to identify groups of journeys with some special properties for marketing and fare products, e.g. "TE2" for SNCF or a special panorama train "PE" in Switzerland.

PublishedServiceName

1:1

+InternationalText

Line name or service description as known to the public, e.g. "512", "S8" or "Circle Line" or "ICE 488".

ProductCategory

0:1

+ProductCategory

A product category for the service. This is a classification defined in NeTEx/SIRI used to identify groups of journeys with some special properties for marketing and fare products, e.g., "TE2" for SNCF or a special panorama train "PE" in Switzerland.

PublishedServiceName

1:1

+InternationalText

Line name or service description as known to the public, e.g., "512", "S8" or "Circle Line" or "ICE 488".

TrainNumber

0:1

xs:normalizedString

Contains the TrainNumber from NeTEx (TRAIN NUMBER from Transmodel). If several TrainNumber types exist, use the commercial one. In some cases also non-train modes will use TrainNumber.

→‍siri:VehicleRef

0:1

→‍siri:VehicleRef

Contains the Vehicle reference of the vehicle. In Transmodel this may be the VEHICLE Id.

OperatorRefs

0:1

+OperatorRefs_Rel

References to the OPERATORS. Multiple OPERATORS in case a ContinuousLeg can be operated by more than one operator, especially in the ALTERNATIVE MODE OF OPERATION where there can be dozens of taxi companies and many free floating sharing companies.

RouteDescription

0:1

+InternationalText

Descriptive text for a route, e.g. "Airport via City Centre"

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public (In Transmodel modeled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia; it will also most probably be detailed as a VIA and associated DESTINATION DISPLAY in the ROUTE description).

Restricted

0:1

xs:boolean

This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g. dragLift) or the LINE is only made available to certain passenger groups (e.g. school buses, hotel shuttles).

OperatorRefs

0:1

+OperatorRefs_Rel

References to the OPERATORS. Multiple OPERATORS in case a ContinuousLeg can be operated by more than one operator, especially in the ALTERNATIVE MODE OF OPERATION where there can be dozens of taxi companies and many free-floating sharing companies.

RouteDescription

0:1

+InternationalText

Descriptive text for a route, e.g., "Airport via City Centre".

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public (In Transmodel modelled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia; it will also most probably be detailed as a VIA and associated DESTINATION DISPLAY in the ROUTE description).

Restricted

0:1

xs:boolean

This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g., dragLift) or the LINE is only made available to certain passenger groups (e.g., school buses, hotel shuttles).

RestrictionNote

0:1

+InternationalText

Information about the restriction.

Attribute

0:*

+GeneralAttribute

Note or service attribute.

PublicCode

0:1

xs:normalizedString

Public code of the SERVICE JOURNEY (same meaning as in NeTEx). Examples: "512", "S8" or "Circle Line" or "ICE 488".

→‍siri:LineDirectionGroup

Service

Mode

1:1

+Mode

[a specialisation of MODE in TMv6] an extended range of VEHICLE MODEs, aggregating them with some SUBMODEs

ProductCategory

0:1

+ProductCategory

A product category for the service. This is a classification defined in NeTEx/SIRI used to identify groups of journeys with some special properties for marketing and fare products, e.g. "TE2" for SNCF or a special panorama train "PE" in Switzerland.

PublishedServiceName

1:1

+InternationalText

Line name or service description as known to the public, e.g. "512", "S8" or "Circle Line" or "ICE 488".

ProductCategory

0:1

+ProductCategory

A product category for the service. This is a classification defined in NeTEx/SIRI used to identify groups of journeys with some special properties for marketing and fare products, e.g., "TE2" for SNCF or a special panorama train "PE" in Switzerland.

PublishedServiceName

1:1

+InternationalText

Line name or service description as known to the public, e.g., "512", "S8" or "Circle Line" or "ICE 488".

TrainNumber

0:1

xs:normalizedString

Contains the TrainNumber from NeTEx (TRAIN NUMBER from Transmodel). If several TrainNumber types exist, use the commercial one. In some cases also non-train modes will use TrainNumber.

→‍siri:VehicleRef

0:1

→‍siri:VehicleRef

Contains the Vehicle reference of the vehicle. In Transmodel this may be the VEHICLE Id.

OperatorRefs

0:1

+OperatorRefs_Rel

References to the OPERATORS. Multiple OPERATORS in case a ContinuousLeg can be operated by more than one operator, especially in the ALTERNATIVE MODE OF OPERATION where there can be dozens of taxi companies and many free floating sharing companies.

RouteDescription

0:1

+InternationalText

Descriptive text for a route, e.g. "Airport via City Centre"

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public (In Transmodel modeled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia; it will also most probably be detailed as a VIA and associated DESTINATION DISPLAY in the ROUTE description).

Restricted

0:1

xs:boolean

This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g. dragLift) or the LINE is only made available to certain passenger groups (e.g. school buses, hotel shuttles).

OperatorRefs

0:1

+OperatorRefs_Rel

References to the OPERATORS. Multiple OPERATORS in case a ContinuousLeg can be operated by more than one operator, especially in the ALTERNATIVE MODE OF OPERATION where there can be dozens of taxi companies and many free-floating sharing companies.

RouteDescription

0:1

+InternationalText

Descriptive text for a route, e.g., "Airport via City Centre".

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public (In Transmodel modelled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia; it will also most probably be detailed as a VIA and associated DESTINATION DISPLAY in the ROUTE description).

Restricted

0:1

xs:boolean

This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g., dragLift) or the LINE is only made available to certain passenger groups (e.g., school buses, hotel shuttles).

RestrictionNote

0:1

+InternationalText

Information about the restriction.

Attribute

0:*

+GeneralAttribute

Note or service attribute.

PublicCode

0:1

xs:normalizedString

Public code of the SERVICE JOURNEY (same meaning as in NeTEx). Examples: "512", "S8" or "Circle Line" or "ICE 488".

→‍siri:LineDirectionGroup

Service

Mode

1:1

+Mode

[a specialisation of MODE in TMv6] an extended range of VEHICLE MODEs, aggregating them with some SUBMODEs

ProductCategory

0:1

+ProductCategory

A product category for the service. This is a classification defined in NeTEx/SIRI used to identify groups of journeys with some special properties for marketing and fare products, e.g. "TE2" for SNCF or a special panorama train "PE" in Switzerland.

PublishedServiceName

1:1

+InternationalText

Line name or service description as known to the public, e.g. "512", "S8" or "Circle Line" or "ICE 488".

ProductCategory

0:1

+ProductCategory

A product category for the service. This is a classification defined in NeTEx/SIRI used to identify groups of journeys with some special properties for marketing and fare products, e.g., "TE2" for SNCF or a special panorama train "PE" in Switzerland.

PublishedServiceName

1:1

+InternationalText

Line name or service description as known to the public, e.g., "512", "S8" or "Circle Line" or "ICE 488".

TrainNumber

0:1

xs:normalizedString

Contains the TrainNumber from NeTEx (TRAIN NUMBER from Transmodel). If several TrainNumber types exist, use the commercial one. In some cases also non-train modes will use TrainNumber.

→‍siri:VehicleRef

0:1

→‍siri:VehicleRef

Contains the Vehicle reference of the vehicle. In Transmodel this may be the VEHICLE Id.

OperatorRefs

0:1

+OperatorRefs_Rel

References to the OPERATORS. Multiple OPERATORS in case a ContinuousLeg can be operated by more than one operator, especially in the ALTERNATIVE MODE OF OPERATION where there can be dozens of taxi companies and many free floating sharing companies.

RouteDescription

0:1

+InternationalText

Descriptive text for a route, e.g. "Airport via City Centre"

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public (In Transmodel modeled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia; it will also most probably be detailed as a VIA and associated DESTINATION DISPLAY in the ROUTE description).

Restricted

0:1

xs:boolean

This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g. dragLift) or the LINE is only made available to certain passenger groups (e.g. school buses, hotel shuttles).

OperatorRefs

0:1

+OperatorRefs_Rel

References to the OPERATORS. Multiple OPERATORS in case a ContinuousLeg can be operated by more than one operator, especially in the ALTERNATIVE MODE OF OPERATION where there can be dozens of taxi companies and many free-floating sharing companies.

RouteDescription

0:1

+InternationalText

Descriptive text for a route, e.g., "Airport via City Centre".

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public (In Transmodel modelled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia; it will also most probably be detailed as a VIA and associated DESTINATION DISPLAY in the ROUTE description).

Restricted

0:1

xs:boolean

This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g., dragLift) or the LINE is only made available to certain passenger groups (e.g., school buses, hotel shuttles).

RestrictionNote

0:1

+InternationalText

Information about the restriction.

Attribute

0:*

+GeneralAttribute

Note or service attribute.

12.10. The ServiceDestinationGroup group

-

ServiceDestinationGroup

Last serviced stop of a vehicle journey (also VEHICLE MEETING POINT or ADDRESSABLE PLACE).

ServiceDestination

DestinationStopPointRef

0:1

siri:StopPointRefStructure

Last stop of vehicle journey; destination stop point.

DestinationText

0:1

+InternationalText

Label for last stop. Should be set for classic public transport. Demand responsive and newer modes of operation will often not have a destination text.

12.11. The RouteDescriptionGroup group

+

RouteDescriptionGroup

Descriptive text for a route, e.g. "Airport via City Centre"

12.11. The RouteDescriptionGroup group

RouteDescriptionGroup

Descriptive text for a route, e.g., "Airport via City Centre".

RouteDescription

RouteDescriptionText

1:1

+InternationalText

12.12. The DatedJourneyGroup group

@@ -1356,14 +1356,14 @@

OJP - Open API for distributed Journey

- - + + - - - - + + + + @@ -1395,14 +1395,14 @@

OJP - Open API for distributed Journey

- - + + - - - - + + + + @@ -1425,7 +1425,7 @@

OJP - Open API for distributed Journey -

DatedJourneyGroup

Vehicle journey that runs at a specific date.

DatedJourney

ConventionalModeOfOperation

0:1

ConventionalModesOfOperation

MODE OF OPERATION for scheduled and flexible services (NeTEx).

PublicCode

0:1

xs:normalizedString

Public code of the SERVICE JOURNEY (same meaning as in NeTEx). Examples: "512", "S8" or "Circle Line" or "ICE 488".

→‍siri:LineDirectionGroup

Service

Mode

1:1

+Mode

[a specialisation of MODE in TMv6] an extended range of VEHICLE MODEs, aggregating them with some SUBMODEs

ProductCategory

0:1

+ProductCategory

A product category for the service. This is a classification defined in NeTEx/SIRI used to identify groups of journeys with some special properties for marketing and fare products, e.g. "TE2" for SNCF or a special panorama train "PE" in Switzerland.

PublishedServiceName

1:1

+InternationalText

Line name or service description as known to the public, e.g. "512", "S8" or "Circle Line" or "ICE 488".

ProductCategory

0:1

+ProductCategory

A product category for the service. This is a classification defined in NeTEx/SIRI used to identify groups of journeys with some special properties for marketing and fare products, e.g., "TE2" for SNCF or a special panorama train "PE" in Switzerland.

PublishedServiceName

1:1

+InternationalText

Line name or service description as known to the public, e.g., "512", "S8" or "Circle Line" or "ICE 488".

TrainNumber

0:1

xs:normalizedString

Contains the TrainNumber from NeTEx (TRAIN NUMBER from Transmodel). If several TrainNumber types exist, use the commercial one. In some cases also non-train modes will use TrainNumber.

→‍siri:VehicleRef

0:1

→‍siri:VehicleRef

Contains the Vehicle reference of the vehicle. In Transmodel this may be the VEHICLE Id.

OperatorRefs

0:1

+OperatorRefs_Rel

References to the OPERATORS. Multiple OPERATORS in case a ContinuousLeg can be operated by more than one operator, especially in the ALTERNATIVE MODE OF OPERATION where there can be dozens of taxi companies and many free floating sharing companies.

RouteDescription

0:1

+InternationalText

Descriptive text for a route, e.g. "Airport via City Centre"

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public (In Transmodel modeled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia; it will also most probably be detailed as a VIA and associated DESTINATION DISPLAY in the ROUTE description).

Restricted

0:1

xs:boolean

This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g. dragLift) or the LINE is only made available to certain passenger groups (e.g. school buses, hotel shuttles).

OperatorRefs

0:1

+OperatorRefs_Rel

References to the OPERATORS. Multiple OPERATORS in case a ContinuousLeg can be operated by more than one operator, especially in the ALTERNATIVE MODE OF OPERATION where there can be dozens of taxi companies and many free-floating sharing companies.

RouteDescription

0:1

+InternationalText

Descriptive text for a route, e.g., "Airport via City Centre".

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public (In Transmodel modelled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia; it will also most probably be detailed as a VIA and associated DESTINATION DISPLAY in the ROUTE description).

Restricted

0:1

xs:boolean

This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g., dragLift) or the LINE is only made available to certain passenger groups (e.g., school buses, hotel shuttles).

RestrictionNote

0:1

+InternationalText

Information about the restriction.

Attribute

0:*

+GeneralAttribute

Note or service attribute.

b

PublicCode

0:1

xs:normalizedString

Public code of the SERVICE JOURNEY (same meaning as in NeTEx). Examples: "512", "S8" or "Circle Line" or "ICE 488".

→‍siri:LineDirectionGroup

Service

b

Mode

1:1

+Mode

[a specialisation of MODE in TMv6] an extended range of VEHICLE MODEs, aggregating them with some SUBMODEs

b

ProductCategory

0:1

+ProductCategory

A product category for the service. This is a classification defined in NeTEx/SIRI used to identify groups of journeys with some special properties for marketing and fare products, e.g. "TE2" for SNCF or a special panorama train "PE" in Switzerland.

b

PublishedServiceName

1:1

+InternationalText

Line name or service description as known to the public, e.g. "512", "S8" or "Circle Line" or "ICE 488".

b

ProductCategory

0:1

+ProductCategory

A product category for the service. This is a classification defined in NeTEx/SIRI used to identify groups of journeys with some special properties for marketing and fare products, e.g., "TE2" for SNCF or a special panorama train "PE" in Switzerland.

b

PublishedServiceName

1:1

+InternationalText

Line name or service description as known to the public, e.g., "512", "S8" or "Circle Line" or "ICE 488".

b

TrainNumber

0:1

xs:normalizedString

Contains the TrainNumber from NeTEx (TRAIN NUMBER from Transmodel). If several TrainNumber types exist, use the commercial one. In some cases also non-train modes will use TrainNumber.

b

→‍siri:VehicleRef

0:1

→‍siri:VehicleRef

Contains the Vehicle reference of the vehicle. In Transmodel this may be the VEHICLE Id.

b

OperatorRefs

0:1

+OperatorRefs_Rel

References to the OPERATORS. Multiple OPERATORS in case a ContinuousLeg can be operated by more than one operator, especially in the ALTERNATIVE MODE OF OPERATION where there can be dozens of taxi companies and many free floating sharing companies.

b

RouteDescription

0:1

+InternationalText

Descriptive text for a route, e.g. "Airport via City Centre"

b

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public (In Transmodel modeled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia; it will also most probably be detailed as a VIA and associated DESTINATION DISPLAY in the ROUTE description).

b

Restricted

0:1

xs:boolean

This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g. dragLift) or the LINE is only made available to certain passenger groups (e.g. school buses, hotel shuttles).

b

OperatorRefs

0:1

+OperatorRefs_Rel

References to the OPERATORS. Multiple OPERATORS in case a ContinuousLeg can be operated by more than one operator, especially in the ALTERNATIVE MODE OF OPERATION where there can be dozens of taxi companies and many free-floating sharing companies.

b

RouteDescription

0:1

+InternationalText

Descriptive text for a route, e.g., "Airport via City Centre".

b

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public (In Transmodel modelled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia; it will also most probably be detailed as a VIA and associated DESTINATION DISPLAY in the ROUTE description).

b

Restricted

0:1

xs:boolean

This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g., dragLift) or the LINE is only made available to certain passenger groups (e.g., school buses, hotel shuttles).

b

RestrictionNote

0:1

+InternationalText

Information about the restriction.

b

Attribute

0:*

+GeneralAttribute

Note or service attribute.

→‍siri:JourneyFormationGroup

The formation elements on the journey level.

BookingArrangements

0:1

+BookingArrangementsContainer

Container with information on booking possibilities for this service.

ReservationNeeded

0:1

ReservationNeeded

Indicates whether this service needs some kind of reservation or booking to run.

SituationFullRefs

0:1

+SituationRefList

A list of references to SITUATIONs.

Extension

0:1

xs:anyType

12.14. The complex type TripLocationStructure

TripLocationStructure

A trip location represents the current logical position of a journey service. It can be used similarly to a place e.g. for starting a new trip request from within this service. A trip location does not(!) describe the relative position of a traveller within a vehicle, e.g. the seat.

The element contains a sequence of the following elements:

→‍OperatingDayRef

1:1

→‍OperatingDayRef

Reference to an Operating Day

→‍JourneyRef

1:1

→‍JourneyRef

Reference to a Journey

→‍siri:LineIdentityGroup

12.15. The TimeWindowGroup group

+

TimeWindowGroup

The window of opportunity that the traveller has to perform this leg of the journey (e.g. a bridge is only open during a given interval).

→‍siri:JourneyFormationGroup

The formation elements on the journey level.

BookingArrangements

0:1

+BookingArrangementsContainer

Container with information on booking possibilities for this service.

ReservationNeeded

0:1

ReservationNeeded

Indicates whether this service needs some kind of reservation or booking to run.

SituationFullRefs

0:1

+SituationRefList

A list of references to SITUATIONs.

Extension

0:1

xs:anyType

12.14. The complex type TripLocationStructure

TripLocationStructure

A trip location represents the current logical position of a journey service. It can be used similarly to a place e.g., for starting a new trip request from within this service. A trip location does not(!) describe the relative position of a traveller within a vehicle, e.g., the seat.

The element contains a sequence of the following elements:

→‍OperatingDayRef

1:1

→‍OperatingDayRef

Reference to an Operating Day

→‍JourneyRef

1:1

→‍JourneyRef

Reference to a Journey

→‍siri:LineIdentityGroup

12.15. The TimeWindowGroup group

TimeWindowGroup

The window of opportunity that the traveller has to perform this leg of the journey (e.g., a bridge is only open during a given interval).

TimeWindow

TimeWindowStart

0:1

xs:dateTime

Time at which window begins.

TimeWindowEnd

0:1

xs:dateTime

Time at which window ends.

12.16. The ServiceTimeGroup group

@@ -1460,15 +1460,15 @@

OJP - Open API for distributed Journey

- - + + - +

ServiceTimeGroup

Contains at least scheduled time, but can contain real time and estimated times

StopPointName

1:1

+InternationalText

Name or description of stop point for use in passenger information.

NameSuffix

0:1

+InternationalText

Additional description of the stop point that may be appended to the name if enough space is available. E.g. "opposite main entrance".

PlannedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. According to planned timetable.

EstimatedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. As to the latest realtime status.

ServiceArrival

0:1

+ServiceArrival

Arrival times of the service at this stop ( group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME).

ServiceDeparture

0:1

+ServiceDeparture

Departure times of the service at this stop ( group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME).

EstimatedQuay

0:1

+InternationalText

Name of the bay where to board/alight from the vehicle. As to the latest real-time status.

ServiceArrival

0:1

+ServiceArrival

Arrival times of the service at this stop (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME).

ServiceDeparture

0:1

+ServiceDeparture

Departure times of the service at this stop (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME).

StopCallStatus

Order

0:1

xs:positiveInteger

Sequence number of this stop in the service pattern of the journey.

RequestStop

0:1

xs:boolean

The vehicle journey calls at this stop only on demand.

UnplannedStop

0:1

xs:boolean

This stop has not been planned by the planning department.

NotServicedStop

0:1

xs:boolean

The vehicle will not call at this stop despite earlier planning.

NoBoardingAtStop

0:1

xs:boolean

Boarding will not be allowed at this stop of this journey.

NoAlightingAtStop

0:1

xs:boolean

Alighting will not be allowed at this stop of this journey.

The element contains a sequence of the following elements:

→‍siri:ExpectedDepartureOccupancy

0:*

→‍siri:ExpectedDepartureOccupancy

The Occupancy structure from SIRI can be used here. It is recommended to mainly have one ExpectedDepartureOccupancy for each FareClass and mainly focus on OccupancyLevel and OccupancyPercentage. For more details have a look at the SIRI documentation.

→‍siri:ExpectedDepartureCapacities

0:*

→‍siri:ExpectedDepartureCapacities

The Capacity structure also will probably rarely be used and parsed. When used, then it mainly show elements that are important for accessibility.

The element contains a sequence of the following elements:

→‍siri:ExpectedDepartureOccupancy

0:*

→‍siri:ExpectedDepartureOccupancy

The Occupancy structure from SIRI can be used here. It is recommended to mainly have one ExpectedDepartureOccupancy for each FareClass and mainly focus on OccupancyLevel and OccupancyPercentage. For more details have a look at the SIRI documentation.

→‍siri:ExpectedDepartureCapacities

0:*

→‍siri:ExpectedDepartureCapacities

The Capacity structure also will probably rarely be used and parsed. When used, then it mainly shows elements that are important for accessibility.

Attribute

0:*

+GeneralAttribute

Note or attribute.

SituationFullRefs

0:1

+SituationRefList

A list of references to SITUATIONs.

12.21. The StopCallStatusGroup group

@@ -1477,9 +1477,9 @@

OJP - Open API for distributed Journey

- + -

StopCallStatusGroup

Status properties for the vehicle call at this stop.

StopCallStatus

Order

0:1

xs:positiveInteger

Sequence number of this stop in the service pattern of the journey.

NotServicedStop

0:1

xs:boolean

The vehicle will not call at this stop despite earlier planning.

NoBoardingAtStop

0:1

xs:boolean

Boarding will not be allowed at this stop of this journey.

NoAlightingAtStop

0:1

xs:boolean

Alighting will not be allowed at this stop of this journey.

The element contains a sequence of the following elements:

→‍siri:ExpectedDepartureOccupancy

0:*

→‍siri:ExpectedDepartureOccupancy

The Occupancy structure from SIRI can be used here. It is recommended to mainly have one ExpectedDepartureOccupancy for each FareClass and mainly focus on OccupancyLevel and OccupancyPercentage. For more details have a look at the SIRI documentation.

→‍siri:ExpectedDepartureCapacities

0:*

→‍siri:ExpectedDepartureCapacities

The Capacity structure also will probably rarely be used and parsed. When used, then it mainly show elements that are important for accessibility.

The element contains a sequence of the following elements:

→‍siri:ExpectedDepartureOccupancy

0:*

→‍siri:ExpectedDepartureOccupancy

The Occupancy structure from SIRI can be used here. It is recommended to mainly have one ExpectedDepartureOccupancy for each FareClass and mainly focus on OccupancyLevel and OccupancyPercentage. For more details have a look at the SIRI documentation.

→‍siri:ExpectedDepartureCapacities

0:*

→‍siri:ExpectedDepartureCapacities

The Capacity structure also will probably rarely be used and parsed. When used, then it mainly shows elements that are important for accessibility.

Attribute

0:*

+GeneralAttribute

Note or attribute.

12.22. The ServiceStatusGroup group

+

ServiceStatusGroup

parameters which describe the current status of a DATED VEHICLE JOURNEY

12.22. The ServiceStatusGroup group

@@ -1494,14 +1494,14 @@

OJP - Open API for distributed Journey

- - + + - - - - + + + + @@ -1523,17 +1523,17 @@

OJP - Open API for distributed Journey

-

ServiceStatusGroup

parameters which describe the status of a DATED VEHICLE JOURNEY

ServiceStatus

Unplanned

0:1

xs:boolean

Whether this trip is an additional one that has not been planned. Default is false.

Cancelled

0:1

xs:boolean

Whether this trip is cancelled and will not be run. Default is false.

Deviation

0:1

xs:boolean

Whether this trip deviates from the planned service pattern. Default is false.

a

PublicCode

0:1

xs:normalizedString

Public code of the SERVICE JOURNEY (same meaning as in NeTEx). Examples: "512", "S8" or "Circle Line" or "ICE 488".

→‍siri:LineDirectionGroup

Service

a

Mode

1:1

+Mode

[a specialisation of MODE in TMv6] an extended range of VEHICLE MODEs, aggregating them with some SUBMODEs

a

ProductCategory

0:1

+ProductCategory

A product category for the service. This is a classification defined in NeTEx/SIRI used to identify groups of journeys with some special properties for marketing and fare products, e.g. "TE2" for SNCF or a special panorama train "PE" in Switzerland.

a

PublishedServiceName

1:1

+InternationalText

Line name or service description as known to the public, e.g. "512", "S8" or "Circle Line" or "ICE 488".

a

ProductCategory

0:1

+ProductCategory

A product category for the service. This is a classification defined in NeTEx/SIRI used to identify groups of journeys with some special properties for marketing and fare products, e.g., "TE2" for SNCF or a special panorama train "PE" in Switzerland.

a

PublishedServiceName

1:1

+InternationalText

Line name or service description as known to the public, e.g., "512", "S8" or "Circle Line" or "ICE 488".

a

TrainNumber

0:1

xs:normalizedString

Contains the TrainNumber from NeTEx (TRAIN NUMBER from Transmodel). If several TrainNumber types exist, use the commercial one. In some cases also non-train modes will use TrainNumber.

a

→‍siri:VehicleRef

0:1

→‍siri:VehicleRef

Contains the Vehicle reference of the vehicle. In Transmodel this may be the VEHICLE Id.

a

OperatorRefs

0:1

+OperatorRefs_Rel

References to the OPERATORS. Multiple OPERATORS in case a ContinuousLeg can be operated by more than one operator, especially in the ALTERNATIVE MODE OF OPERATION where there can be dozens of taxi companies and many free floating sharing companies.

a

RouteDescription

0:1

+InternationalText

Descriptive text for a route, e.g. "Airport via City Centre"

a

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public (In Transmodel modeled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia; it will also most probably be detailed as a VIA and associated DESTINATION DISPLAY in the ROUTE description).

a

Restricted

0:1

xs:boolean

This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g. dragLift) or the LINE is only made available to certain passenger groups (e.g. school buses, hotel shuttles).

a

OperatorRefs

0:1

+OperatorRefs_Rel

References to the OPERATORS. Multiple OPERATORS in case a ContinuousLeg can be operated by more than one operator, especially in the ALTERNATIVE MODE OF OPERATION where there can be dozens of taxi companies and many free-floating sharing companies.

a

RouteDescription

0:1

+InternationalText

Descriptive text for a route, e.g., "Airport via City Centre".

a

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public (In Transmodel modelled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia; it will also most probably be detailed as a VIA and associated DESTINATION DISPLAY in the ROUTE description).

a

Restricted

0:1

xs:boolean

This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g., dragLift) or the LINE is only made available to certain passenger groups (e.g., school buses, hotel shuttles).

a

RestrictionNote

0:1

+InternationalText

Information about the restriction.

a

Attribute

0:*

+GeneralAttribute

Note or service attribute.

Service

a

JourneyRelations

0:1

siri:JourneyRelationsStructure

Relations of the journey with other journeys, e.g., in case a joining/splitting takes place or the journey substitutes for another one etc.

The element contains a sequence of the following elements:

PersonalMode

-1:1

PersonalModes

PERSONAL MODE used either for PERSONAL MODE OF OPERATION or in ALTERNATIVE MODE OF OPERATION.

AlternativeService

-0:1

+AlternativeService

Shared mobility offer.

BookingArrangements

0:1

+BookingArrangementsContainer

Container with information on booking possibilities for this service.

SituationFullRefs

0:1

+SituationRefList

A list of references to SITUATIONs.

Extension

0:1

xs:anyType

12.24. The complex type VehiclePositionStructure

VehiclePositionStructure

Geographical and logical position of a vehicle.

The element contains a sequence of the following elements:

GeoPosition

0:1

siri:LocationStructure

Geographic position of vehicle.

Progress

0:1

VehicleProgress

Logical progress of vehicle relative to service pattern.

Bearing

0:1

siri:AbsoluteBearingType

Bearing in compass degrees in which vehicle is heading (expected to be consistent with Transmodel ROUTE or LEG TRACK and PATH GUIDANCE).

ProgressBetweenStops

0:1

siri:ProgressBetweenStopsStructure

Provides information about the progress of the vehicle along its current link, that is link from previous visited top to current position.

12.25. The complex type PlaceContextStructure

PlaceContextStructure

[a view of PLACE in TMv6] a PLACE and access to it by individual transport

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

a

PlaceRef

-1:1

+PlaceRef

Static place.

b

TripLocation

-1:1

+TripLocation

Location within a (moving) vehicle.

Then, the element contains one of the following elements:

a

DepArrTime

-0:1

xs:dateTime

Time when departure/arrival from/to location is required.

b

TimeAllowance

-0:1

xs:duration

Extra time needed before reaching/after leaving this location (an example of a TRIP ACCESS CONSTRAINT. In Transmodel it is modeled more extensively and could relate to ACCESS MODE e.g. walk max. 5 minutes, but cycle 10 minutes).

IndividualTransportOption

0:*

+IndividualTransportOption

Options how to access/leave the place by individual transport.

12.26. The NumberOfResultsGroup group

+

NumberOfResultsGroup

parameter to control the number of TRIP results before/after a point in time. May NOT be used when departure time at origin AND arrival time at destination are set

The element contains a sequence of the following elements:

PersonalMode

-1:1

PersonalModes

PERSONAL MODE used either for PERSONAL MODE OF OPERATION or in ALTERNATIVE MODE OF OPERATION.

AlternativeService

-0:1

+AlternativeService

Shared mobility offer.

BookingArrangements

0:1

+BookingArrangementsContainer

Container with information on booking possibilities for this service.

SituationFullRefs

0:1

+SituationRefList

A list of references to SITUATIONs.

Extension

0:1

xs:anyType

12.24. The complex type VehiclePositionStructure

VehiclePositionStructure

Geographical and logical position of a vehicle.

The element contains a sequence of the following elements:

GeoPosition

0:1

siri:LocationStructure

Geographic position of vehicle.

Progress

0:1

VehicleProgress

Logical progress of vehicle relative to service pattern.

Bearing

0:1

siri:AbsoluteBearingType

Bearing in compass degrees in which vehicle is heading (expected to be consistent with Transmodel ROUTE or LEG TRACK and PATH GUIDANCE).

ProgressBetweenStops

0:1

siri:ProgressBetweenStopsStructure

Provides information about the progress of the vehicle along its current link, that is link from previous visited top to current position.

12.25. The complex type PlaceContextStructure

PlaceContextStructure

[a view of PLACE in TMv6] a PLACE and access to it by individual transport

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

a

PlaceRef

-1:1

+PlaceRef

Static place.

b

TripLocation

-1:1

+TripLocation

Location within a (moving) vehicle.

Then, the element contains one of the following elements:

a

DepArrTime

-0:1

xs:dateTime

Time when departure/arrival from/to location is required.

b

TimeAllowance

-0:1

xs:duration

Extra time needed before reaching/after leaving this location (an example of a TRIP ACCESS CONSTRAINT. In Transmodel it is modelled more extensively and could relate to ACCESS MODE e.g., walk max. 5 minutes, but cycle 10 minutes).

IndividualTransportOption

0:*

+IndividualTransportOption

Options how to access/leave the place by individual transport.

12.26. The NumberOfResultsGroup group

NumberOfResultsGroup

parameter to control the number of TRIP results before/after a point in time. May NOT be used when departure time at origin AND arrival time at destination are set

NumberOfResults

NumberOfResultsBefore

0:1

xs:nonNegativeInteger

The desired number of trip results before the given time (at origin or destination).

NumberOfResultsAfter

0:1

xs:nonNegativeInteger

The desired number of trip results after the given time (at origin or destination).

12.27. The BaseTripPolicyGroup group

- + - + @@ -1541,7 +1541,7 @@

OJP - Open API for distributed Journey

BaseTripPolicyGroup

Policies that control the trip search behaviour for both public and individual transport.

The element contains one of the following elements:

NumberOfResults

a

NumberOfResultsBefore

0:1

xs:nonNegativeInteger

The desired number of trip results before the given time (at origin or destination).

a

NumberOfResultsAfter

0:1

xs:nonNegativeInteger

The desired number of trip results after the given time (at origin or destination).

BaseTripPolicy

b

NumberOfResults

-0:1

xs:positiveInteger

The number of trip results that the user wants to see at least (TRIP REQUEST POLICY.maximumNumberofJourneys). Be aware that some implementatins will deliver one of the TripResults before the indicated departure time. This means one always has to check the results against the parameters before using them.

BaseTripPolicy

b

NumberOfResults

-0:1

xs:positiveInteger

The number of trip results that the user wants to see at least (TRIP REQUEST POLICY.maximumNumberofJourneys). Be aware that some implementations will deliver one of the TripResults before the indicated departure time. This means one always must check the results against the parameters before using them.

TimeWindow

0:1

xs:duration

Time window in which the trips should be, starting from the time specified in PlaceContext. Implements TRIP REQUEST.FlexibilityWindow. All trips within the window should be provided by the implementation.

UseRealtimeData

0:1

UseRealtimeData

The way real-time data should be used in the calculation of the trip.

ImmediateTripStart

0:1

xs:boolean

Whether the trip calculation should find a solution that starts immediately (e.g. because the user is already on the way) instead of finding the latest possible start opportunity. Default is FALSE.

ImmediateTripStart

0:1

xs:boolean

Whether the trip calculation should find a solution that starts immediately (e.g., because the user is already on the way) instead of finding the latest possible start opportunity. Default is FALSE.

TransferLimit

0:1

xs:nonNegativeInteger

The maximum number of interchanges the user will accept per trip.

OptimisationMethod

0:1

OptimisationMethod

The type of algorithm to be used in the calculation of the trip (fastest, least walking, etc.).

ConsiderElevationData

0:1

xs:boolean

Whether the trip calculation should take elevation data into account (bike, foot). Default is FALSE.

PassengerCategory

0:*

PassengerCategory

Sequence of all passenger categories, for which this search shall be conducted. In rare cases additional offerings may be available (e.g., demand responsive service with certain areas being reserved for seniors). If multiple PassengerCategories are provided, then Services are shown when they are available for at least one PassengerCategory.

12.28. The BaseTripMobilityFilterGroup group

- + @@ -1555,14 +1555,14 @@

OJP - Open API for distributed Journey

- + - +

BaseTripMobilityFilterGroup

Base mobility options to be applied for both public and individual transport.

BaseTripMobilityFilter

NoSingleStep

0:1

xs:boolean

The user is not able to pass over (or wants to avoid) single steps. Stairs and non-level entrances are not excluded.

NoStairs

0:1

xs:boolean

The user is not able to walk up/down stairs.

NoStairs

0:1

xs:boolean

The user is not able to walk up/downstairs.

NoEscalator

0:1

xs:boolean

The user is not able to use an escalator.

NoElevator

0:1

xs:boolean

The user is not able to use an elevator.

NoRamp

0:1

xs:boolean

The user is not able to use a ramp.

IncludeTurnDescription

0:1

xs:boolean

Whether the result should include turn-by-turn instructions for each journey leg.

IncludeAccessFeatures

0:1

xs:boolean

Whether the result should include the access features (stairs, elevator, etc.) on each path link.

IncludeAccessFeaturesStatus

0:1

xs:boolean

Whether the result should include real time status of access features to indicate broken equipment.

IncludeAccessibilityDetails

0:*

AccessibilityDetailsProfile

Which accessibility features and other accessibility-related information to retrieve (e.g. guidance text for the visually impaired).

IncludeAccessibilityDetails

0:*

AccessibilityDetailsProfile

Which accessibility features and other accessibility-related information to retrieve (e.g., guidance text for the visually impaired).

IncludePlacesContext

0:1

xs:boolean

Whether the place context is needed. If a requestor has that information already, the response can be made slimmer, when set to false. Default is true.

IncludeSituationsContext

0:1

xs:boolean

Wheter the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true

IncludeSituationsContext

0:1

xs:boolean

Whether the situation context is needed. If a requestor has that information by other means or can't process it, the response can be made slimmer, when set to false. Default is true.

12.30. The complex type LegAttributeStructure

-

LegAttributeStructure

+GeneralAttribute

Attributes that are not valid on the whole service, but only on section of a TRIP made on a single MODE without interchange between boarding and alighting (facilities available on a specified (part of a) Leg of a VEHICLE JOURNEY)

The element contains a sequence of the following elements:

FromStopSeqNumber

0:1

xs:positiveInteger

The attribute is valid from the stop point with this sequence number within the leg. If missing it is valid from the beginning of the leg.

ToStopSeqNumber

0:1

xs:positiveInteger

The attribute is valid to the stop point (inclusively) with this sequence number within the leg. If missing it is valid to the end of the leg.

12.31. The complex type LegTrackStructure

LegTrackStructure

The LINK PROJECTION of a Leg onto the topography of the route being followed.

The element contains only one element:

TrackSection

1:*

+TrackSection

A geographical view of a Transmodel LEG TRACK together with duration and length that can be used for representing the leg on a map. The points may be STOP PLACE, SCHEDULED STOP POINT, coordinates or ADDRESSes. Specialisation of SECTION.

12.32. The complex type TrackSectionStructure

TrackSectionStructure

SECTION of a LEG TRACK on the infrastructure network of the LEG together with time information.

The element contains a sequence of the following elements:

TrackSectionStart

0:1

+PlaceRef

Start place of this track section (Start of a SECTION of a LEG.TRACK).

TrackSectionEnd

0:1

+PlaceRef

End place of this track section (End of a SECTION of a LEG.TRACK).

LinkProjection

0:1

+LinearShape

An oriented correspondence from one LINK of a source layer, onto an entity in a target layer: e.g. LINK SEQUENCE.

RoadName

0:1

xs:string

Name of the road this track section is attached to (LEG TRACK.SECTION NAME, may also be something like "bicycle line along Tellstrasse").

Duration

0:1

xs:duration

Duration the passenger needs to travel through this track section.

Length

0:1

siri:DistanceType

Length of this track section.

Extension

0:1

xs:anyType

+

12.31. The complex type LegTrackStructure

LegTrackStructure

The LINK PROJECTION of a Leg onto the topography of the route being followed.

The element contains only one element:

TrackSection

1:*

+TrackSection

A geographical view of a Transmodel LEG TRACK together with duration and length that can be used for representing the leg on a map. The points may be STOP PLACE, SCHEDULED STOP POINT, coordinates, or ADDRESSes. Specialisation of SECTION.

12.32. The complex type TrackSectionStructure

TrackSectionStructure

SECTION of a LEG TRACK on the infrastructure network of the LEG together with time information.

The element contains a sequence of the following elements:

TrackSectionStart

0:1

+PlaceRef

Start place of this track section (Start of a SECTION of a LEG.TRACK).

TrackSectionEnd

0:1

+PlaceRef

End place of this track section (End of a SECTION of a LEG.TRACK).

LinkProjection

0:1

+LinearShape

An oriented correspondence from one LINK of a source layer, onto an entity in a target layer: e.g., LINK SEQUENCE.

RoadName

0:1

xs:string

Name of the road this track section is attached to (LEG TRACK.SECTION NAME, may also be something like "bicycle line along Tellstrasse").

Duration

0:1

xs:duration

Duration the passenger needs to travel through this track section.

Length

0:1

siri:DistanceType

Length of this track section.

Extension

0:1

xs:anyType

13. OJP/OJP_Availability.xsd - Request and response definitions for availability of tickets and services on a journey leg.

13.1. Simple type definitions

AvailabilityProblemTypeEnumeration

AVAILABILITY_NOSERVICEFOUND | AVAILABILITY_LOCATIONUNSERVED | AVAILABILITY_LOCATIONUNKNOWN | AVAILABILITY_OUTSIDERULES | AVAILABILITY_SERVICEDISRUPTED | AVAILABILITY_UNAVAILABLE | AVAILABILITY_OTHER

Types of problems that may be returned in responses to AVAILABILITY requests.

BookableServiceItemTypeEnumeration

wheelchair | motorisedWheelchair | foldableWheelchair | walkingFrame | pram | heavyLuggage | childSeatTakenAlong | childSeatSupplied | babyCarrierTakenAlong | babyCarrierSupplied | seatBoosterSupplied | bicycle | guideDog | dog | boardingAssistance | alightingAssistance | onboardAssistance | unassistedMinorAssistance

Types of bookable service items.

13.2. The AvailabilityRequestGroup group

@@ -1576,14 +1576,14 @@

OJP - Open API for distributed Journey

- - + + - - - - + + + + @@ -1617,7 +1617,7 @@

OJP - Open API for distributed Journey

- + @@ -1628,8 +1628,8 @@

OJP - Open API for distributed Journey

- - + + | | `easy` | @@ -1688,7 +1688,7 @@

OJP - Open API for distributed Journey

- +

AvailabilityRequestGroup

Availability request. Used to check the availability of a MOBILITY SERVICE, a VEHICLE, SERVICE JOURNEY or SINGLE JOURNEY. Be aware that usually after the response arrives, the rest of the TRIP must be recalculated. As especially pickup and setdown locations may have shifted from where they were in the previously calculated TRIP.

The element contains one of the following elements:

AvailabilityRequest

a

PublicTransport

-1:1

+BookingPTLeg

Definition of the journey leg to be covered by public transport. Other mobility services can be added later.

MobilityUser

1:*

+BookingUser

Passenger(s) for whom the service needs to be booked, one MobilityUser per passenger.

PublicCode

0:1

xs:normalizedString

Public code of the SERVICE JOURNEY (same meaning as in NeTEx). Examples: "512", "S8" or "Circle Line" or "ICE 488".

→‍siri:LineDirectionGroup

Service

Mode

1:1

+Mode

[a specialisation of MODE in TMv6] an extended range of VEHICLE MODEs, aggregating them with some SUBMODEs

ProductCategory

0:1

+ProductCategory

A product category for the service. This is a classification defined in NeTEx/SIRI used to identify groups of journeys with some special properties for marketing and fare products, e.g. "TE2" for SNCF or a special panorama train "PE" in Switzerland.

PublishedServiceName

1:1

+InternationalText

Line name or service description as known to the public, e.g. "512", "S8" or "Circle Line" or "ICE 488".

ProductCategory

0:1

+ProductCategory

A product category for the service. This is a classification defined in NeTEx/SIRI used to identify groups of journeys with some special properties for marketing and fare products, e.g., "TE2" for SNCF or a special panorama train "PE" in Switzerland.

PublishedServiceName

1:1

+InternationalText

Line name or service description as known to the public, e.g., "512", "S8" or "Circle Line" or "ICE 488".

TrainNumber

0:1

xs:normalizedString

Contains the TrainNumber from NeTEx (TRAIN NUMBER from Transmodel). If several TrainNumber types exist, use the commercial one. In some cases also non-train modes will use TrainNumber.

→‍siri:VehicleRef

0:1

→‍siri:VehicleRef

Contains the Vehicle reference of the vehicle. In Transmodel this may be the VEHICLE Id.

OperatorRefs

0:1

+OperatorRefs_Rel

References to the OPERATORS. Multiple OPERATORS in case a ContinuousLeg can be operated by more than one operator, especially in the ALTERNATIVE MODE OF OPERATION where there can be dozens of taxi companies and many free floating sharing companies.

RouteDescription

0:1

+InternationalText

Descriptive text for a route, e.g. "Airport via City Centre"

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public (In Transmodel modeled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia; it will also most probably be detailed as a VIA and associated DESTINATION DISPLAY in the ROUTE description).

Restricted

0:1

xs:boolean

This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g. dragLift) or the LINE is only made available to certain passenger groups (e.g. school buses, hotel shuttles).

OperatorRefs

0:1

+OperatorRefs_Rel

References to the OPERATORS. Multiple OPERATORS in case a ContinuousLeg can be operated by more than one operator, especially in the ALTERNATIVE MODE OF OPERATION where there can be dozens of taxi companies and many free-floating sharing companies.

RouteDescription

0:1

+InternationalText

Descriptive text for a route, e.g., "Airport via City Centre".

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public (In Transmodel modelled as TRIP REQUEST PLACE.TRIP VIA PLACE.GoVia; it will also most probably be detailed as a VIA and associated DESTINATION DISPLAY in the ROUTE description).

Restricted

0:1

xs:boolean

This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g., dragLift) or the LINE is only made available to certain passenger groups (e.g., school buses, hotel shuttles).

RestrictionNote

0:1

+InternationalText

Information about the restriction.

Attribute

0:*

+GeneralAttribute

Note or service attribute.

BaseTripMobilityFilter

NoSingleStep

0:1

xs:boolean

The user is not able to pass over (or wants to avoid) single steps. Stairs and non-level entrances are not excluded.

NoStairs

0:1

xs:boolean

The user is not able to walk up/down stairs.

NoStairs

0:1

xs:boolean

The user is not able to walk up/downstairs.

NoEscalator

0:1

xs:boolean

The user is not able to use an escalator.

NoElevator

0:1

xs:boolean

The user is not able to use an elevator.

NoRamp

0:1

xs:boolean

The user is not able to use a ramp.

TripMobilityFilter

BikeTransport

0:1

xs:boolean

The user wants to carry a bike on public transport (could be extended in future to transporting big luggage/animals/etc).

WalkSpeed

0:1

OpenPercent

Deviation from average walking speed in percent. 100% percent is average speed. Less than 100 % slower, Greater than 150% faster.

AdditionalTransferTime

0:1

xs:duration

Additional time added to all transfers (also to transfers between individual to public transport, not modeled in Transmodel).

HikingProfile

0:1

Users hiking profile. The main element to control general walking behaviour is WalkSpeed (together with accessibility constraints). Note: possible explanations in German can be found here: https://akademie.alpinewelten.com/bergwandern/klassifizierung-von-wanderwegen

AdditionalTransferTime

0:1

xs:duration

Additional time added to all transfers (also to transfers between individual to public transport, not modelled in Transmodel).

HikingProfile

0:1

Users hiking profile. The main element to control general walking behaviour is WalkSpeed (together with accessibility constraints). Note: explanations in German can be found here: https://akademie.alpinewelten.com/bergwandern/klassifizierung-von-wanderwegen

NotServicedStop

0:1

xs:boolean

The vehicle will not call at this stop despite earlier planning.

NoBoardingAtStop

0:1

xs:boolean

Boarding will not be allowed at this stop of this journey.

NoAlightingAtStop

0:1

xs:boolean

Alighting will not be allowed at this stop of this journey.

The element contains a sequence of the following elements:

→‍siri:ExpectedDepartureOccupancy

0:*

→‍siri:ExpectedDepartureOccupancy

The Occupancy structure from SIRI can be used here. It is recommended to mainly have one ExpectedDepartureOccupancy for each FareClass and mainly focus on OccupancyLevel and OccupancyPercentage. For more details have a look at the SIRI documentation.

→‍siri:ExpectedDepartureCapacities

0:*

→‍siri:ExpectedDepartureCapacities

The Capacity structure also will probably rarely be used and parsed. When used, then it mainly show elements that are important for accessibility.

The element contains a sequence of the following elements:

→‍siri:ExpectedDepartureOccupancy

0:*

→‍siri:ExpectedDepartureOccupancy

The Occupancy structure from SIRI can be used here. It is recommended to mainly have one ExpectedDepartureOccupancy for each FareClass and mainly focus on OccupancyLevel and OccupancyPercentage. For more details have a look at the SIRI documentation.

→‍siri:ExpectedDepartureCapacities

0:*

→‍siri:ExpectedDepartureCapacities

The Capacity structure also will probably rarely be used and parsed. When used, then it mainly shows elements that are important for accessibility.

Attribute

0:*

+GeneralAttribute

Note or attribute.

13.6. The MinMaxTimeBandGroup group

@@ -1707,7 +1707,7 @@

OJP - Open API for distributed Journey

- + @@ -1718,8 +1718,8 @@

OJP - Open API for distributed Journey

- - + + | | `easy` | @@ -1794,7 +1794,7 @@

OJP - Open API for distributed Journey

MinMaxTimeBandGroup

Earliest possible departure time from a start location and latest possible arrival at a different destination location.

MinMaxTimeBand

EarliestDepartureTime

0:1

xs:dateTime

Earliest possible departure time from start location.

BaseTripMobilityFilter

NoSingleStep

0:1

xs:boolean

The user is not able to pass over (or wants to avoid) single steps. Stairs and non-level entrances are not excluded.

NoStairs

0:1

xs:boolean

The user is not able to walk up/down stairs.

NoStairs

0:1

xs:boolean

The user is not able to walk up/downstairs.

NoEscalator

0:1

xs:boolean

The user is not able to use an escalator.

NoElevator

0:1

xs:boolean

The user is not able to use an elevator.

NoRamp

0:1

xs:boolean

The user is not able to use a ramp.

TripMobilityFilter

BikeTransport

0:1

xs:boolean

The user wants to carry a bike on public transport (could be extended in future to transporting big luggage/animals/etc).

WalkSpeed

0:1

OpenPercent

Deviation from average walking speed in percent. 100% percent is average speed. Less than 100 % slower, Greater than 150% faster.

AdditionalTransferTime

0:1

xs:duration

Additional time added to all transfers (also to transfers between individual to public transport, not modeled in Transmodel).

HikingProfile

0:1

Users hiking profile. The main element to control general walking behaviour is WalkSpeed (together with accessibility constraints). Note: possible explanations in German can be found here: https://akademie.alpinewelten.com/bergwandern/klassifizierung-von-wanderwegen

AdditionalTransferTime

0:1

xs:duration

Additional time added to all transfers (also to transfers between individual to public transport, not modelled in Transmodel).

HikingProfile

0:1

Users hiking profile. The main element to control general walking behaviour is WalkSpeed (together with accessibility constraints). Note: explanations in German can be found here: https://akademie.alpinewelten.com/bergwandern/klassifizierung-von-wanderwegen

14.4. The toplevel element ErrorType

ErrorType

xs:string

14.5. The ProblemDetailGroup group

-

ProblemDetailGroup

Detailed description of the problem.

ProblemDetail

Details

0:1

+InternationalText

Explanation of the problem.

LogData

0:1

xs:string

Additional log data.

14.6. The complex type PrivateCodeStructure

PrivateCodeStructure

Code within scope of a private referential system

The element contains a sequence of the following elements:

System

1:1

xs:NMTOKEN

Code of the foreign referential system.

Value

1:1

xs:NMTOKEN

Object code within this private/foreign system.

14.7. The complex type LinearShapeStructure

LinearShapeStructure

An oriented correspondence from one LINK or ROUTE of a source layer, onto an entity in a target layer: e.g. LINK SEQUENCE. As OJP is reduced in relation to NeTEx, we use a simple general structure.

The element contains only one element:

Position

2:*

siri:LocationStructure

Ordered list of locations representing the geometry of the link or route.

14.8. The complex type AreaStructure

AreaStructure

Area described as a polygon.

The element contains only one element:

Points

3:*

siri:LocationStructure

Ordered list of geographic locations describing the polygon of the area.

14.9. The toplevel element ParticipantRef

ParticipantRef

siri:ParticipantRefStructure

Reference to a Participant ([equivalent of PARTICIPANT in SIRI] IT system that is participating in a communication with other participant(s))

14.10. The toplevel element OperatorRef

OperatorRef

siri:OperatorRefStructure

Reference to an Operator ([TMv6] company providing public transport services.)

14.11. The complex type OperatorRefs_RelStructure

OperatorRefs_RelStructure

The element contains only one element:

OperatorRef

1:*

siri:OperatorRefStructure

14.12. The complex type OperatorFilterStructure

OperatorFilterStructure

Filter for in/exclusion of transport operators.

The element contains a sequence of the following elements:

Exclude

0:1

xs:boolean

Whether operators in list are to include or exclude from search. Default is exclude.

OperatorRef

0:*

siri:OperatorRefStructure

Reference to transport operator

14.13. The toplevel element ProductCategoryRef

ProductCategoryRef

siri:ProductCategoryRefStructure

Reference to a product category. Product categories should be defined once and used uniformly in all channels (e.g. NeTEx, SIRI, OJP).

14.14. The complex type LineDirectionFilterStructure

LineDirectionFilterStructure

Filter for in/exclusion of lines (and directions).

The element contains a sequence of the following elements:

Line

1:*

siri:LineDirectionStructure

Reference to a GROUP of DIRECTIONs of the ROUTEs belonging to the same LINE created for the purpose of filtering and organising timetables.

Exclude

0:1

xs:boolean

Whether lines in list are to include or exclude from search. Default is exclude.

14.15. The complex type JourneyRefStructure

JourneyRefStructure

JourneyCode

Reference to a Journey

14.16. The toplevel element JourneyRef

JourneyRef

+JourneyRef

Reference to a Journey

14.17. The DatedJourneyRefGroup group

+

DatedJourneyRefGroup

Reference to a DATED VEHICLE JOURNEY (Reference to a journey on a specific operating day).

14.6. The complex type PrivateCodeStructure

PrivateCodeStructure

Code within scope of a private referential system

The element contains a sequence of the following elements:

System

1:1

xs:NMTOKEN

Code of the foreign referential system.

Value

1:1

xs:NMTOKEN

Object code within this private/foreign system.

14.7. The complex type LinearShapeStructure

LinearShapeStructure

An oriented correspondence from one LINK or ROUTE of a source layer, onto an entity in a target layer: e.g., LINK SEQUENCE. As OJP is reduced in relation to NeTEx, we use a simple general structure.

The element contains only one element:

Position

2:*

siri:LocationStructure

Ordered list of locations representing the geometry of the link or route.

14.8. The complex type AreaStructure

AreaStructure

Area described as a polygon.

The element contains only one element:

Points

3:*

siri:LocationStructure

Ordered list of geographic locations describing the polygon of the area.

14.9. The toplevel element ParticipantRef

ParticipantRef

siri:ParticipantRefStructure

Reference to a Participant ([equivalent of PARTICIPANT in SIRI] IT system that is participating in a communication with other participant(s))

14.10. The toplevel element OperatorRef

OperatorRef

siri:OperatorRefStructure

Reference to an Operator ([TMv6] company providing public transport services.)

14.11. The complex type OperatorRefs_RelStructure

OperatorRefs_RelStructure

The element contains only one element:

OperatorRef

1:*

siri:OperatorRefStructure

14.12. The complex type OperatorFilterStructure

OperatorFilterStructure

Filter for in/exclusion of transport operators.

The element contains a sequence of the following elements:

Exclude

0:1

xs:boolean

Whether operators in list are to include or exclude from search. Default is exclude.

OperatorRef

0:*

siri:OperatorRefStructure

Reference to transport operator

14.13. The toplevel element ProductCategoryRef

ProductCategoryRef

siri:ProductCategoryRefStructure

Reference to a product category. Product categories should be defined once and used uniformly in all channels (e.g., NeTEx, SIRI, OJP).

14.14. The complex type LineDirectionFilterStructure

LineDirectionFilterStructure

Filter for in/exclusion of lines (and directions).

The element contains a sequence of the following elements:

Line

1:*

siri:LineDirectionStructure

Reference to a GROUP of DIRECTIONs of the ROUTEs belonging to the same LINE created for the purpose of filtering and organising timetables.

Exclude

0:1

xs:boolean

Whether lines in list are to include or exclude from search. Default is exclude.

14.15. The complex type JourneyRefStructure

JourneyRefStructure

JourneyCode

Reference to a Journey

14.16. The toplevel element JourneyRef

JourneyRef

+JourneyRef

Reference to a Journey

14.17. The DatedJourneyRefGroup group

DatedJourneyRefGroup

Reference to a DATED VEHICLE JOURNEY (Reference to a journey on a specific operating day).

DatedJourneyRef

→‍JourneyRef

1:1

→‍JourneyRef

Reference to a Journey

→‍OperatingDayRef

1:1

→‍OperatingDayRef

Reference to an Operating Day

14.18. The DatedTrainNumberRefGroup group

@@ -1810,13 +1810,13 @@

OJP - Open API for distributed Journey

DatedTrainNumberRefGroup

Reference to a TRAIN NUMBER of an OPERATOR at a given OPERATING DAY.

14.22. The complex type AlternativeServiceStructure

-

AlternativeServiceStructure

Service that provides shared vehicles (The Transmodel MODE OF OPERATION is VEHICLE SHARING; other related Transmodel concepts: ALTERNATIVE MODE LEG.SINGLE JOURNEY.COMMON.VEHICLE SERVICE.TRANSPORT ORGANISATION).

The element contains a sequence of the following elements:

OperatorRef

1:1

siri:OperatorRefStructure

Identifier of the operator of the sharing service

Name

0:1

xs:string

Public name of the service.

AlternativeServiceUsage

TimeBufferBefore

0:1

xs:duration

Typical time a user will need to check in and unlock the vehicle.

TimeBufferAfter

0:1

xs:duration

Typical time a user will need to lock the vehicle and check out.

InfoUrl

0:1

+WebLink

Link to the web page providing more details on the service.

Restricted

0:1

xs:boolean

This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g. dragLift) or the LINE is only made available to certain passenger groups (e.g. school buses, hotel shuttles).

RestrictionNote

0:1

+InternationalText

Information about the restriction.

14.23. The complex type OwnerRefStructure

OwnerRefStructure

OwnerCode

Reference to an ORGANISATION with ownership as the RESPONSIBILITY ROLE

14.24. The toplevel element OwnerRef

OwnerRef

+OwnerRef

Reference to an ORGANISATION with ownership as the RESPONSIBILITY ROLE

14.25. The complex type OperatingDayRefStructure

OperatingDayRefStructure

OperatingDayCode

Reference to an Operating Day

14.26. The toplevel element OperatingDayRef

OperatingDayRef

+OperatingDayRef

Reference to an Operating Day

14.27. The complex type OperatingDaysStructure

OperatingDaysStructure

[TMv6] day of public transport operation of which the characteristics are defined in a specific SERVICE CALENDAR and which may last more than 24 hours. This is useful, when the trip can be made during several days. Often users search in "general" withouth setting a date and then refine with the actual date. By using OperatingDaysStructure the result can directly be reused without an additional OJPTripRequest.

The element contains a sequence of the following elements:

From

1:1

xs:date

Start date of period.

To

1:1

xs:date

End date of period.

Pattern

1:1

ValidDayBit

Bit pattern for operating days between start date and end date. The length of the pattern is equal to the number of days from start date to end date. A bit value of "1" indicates that an event actually happens on the day that is represented by the bit position.

14.28. The OperatingDaysGroup group

+

OperatingDaysGroup

Coded as bit pattern

InfoUrl

0:1

+WebLink

Link to the web page providing more details on the service.

Restricted

0:1

xs:boolean

This flag is set if the service can only be used in a restricted way. For example, a specific ACCESS MODE is required (e.g., dragLift) or the LINE is only made available to certain passenger groups (e.g., school buses, hotel shuttles).

RestrictionNote

0:1

+InternationalText

Information about the restriction.

14.23. The complex type OwnerRefStructure

OwnerRefStructure

OwnerCode

Reference to an ORGANISATION with ownership as the RESPONSIBILITY ROLE

14.24. The toplevel element OwnerRef

OwnerRef

+OwnerRef

Reference to an ORGANISATION with ownership as the RESPONSIBILITY ROLE

14.25. The complex type OperatingDayRefStructure

OperatingDayRefStructure

OperatingDayCode

Reference to an Operating Day

14.26. The toplevel element OperatingDayRef

OperatingDayRef

+OperatingDayRef

Reference to an Operating Day

14.27. The complex type OperatingDaysStructure

OperatingDaysStructure

[TMv6] day of public transport operation of which the characteristics are defined in a specific SERVICE CALENDAR and which may last more than 24 hours. This is useful, when the trip can be made during several days. Often users search in "general" withouth setting a date and then refine with the actual date. By using OperatingDaysStructure the result can directly be reused without an additional OJPTripRequest.

The element contains a sequence of the following elements:

From

1:1

xs:date

Start date of period.

To

1:1

xs:date

End date of period.

Pattern

1:1

ValidDayBit

Bit pattern for operating days between start date and end date. The length of the pattern is equal to the number of days from start date to end date. A bit value of "1" indicates that an event happens on the day that is represented by the bit position.

14.28. The OperatingDaysGroup group

- +

OperatingDaysGroup

Coded as bit pattern

OperatingDays

OperatingDays

0:1

+OperatingDays

Bit string definition of operating days.

OperatingDaysDescription

0:1

+InternationalText

Textual description of the operation days, e.g. "monday to friday" or "not on holidays".

OperatingDaysDescription

0:1

+InternationalText

Textual description of the operation days, e.g., "Monday to Friday" or "not on holidays".

14.29. The complex type WeekdayTimePeriodStructure

WeekdayTimePeriodStructure

[a specialisation of TIME BAND in TMv6] aggregation of TIME BAND and DAY OF WEEK (Time period on a weekday).

The element contains a sequence of the following elements:

Weekday

0:*

WeekdayType

[a specialisation of DAY OF WEEK in TMv6] enumeration of individual the seven DAYs OF WEEK, along with public holidays

StartTime

1:1

xs:time

Start time of period.

Duration

1:1

xs:duration

Time duration of period.

14.30. The complex type GeneralAttributeStructure

- +

GeneralAttributeStructure

Structured attribute classification with associated text. If URL is given, it refers to the whole attribute text.

The element contains a sequence of the following elements:

UserText

1:1

+InternationalText

Text of the attribute to be shown to the user.

Code

1:1

xs:NMTOKEN

Internal code of the attribute. Can be used for detection of double occurrences.

Key

0:1

xs:NMTOKEN

Key if the attribute is used as a key/value pair.

Value

0:1

xs:string

Value if the attribute is used as a key/value pair.

Facility

0:*

siri:AllFacilitiesFeatureStructure

Facilities associated with this attribute.

Mandatory

0:1

xs:boolean

Defines whether the attribute has to be shown to the user.

Importance

0:1

Percent

Importance of the attribute.

WebLink

Url

1:1

xs:anyURI

URL to resource on web.

MimeType

0:1

xs:normalizedString

MIME type of the referenced resource. To which kind of resource does the URL point to?

Embeddable

0:1

xs:boolean

Is the referenced resource meant to be embedded as a webview in a surrounding context, e.g. app or web page? If yes, the resource has to be fully responsive. Default is false.

Embeddable

0:1

xs:boolean

Is the referenced resource meant to be embedded as a webview in a surrounding context, e.g., app or web page? If yes, the resource has to be fully responsive. Default is false.

14.31. The SustainabilityGroup group

SustainabilityGroup

Elements about sustainability. Primarily for TRIPs and LEGs.

Sustainability

EmissionCO2

0:1

+EmissionCO2

Estimation of CO2 emissions.

14.32. The complex type EmissionCO2Structure

@@ -1829,24 +1829,24 @@

OJP - Open API for distributed Journey

EmissionCO2Structure

Estimation of CO2 emissions.

The element contains a sequence of the following elements:

KilogramPerPersonKm

1:1

Kilograms of CO2 emission by person and by kilometre.

15.2. The ServiceFacilityGroup group

ServiceFacilityGroup

Wrapper for SIRI service facilities.

→‍siri:ServiceFacilityGroup

-

16. OJP/OJP_ModesSupport.xsd - Supporting definitions for the classification of modes of transport

16.1. Simple type definitions

AlternativeModesOfOperationEnumeration

sharing | stationLessSharing | stationBasedSharing | singleStationBasedSharing | multipleStationBasedSharing | peerToPeerSharing | parkAndRideSharing | sharingClubSharing | prM | pooling | taxi | shuttle | dynamicPooling | longDistancePooling | commuterPooling | parkAndRidePooling | chauffeured | demandResponsive | flexibleArea | companyShuttle | hotelShuttle | hire | other

ALTERNATIVE MODE OF OPERATION offered.

ConventionalModesOfOperationEnumeration

scheduled | demandResponsive | flexibleRoute | flexibleArea | shuttle | pooling | replacement | school | pRM

Types of MODES OF OPERATION are scheduled, classic and also flexible. From NeTEx.

PersonalModesEnumeration

foot | bicycle | car | motorcycle | truck | scooter | other

TYPE OF MODE that can be used in an individual context. PERSONAL MODE in TM 6.2.

PersonalModesOfOperationEnumeration

self | own | otherOwned | privateLift | lease

PERSONAL MODE OF OPERATION

TransferTypeEnumeration

walk | shuttle | taxi | protectedConnection | guaranteedConnection | remainInVehicle | changeWithinVehicle | checkIn | checkOut | parkAndRide | bikeAndRide | carHire | bikeHire | other

TYPE OF TRANSFER. It is a mix between MODE information, MODE OF OPERATION information and a more stringent TYPE OF TRANSFER.

16.2. The complex type IndividualTransportOptionStructure

IndividualTransportOptionStructure

Individual modes and their usage limits as stated by the passenger (TRIP ACCESS CONSTRAINT).

The element contains a sequence of the following elements:

ItModeAndModeOfOperation

1:1

+ItModes

Combinations of MODE and MODE OPERATION for ACCESS LEG. If no MODE OF OPERATION is given, then all can be used. Usually the result will be the own vehicle.

MaxDistance

0:1

siri:DistanceType

Maximum distance in meters. If given, it restricts the maximum distance of routes with the given mode.

MaxDuration

0:1

xs:duration

Maximum duration. If given, it restricts the maximum time of routes with the given mode.

MinDistance

0:1

siri:DistanceType

Minimum distance in meters. If given, it restricts the minimum distance of routes with the given mode.

MinDuration

0:1

xs:duration

Minimum duration. If given, it restricts the minimum time of routes with the given mode.

Speed

0:1

OpenPercent

Relative speed in percent. If given slows the standard speed (below 100) or fasten it (above 100).

AdditionalTime

0:1

xs:duration

Additional time added to the actual traveling time needed to use a specific mode.

16.3. The complex type ModeStructure

- +

16. OJP/OJP_ModesSupport.xsd - Supporting definitions for the classification of modes of transport

16.1. Simple type definitions

ModeStructure

[a specialisation of MODE in TMv6] an extended range of VEHICLE MODEs, aggregating them with some SUBMODEs

The element contains a sequence of the following elements:

Mode

PtMode

1:1

siri:VehicleModesOfTransportEnumeration

Categorisation of a (conventional) PUBLIC TRANSPORT MODE. We use the SIRI 2.1 element which allows for many values in the enumeration. In OJP we don't use the following enumeration values: "pti1_xxx", "xxxServices" when a value without the "Service" exists for the same MODE, "allServicesExcept", "selfDrive", "taxi". Also in cases where only a "xxxService" exists in the enumeration, it should be avoided. "other" or "unknown" should only be used, if no other value applies.

AlternativeModesOfOperationEnumeration

sharing | stationLessSharing | stationBasedSharing | singleStationBasedSharing | multipleStationBasedSharing | peerToPeerSharing | parkAndRideSharing | sharingClubSharing | prM | pooling | taxi | shuttle | dynamicPooling | longDistancePooling | commuterPooling | parkAndRidePooling | chauffeured | demandResponsive | flexibleArea | companyShuttle | hotelShuttle | hire | other

ALTERNATIVE MODE OF OPERATION offered.

ConventionalModesOfOperationEnumeration

scheduled | demandResponsive | flexibleRoute | flexibleArea | shuttle | pooling | replacement | school | pRM

Types of MODES OF OPERATION are scheduled, classic and flexible. From NeTEx.

PersonalModesEnumeration

foot | bicycle | car | motorcycle | truck | scooter | other

TYPE OF MODE that can be used in an individual context. PERSONAL MODE in TM 6.2.

PersonalModesOfOperationEnumeration

self | own | otherOwned | privateLift | lease

PERSONAL MODE OF OPERATION

TransferTypeEnumeration

walk | shuttle | taxi | protectedConnection | guaranteedConnection | remainInVehicle | changeWithinVehicle | checkIn | checkOut | parkAndRide | bikeAndRide | carHire | bikeHire | other

TYPE OF TRANSFER. It is a mix between MODE information, MODE OF OPERATION information and a more stringent TYPE OF TRANSFER.

16.2. The complex type IndividualTransportOptionStructure

IndividualTransportOptionStructure

Individual modes and their usage limits as stated by the passenger (TRIP ACCESS CONSTRAINT).

The element contains a sequence of the following elements:

ItModeAndModeOfOperation

1:1

+ItModes

Combinations of MODE and MODE OPERATION for ACCESS LEG. If no MODE OF OPERATION is given, then all can be used. Usually, the result will be the own vehicle.

MaxDistance

0:1

siri:DistanceType

Maximum distance in meters. If given, it restricts the maximum distance of routes with the given mode.

MaxDuration

0:1

xs:duration

Maximum duration. If given, it restricts the maximum time of routes with the given mode.

MinDistance

0:1

siri:DistanceType

Minimum distance in meters. If given, it restricts the minimum distance of routes with the given mode.

MinDuration

0:1

xs:duration

Minimum duration. If given, it restricts the minimum time of routes with the given mode.

Speed

0:1

OpenPercent

Relative speed in percent. If given slows the standard speed (below 100) or fasten it (above 100).

AdditionalTime

0:1

xs:duration

Additional time added to the actual traveling time needed to use a specific mode.

16.3. The complex type ModeStructure

+

ModeStructure

[a specialisation of MODE in TMv6] an extended range of VEHICLE MODEs, aggregating them with some SUBMODEs

The element contains a sequence of the following elements:

Mode

PtMode

1:1

siri:VehicleModesOfTransportEnumeration

Categorisation of a (conventional) PUBLIC TRANSPORT MODE. We use the SIRI 2.1 element which allows for many values in the enumeration. In OJP we don't use the following enumeration values: "pti1_xxx", "xxxServices" when a value without the "Service" exists for the same MODE, "allServicesExcept", "selfDrive", "taxi". Also, in cases where only a "xxxService" exists in the enumeration, it should be avoided. "other" or "unknown" should only be used if no other value applies.

→‍siri:PtModeChoiceGroup

Name

0:1

+InternationalText

Name of the mode.

ShortName

0:1

+InternationalText

Short name or acronym of the mode.

Description

0:1

+InternationalText

Additional text that further describes the mode.

16.4. The ModeGroup group

- + -

ModeGroup

Elements for a Transport Mode

Mode

PtMode

1:1

siri:VehicleModesOfTransportEnumeration

Categorisation of a (conventional) PUBLIC TRANSPORT MODE. We use the SIRI 2.1 element which allows for many values in the enumeration. In OJP we don't use the following enumeration values: "pti1_xxx", "xxxServices" when a value without the "Service" exists for the same MODE, "allServicesExcept", "selfDrive", "taxi". Also in cases where only a "xxxService" exists in the enumeration, it should be avoided. "other" or "unknown" should only be used, if no other value applies.

Mode

PtMode

1:1

siri:VehicleModesOfTransportEnumeration

Categorisation of a (conventional) PUBLIC TRANSPORT MODE. We use the SIRI 2.1 element which allows for many values in the enumeration. In OJP we don't use the following enumeration values: "pti1_xxx", "xxxServices" when a value without the "Service" exists for the same MODE, "allServicesExcept", "selfDrive", "taxi". Also, in cases where only a "xxxService" exists in the enumeration, it should be avoided. "other" or "unknown" should only be used if no other value applies.

→‍siri:PtModeChoiceGroup

16.5. The complex type ModeFilterStructure

ModeFilterStructure

List of MODE to exclude or include.

The element contains a sequence of the following elements:

Exclude

0:1

xs:boolean

Whether MODEs in list are to be excluded or included from search. Default is to exclude.

PtMode

0:*

siri:VehicleModesOfTransportEnumeration

List of PT Transport modes to include/exclude. We use the SIRI 2.1 element which allows for many values in the enumeration. In OJP we don't use the following enumeration values: "pti1_xxx", "xxxServices" when a value without the "Service" exists for the same MODE, "allServicesExcept", "selfDrive", "taxi". Also in cases where only a "xxxService" exists in the enumeration, it should be avoided. "other" or "unknown" should only be used, if no other value applies.

PersonalMode

0:*

PersonalModes

List of personal transport modes to include/exclude. Those are also used in many of the ALTERNATIVE MODES OF OPERATION.

→‍siri:PtModeChoiceGroup

16.6. The complex type ModeAndModeOfOperationFilterStructure

ModeAndModeOfOperationFilterStructure

List of MODE and MODE OF OPERATION filter offers to include or exclude.

The element contains a sequence of the following elements:

Exclude

0:1

xs:boolean

Whether MODE and MODE OF OPERATION combination in list are to include or exclude from search. Default is exclude.

PtMode

0:*

siri:VehicleModesOfTransportEnumeration

List of PT Transport modes to include/exclude. We use the SIRI 2.1 element which allows for many values in the enumeration. In OJP we don't use the following enumeration values: "pti1_xxx", "xxxServices" when a value without the "Service" exists for the same MODE, "allServicesExcept", "selfDrive", "taxi". Also in cases where only a "xxxService" exists in the enumeration, it should be avoided. "other" or "unknown" should only be used, if no other value applies.

PersonalMode

0:*

PersonalModes

List of personal transport modes to include/exclude. Those are also used in many of the ALTERNATIVE MODES OF OPERATION.

→‍siri:PtModeChoiceGroup

PersonalModeOfOperation

0:*

PersonalModesOfOperation

List of personal mobility offers to include/exclude.

AlternativeModeOfOperation

0:*

AlternativeModesOfOperation

List of alternative mobility offers to include/exclude.

ConventionalModeOfOperation

0:*

ConventionalModesOfOperation

List of conventional mobility offers to include/exclude.

16.7. The complex type ItModesStructure

ItModesStructure

Combinations of MODE and MODE OF OPERATION that should be covered as monomodal trips (or for the ACCESS LEGs). If no MODE OF OPERATION is added usually "own" is assumed. But the trip planner may add other relevant results (e.g. sharing, if sensible trips are possible).

The element contains a sequence of the following elements:

PersonalMode

1:1

PersonalModes

Relevant PERSONAL MODE to be used for the monomodal trip.

PersonalModeOfOperation

0:*

PersonalModesOfOperation

List of personal mobility offers for this MODE.

AlternativeModeOfOperation

0:*

AlternativeModesOfOperation

List of alternative mobility offers for this MODE.

+

16.5. The complex type ModeFilterStructure

ModeFilterStructure

List of MODE to exclude or include.

The element contains a sequence of the following elements:

Exclude

0:1

xs:boolean

Whether MODEs in list are to be excluded or included from search. Default is to exclude.

PtMode

0:*

siri:VehicleModesOfTransportEnumeration

List of PT Transport modes to include/exclude. We use the SIRI 2.1 element which allows for many values in the enumeration. In OJP we don't use the following enumeration values: "pti1_xxx", "xxxServices" when a value without the "Service" exists for the same MODE, "allServicesExcept", "selfDrive", "taxi". Also, in cases where only a "xxxService" exists in the enumeration, it should be avoided. "other" or "unknown" should only be used if no other value applies.

PersonalMode

0:*

PersonalModes

List of personal transport modes to include/exclude. Those are also used in many of the ALTERNATIVE MODES OF OPERATION.

→‍siri:PtModeChoiceGroup

16.6. The complex type ModeAndModeOfOperationFilterStructure

ModeAndModeOfOperationFilterStructure

List of MODE and MODE OF OPERATION filter offers to include or exclude.

The element contains a sequence of the following elements:

Exclude

0:1

xs:boolean

Whether MODE and MODE OF OPERATION combination in list are to include or exclude from search. Default is exclude.

PtMode

0:*

siri:VehicleModesOfTransportEnumeration

List of PT Transport modes to include/exclude. We use the SIRI 2.1 element which allows for many values in the enumeration. In OJP we don't use the following enumeration values: "pti1_xxx", "xxxServices" when a value without the "Service" exists for the same MODE, "allServicesExcept", "selfDrive", "taxi". Also, in cases where only a "xxxService" exists in the enumeration, it should be avoided. "other" or "unknown" should only be used if no other value applies.

PersonalMode

0:*

PersonalModes

List of personal transport modes to include/exclude. Those are also used in many of the ALTERNATIVE MODES OF OPERATION.

→‍siri:PtModeChoiceGroup

PersonalModeOfOperation

0:*

PersonalModesOfOperation

List of personal mobility offers to include/exclude.

AlternativeModeOfOperation

0:*

AlternativeModesOfOperation

List of alternative mobility offers to include/exclude.

ConventionalModeOfOperation

0:*

ConventionalModesOfOperation

List of conventional mobility offers to include/exclude.

16.7. The complex type ItModesStructure

ItModesStructure

Combinations of MODE and MODE OF OPERATION that should be covered as monomodal trips (or for the ACCESS LEGs). If no MODE OF OPERATION is added usually "own" is assumed. But the trip planner may add other relevant results (e.g., sharing, if sensible trips are possible).

The element contains a sequence of the following elements:

PersonalMode

1:1

PersonalModes

Relevant PERSONAL MODE to be used for the monomodal trip.

PersonalModeOfOperation

0:*

PersonalModesOfOperation

List of personal mobility offers for this MODE.

AlternativeModeOfOperation

0:*

AlternativeModesOfOperation

List of alternative mobility offers for this MODE.

17. OJP/OJP_SituationSupport.xsd - Supporting definitions for situations containing wrappers for SIRI Situation Exchange service (SIRI SX)

17.1. The complex type SituationsStructure

SituationsStructure

Wrapper type for SIRI PtSituationsElementStructure

The element contains a sequence of the following elements:

PtSituation

0:*

siri:PtSituationElementStructure

SIRI situation details in public transport, see CEN/TS 15531-5.

RoadSituation

0:*

siri:RoadSituationElementStructure

SIRI situation details in individual transport, see CEN/TS 15531-5.

17.2. The toplevel element SituationFullRef

SituationFullRef

+SituationFullRef

Reference to situation message. Message details might be found in response context or through other communication channels.

17.3. The complex type SituationFullRefStructure

SituationFullRefStructure

siri:SituationFullRefStructure

Reference structure for situation message. Situation details might be found in response context or through other communication channels.

17.4. The complex type SituationRefList

SituationRefList

List of references to SITUATIONs.

The element contains only one element:

→‍SituationFullRef

1:*

→‍SituationFullRef

Reference to situation message. Message details might be found in response context or through other communication channels.

18. OJP/OJP_Utility.xsd - Support definitions not specifically related to the public transport domain

18.1. Simple type definitions

EmailAddressType

xs:normalizedString

Type definition for email addresses.

LengthType

xs:nonNegativeInteger

Data type for lengths, in meters.

OpenPercentType

xs:nonNegativeInteger

Percent value as integer, no upper limit.

PercentType

xs:nonNegativeInteger

Percent value as integer, limited to max value 100.

PhoneNumberType

xs:normalizedString

Type definition for phone numbers

PriorityType

xs:nonNegativeInteger

Data type for priority values, from 1 (highest) to 5 (lowest).

ValidDayBitType

xs:string

sequence of bits (values 0 or 1) coded as a text string and representing days

18.2. The complex type InternationalTextStructure

InternationalTextStructure

[a restricted view of ALTERNATIVE NAME in TMv6] alternative identified text to be used in specified languages.

The element contains a sequence of the following elements:

Text

1:*

siri:NaturalLanguageStringStructure

Text content.

TextId

0:1

xs:NMTOKEN

Id of this text. May be used for matching to pre-recorded audio files.

18.3. The WebLinkGroup group

- +

WebLinkGroup

URL of a web resource including type of resource.

WebLink

Url

1:1

xs:anyURI

URL to resource on web.

MimeType

0:1

xs:normalizedString

MIME type of the referenced resource. To which kind of resource does the URL point to?

Embeddable

0:1

xs:boolean

Is the referenced resource meant to be embedded as a webview in a surrounding context, e.g. app or web page? If yes, the resource has to be fully responsive. Default is false.

Embeddable

0:1

xs:boolean

Is the referenced resource meant to be embedded as a webview in a surrounding context, e.g., app or web page? If yes, the resource has to be fully responsive. Default is false.

18.4. The complex type WebLinkStructure

- +

WebLinkStructure

URL of a web resource with label.

The element contains a sequence of the following elements:

Label

1:1

+InternationalText

Label for link description.

WebLink

Url

1:1

xs:anyURI

URL to resource on web.

MimeType

0:1

xs:normalizedString

MIME type of the referenced resource. To which kind of resource does the URL point to?

Embeddable

0:1

xs:boolean

Is the referenced resource meant to be embedded as a webview in a surrounding context, e.g. app or web page? If yes, the resource has to be fully responsive. Default is false.

Embeddable

0:1

xs:boolean

Is the referenced resource meant to be embedded as a webview in a surrounding context, e.g., app or web page? If yes, the resource has to be fully responsive. Default is false.

19. OJP/OJP_Status.xsd - OJP Status request and response

19.1. Simple type definitions

StatusProblemTypeEnumeration

STATUS_INSTANCE_USAGE_DEPRECATED | STATUS_OTHER

Types of problems that may be returned in responses to status requests.

19.2. The toplevel element StatusProblemType

StatusProblemType

StatusProblemType (↔ ErrorType)

19.3. The toplevel element OJPStatusResponse

OJPStatusResponse

+OJPStatusResponse (↔ siri:AbstractFunctionalServiceCapabilitiesResponse)

19.4. The complex type OJPStatusResponseStructure

diff --git a/examples/functions/trip/TR_ParallelService_OeBB_wrong.xml b/examples/functions/trip/TR_ParallelService_OeBB_wrong.xml index 32e38cea..4e65eb65 100644 --- a/examples/functions/trip/TR_ParallelService_OeBB_wrong.xml +++ b/examples/functions/trip/TR_ParallelService_OeBB_wrong.xml @@ -2,10 +2,10 @@ 5 7 diff --git a/examples/functions/trip_information/TIR_response_with_JourneyRelations.xml b/examples/functions/trip_information/TIR_response_with_JourneyRelations.xml index 5e55c3b1..468cabb4 100644 --- a/examples/functions/trip_information/TIR_response_with_JourneyRelations.xml +++ b/examples/functions/trip_information/TIR_response_with_JourneyRelations.xml @@ -66,7 +66,7 @@ cen:CompoundTrain:gfa-k498sdf9-5j32-4944-h034-hjf02023h8g4 8591315:A - + @@ -84,7 +84,7 @@ cen:CompoundTrain:gfa-k498sdf9-5j32-4944-h034-hjf02023h8g4 8591049:C - + diff --git a/examples/functions/trip_information/TIR_response_with_formation.xml b/examples/functions/trip_information/TIR_response_with_formation.xml index e25bcffb..c9676a9c 100644 --- a/examples/functions/trip_information/TIR_response_with_formation.xml +++ b/examples/functions/trip_information/TIR_response_with_formation.xml @@ -66,7 +66,7 @@ cen:CompoundTrain:gfa-k498sdf9-5j32-4944-h034-hjf02023h8g4 8591315:A - + @@ -84,7 +84,7 @@ cen:CompoundTrain:gfa-k498sdf9-5j32-4944-h034-hjf02023h8g4 8591049:C - +

OJPStatusResponseStructure

siri:AbstractServiceCapabilitiesResponseStructure