From f1531f73fa4259f393f59b7eb570b882ee3d337e Mon Sep 17 00:00:00 2001 From: trurlurl <82838870+trurlurl@users.noreply.github.com> Date: Mon, 16 Jan 2023 13:06:22 +0100 Subject: [PATCH 1/3] Add AvailabilityRequest from TRIAS (#262) --- OJP/OJP_All.xsd | 1 + OJP/OJP_Availability.xsd | 426 ++++++ OJP/OJP_Requests.xsd | 26 + OJP/OJP_Utility.xsd | 6 + docs/generated/index.html | 1317 +++++++++-------- docs/schema-collection.xml | 18 +- examples/function/OJPAvailabilityRequest.xml | 70 + .../function/OJPAvailabilityRequest_1.xml | 29 + .../function/OJPAvailabilityRequest_2.xml | 29 + .../OJPAvailabilityResponse notOK.xml | 10 + .../function/OJPAvailabilityResponse_OK.xml | 27 + 11 files changed, 1361 insertions(+), 598 deletions(-) create mode 100644 OJP/OJP_Availability.xsd create mode 100644 examples/function/OJPAvailabilityRequest.xml create mode 100644 examples/function/OJPAvailabilityRequest_1.xml create mode 100644 examples/function/OJPAvailabilityRequest_2.xml create mode 100644 examples/function/OJPAvailabilityResponse notOK.xml create mode 100644 examples/function/OJPAvailabilityResponse_OK.xml diff --git a/OJP/OJP_All.xsd b/OJP/OJP_All.xsd index 1fba79bd5..879d7f59a 100644 --- a/OJP/OJP_All.xsd +++ b/OJP/OJP_All.xsd @@ -3,6 +3,7 @@ OJP/OJP_All.xsd - Includes for all OJP schema files + diff --git a/OJP/OJP_Availability.xsd b/OJP/OJP_Availability.xsd new file mode 100644 index 000000000..83bf5015f --- /dev/null +++ b/OJP/OJP_Availability.xsd @@ -0,0 +1,426 @@ + + + + OJP/OJP_Availability.xsd - Request and response definitions for availability of tickets and services on a journey leg. + + + + + ========================================== AvailabilityRequest ========================================== + + + + 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. + + + + + A choice as we assume that here future extensions may occur (non-public transport). + + + + Definition of the journey leg to be covered by public transport. Other mobility services can be added later. + + + + + + Passenger(s) for whom the service needs to be booked, one MobilityUser per passenger. + + + + + This element is only used to transmit restrictions from the earlier/or later trip part. The possible trip is the result of a previous OJPTripRequest. The desired time for the public transport is set within PublicTransport element. + + + + + + + ========================================== Additional Declarations ========================================== + + + + Journey leg by public transport. + + + + + Location where passenger intends to enter the service. + + + + + Location where passenger intends to leave the service. + + + + + Properties of a service (line and direction) by which the availability is being checked: attributes of ContinuousServiceStructure or DatedJourneyStructure. + + + + + + + + Passenger(s) for whom the service needs to be booked. + + + + + Age of the passenger on the day of travel. + + + + + + + + + Provisioned vehicle call at a general location. + + + + + + More general location for a call than stop points. May be used with flexible services or "Area Dial-A-Ride". + + + + + Arrival times of the service at this stop. + + + + + Departure times of the service at this stop. + + + + + + + + + Earliest possible departure time from a start location and latest possible arrival at a different destination location. + + + + + + + + ========================================== From Trias_JourneySupport.xsd ========================================== + + + + Profile of the passenger's abilities. + + + + + Passenger uses a wheelchair. Default is FALSE. + + + + + Passenger uses a walking frame. Default is FALSE. + + + + + Passenger uses a walking stick. Default is FALSE. + + + + + Passenger is (maybe temporarily) walking impaired. Default is FALSE. + + + + + Passenger has a pram with him/her. Default is FALSE. + + + + + Passenger has got heavy luggage. Default is FALSE. + + + + + Passenger is visually impaired. + + + + + Passenger is hearing impaired. + + + + + Passenger is reading impaired. + + + + + + + Description of passenger's accessibility requirements + + + + + + + + + Requirements for the driver/staff to assist the passenger when boarding/alighting. + + + + + Whether assistance is required for boarding. Could be offered by the driver or station staff. Default is FALSE. + + + + + Whether assistance is required for alighting. Could be offered by the driver or station staff. Default is FALSE. + + + + + + ========================================== AvailabilityResponse ========================================== + + + + Availability response. + + + + + Indication of the availability of the requested service. + + + + + + + ========================================== Additional declarations ========================================== + + + + Availability result structure. + + + + + Problems related to this AVAILABILITY result. + + + + + + Definition of the journey leg that should be made by public transport. Other mobility services may be added later. + + + + + + + + + ==================== ticket and service information ===================== + + + + Lists those tickets or surcharges and service characteristics such as the transportation of wheelchairs, prams, luggage etc. or the provision of required child seats or booster seats that are offered in the trips transport company to be booked for the trip. + + + + + Sequence of bookable tickets or surcharges for this part of the trip. If ticket price is zero: an already purchased/virtual ticket of this type presented to the driver would be accepted. + + + + + Sequence of bookable service items for this part of the trip. + + + + + + + Possible service items that can be booked in the actual booking system (defined by the traffic company of charge). Only those elements with value greater 0 are bookable. The indicated capacity corresponds to the maximum number that can be booked in one booking. This number does not have to be available for the specific booking and may result in booking failure. Caution: list can vary widely from one traffic company to another. + + + + + The type of bookable service. + + + + + Maximum number of service items that can be booked in one booking transaction. Default is 0. + + + + + + + Types of bookable service items. + + + + + Space for a wheelchair. + + + + + Space for a motorised wheelchair. + + + + + Space for storing a foldable wheelchair. + + + + + Place suitable for a person with a walking frame. + + + + + Space for a pram or pushchair. + + + + + Space for storing heavy luggage. + + + + + Seat suitable for attaching a child seat taken along by the passengers. + + + + + Child seat provided in the vehicle. + + + + + Seat suitable for attaching a baby carrier taken along by the passengers. + + + + + Baby carrier provided in the vehicle. + + + + + Seat booster provided in the vehicle. + + + + + Space for a bicycle. + + + + + Place suitable when accompanied by a guide dog. + + + + + Place suitable when accompanied by a dog. + + + + + Assistance for boarding. + + + + + Assistance for unboarding. + + + + + Assistance available on board, during the journey. + + + + + Assistance for a minor travelling alone. + + + + + + ========================================== Problems ========================================== + + + + Types of problems that may be returned in responses to AVAILABILITY requests. + + + + + No SERVICE (VEHICLE JOURNEY or VEHICLE) could be found for this request. + + + + + At the locations (address, stop, etc.) for which the availability has been requested, there is no public transport service at all. E.g. outside of the area + + + + + The location (address, stop, etc.) for which availability was requested is unknown. + + + + + 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, which rules where violated: e.g. The desired MOBILITY SERVICE can't be provided, because there exists a regulare line for this TRIP. + + + + + The MOBILITY SERVICE is disrupted. + + + + + There is no VEHICLE available at the current time. + + + + + A problem has occurred that does not have a specific problem type. + + + + + + + Problem that may be returned in responses to AVAILABILITY requests. + + + + + Type of the AVAILABILITY problem. + + + + + + diff --git a/OJP/OJP_Requests.xsd b/OJP/OJP_Requests.xsd index a9600ffca..a79b4f479 100644 --- a/OJP/OJP_Requests.xsd +++ b/OJP/OJP_Requests.xsd @@ -221,4 +221,30 @@ + + ========================================== Availability Request ========================================== + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/OJP/OJP_Utility.xsd b/OJP/OJP_Utility.xsd index 37defa922..812bcf449 100644 --- a/OJP/OJP_Utility.xsd +++ b/OJP/OJP_Utility.xsd @@ -48,6 +48,12 @@ + + + Type definition for e-mail addresses. + + + [a restricted view of ALTERNATIVE NAME in TMv6] alternative identified text to be used in specified languages. diff --git a/docs/generated/index.html b/docs/generated/index.html index cc78e7a5a..d6b2d16d5 100644 --- a/docs/generated/index.html +++ b/docs/generated/index.html @@ -56,60 +56,264 @@

OJP - Open API for distributed Journey
Table of Contents
+

1. OJP.xsd - OJP messages as extension of SIRI

1.1. The toplevel element OJP

OJP

Root element for OJP messages based on SIRI message exchange protocol.

@version

1:1

xs:NMTOKEN

Fixed value: "1.1-dev"

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

a

→‍OJPRequest

-1:1

→‍OJPRequest

OJP Request - Groups individual functional requests.

b

→‍OJPResponse

-1:1

→‍OJPResponse

OJP Request - Groups individual functional responses.

→‍Extensions

0:1

→‍Extensions

1.2. The toplevel element OJPRequest

OJPRequest

+OJPRequest

OJP Request - Groups individual functional requests.

1.3. The complex type OJPRequestStructure

OJPRequestStructure

Type for OJP Request - Groups individual functional requests.

The element contains only one element:

→‍RequestGroup

1.4. The toplevel element OJPResponse

OJPResponse

+OJPResponse

OJP Request - Groups individual functional responses.

1.5. The complex type OJPResponseStructure

OJPResponseStructure

Type for OJP Response - Groups individual functional responses.

The element contains only one element:

→‍ResponseGroup

-

2. OJP/OJP_Common.xsd - Supporting definitions of common structures

2.1. Simple type definitions

JourneyCodeType

xs:NMTOKEN

Identifier of a Journey

OperatingDayCodeType

xs:NMTOKEN

Identifier of an Operating Day

OwnerCodeType

xs:NMTOKEN

identifier of ORGANISATION with ownership as the RESPONSIBILITY ROLE

ProductCategoryCodeType

xs:NMTOKEN

Type for identifier of an product category code.

SharingModelEnumeration

singleStationBased | multipleStationBased | nonStationBased

Sharing service loan and return scheme.

WeekdayTypeEnumeration

Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday | PublicHoliday

[a specialisation of DAY OF WEEK in TMv6] enumeration of individual the seven DAYs OF WEEK, along with public holidays

2.2. The ProblemDetailGroup group

+

2. OJP/OJP_Requests.xsd - OJP service requests and responses

2.1. The toplevel element OJPFareRequest

ProblemDetailGroup

Detailed description of the problem.

OJPFareRequest

+OJPFareRequest (↔ siri:AbstractFunctionalServiceRequest)

2.2. The complex type OJPFareRequestStructure

+ + + + + + +

OJPFareRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

Then, 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

StaticFareRequest

-1:1

+StaticFareRequest

A request for general/static Fare information.

c

StopFareRequest

-1:1

+StopFareRequest

A request for stop-related Fare information.

d

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.

→‍siri:Extensions

0:1

→‍siri:Extensions

2.3. The toplevel element OJPFareDelivery

OJPFareDelivery

+OJPFareDelivery (↔ siri:AbstractFunctionalServiceDelivery)

2.4. The complex type OJPFareDeliveryStructure

+ + + + + + + + + + +

OJPFareDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

FareResponse

FareResponseContext

0:1

+ResponseContext

Context to hold trip response objects that occur frequently.

FareResult

0:*

+FareResult

Fare result choice element.

→‍siri:Extensions

0:1

→‍siri:Extensions

2.5. The toplevel element OJPPlaceInformationRequest

OJPPlaceInformationRequest

+OJPPlaceInformationRequest (↔ siri:AbstractFunctionalServiceRequest)

2.6. The complex type OJPPlaceInformationRequestStructure

+ + + + + + +

OJPPlaceInformationRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

PlaceInformationRequest

a

InitialInput

-1:1

+InitialPlaceInput

Initial input for the place information request. This input defines what is originally looked for.

b

PlaceRef

-1:1

+PlaceRef

Place for further refinement. If a place in a previous response was marked as not "complete" it can be refined by putting it here.

Restrictions

0:1

+PlaceParam

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

→‍siri:Extensions

0:1

→‍siri:Extensions

2.7. The toplevel element OJPPlaceInformationDelivery

OJPPlaceInformationDelivery

+OJPPlaceInformationDelivery (↔ siri:AbstractFunctionalServiceDelivery)

2.8. The complex type OJPPlaceInformationDeliveryStructure

+ + + + + + + + + + + +

OJPPlaceInformationDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

→‍OJPPlaceInformationRequest

0:1

→‍OJPPlaceInformationRequest

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

PlaceInformationResponse

PlaceInformationResponseContext

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

→‍siri:Extensions

0:1

→‍siri:Extensions

2.9. The toplevel element OJPExchangePointsRequest

OJPExchangePointsRequest

+OJPExchangePointsRequest (↔ siri:AbstractFunctionalServiceRequest)

2.10. The complex type OJPExchangePointsRequestStructure

+ + + + + + +

OJPExchangePointsRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

ExchangePointsRequest

PlaceRef

0:1

+PlaceRef

Place for which exchange points to other "neighbour" systems are to be searched. This place is usually the origin/destination of a passenger journey. May be omitted if all exchange points shall be returned.

Params

0:1

+ExchangePointsParam

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

→‍siri:Extensions

0:1

→‍siri:Extensions

2.11. The toplevel element OJPExchangePointsDelivery

OJPExchangePointsDelivery

+OJPExchangePointsDelivery (↔ siri:AbstractFunctionalServiceDelivery)

2.12. The complex type OJPExchangePointsDeliveryStructure

+ + + + + + + + + + + +

OJPExchangePointsDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

→‍OJPExchangePointsRequest

0:1

→‍OJPExchangePointsRequest

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

ExchangePointsResponse

ExchangePointResponseContext

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.

Place

0:*

+ExchangePointsResult

→‍siri:Extensions

0:1

→‍siri:Extensions

2.13. The toplevel element OJPStopEventRequest

OJPStopEventRequest

+OJPStopEventRequest (↔ siri:AbstractFunctionalServiceRequest)

2.14. The complex type OJPStopEventRequestStructure

+ + + + + + +

OJPStopEventRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

StopEventRequest

Place

1:1

+PlaceContext

Place for which to obtain stop event information.

Params

0:1

+StopEventParam

Request parameter

→‍siri:Extensions

0:1

→‍siri:Extensions

2.15. The toplevel element OJPStopEventDelivery

OJPStopEventDelivery

+OJPStopEventDelivery (↔ siri:AbstractFunctionalServiceDelivery)

2.16. The complex type OJPStopEventDeliveryStructure

+ + + + + + + + + + +

OJPStopEventDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

→‍OJPStopEventRequest

0:1

→‍OJPStopEventRequest

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

StopEventResponse

StopEventResponseContext

0:1

+ResponseContext

Container for data that is referenced multiple times.

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)

2.18. The complex type OJPTripInfoRequestStructure

+ + + + + + + + + + + + +

OJPTripInfoRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

DatedJourneyRef

a

→‍JourneyRef

1:1

→‍JourneyRef

Reference to a Journey

a

→‍OperatingDayRef

1:1

→‍OperatingDayRef

Reference to an Operating Day

TimedVehicleRef

b

→‍siri:VehicleRef

1:1

→‍siri:VehicleRef

b

TimeOfOperation

1:1

xs:dateTime

Time stamp when the vehicle is operating. In most use cases equal to "now".

TripInfoRequest

Params

0:1

+TripInfoParam

Request parameter.

→‍siri:Extensions

0:1

→‍siri:Extensions

2.19. The toplevel element OJPTripInfoDelivery

OJPTripInfoDelivery

+OJPTripInfoDelivery (↔ siri:AbstractFunctionalServiceDelivery)

2.20. The complex type OJPTripInfoDeliveryStructure

+ + + + + + + + + + +

OJPTripInfoDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

→‍OJPTripInfoRequest

0:1

→‍OJPTripInfoRequest

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

TripInfoResponse

TripInfoResponseContext

0:1

+ResponseContext

Response context.

TripInfoResult

0:1

+TripInfoResult

Result structure.

→‍siri:Extensions

0:1

→‍siri:Extensions

2.21. The toplevel element OJPTripRequest

OJPTripRequest

+OJPTripRequest (↔ siri:AbstractFunctionalServiceRequest)

2.22. The complex type OJPTripRequestStructure

+ + + + + + + + + + +

OJPTripRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

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.

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.

Params

0:1

+TripParam

Options to control the search behaviour and response contents.

→‍siri:Extensions

0:1

→‍siri:Extensions

2.23. The toplevel element OJPTripDelivery

OJPTripDelivery

+OJPTripDelivery (↔ siri:AbstractFunctionalServiceDelivery)

2.24. The complex type OJPTripDeliveryStructure

+ + + + + + + + + + +

OJPTripDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

→‍OJPTripRequest

0:1

→‍OJPTripRequest

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

TripResponse

TripResponseContext

0:1

+ResponseContext

Context to hold trip response objects that occur frequently.

TripResult

0:*

+TripResult

The trip results found by the server.

→‍siri:Extensions

0:1

→‍siri:Extensions

2.25. The toplevel element OJPMultiPointTripRequest

OJPMultiPointTripRequest

+OJPMultiPointTripRequest (↔ siri:AbstractFunctionalServiceRequest)

2.26. The complex type OJPMultiPointTripRequestStructure

+ + + + + + + + + + +

OJPMultiPointTripRequestStructure

+AbstractOJPServiceRequest

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.

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

Params

0:1

+MultiPointTripParam

Options to control the search behaviour and response contents.

→‍siri:Extensions

0:1

→‍siri:Extensions

2.27. The toplevel element OJPMultiPointTripDelivery

OJPMultiPointTripDelivery

+OJPMultiPointTripDelivery (↔ siri:AbstractFunctionalServiceDelivery)

2.28. The complex type OJPMultiPointTripDeliveryStructure

+ + + + + + + + + + +

OJPMultiPointTripDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

→‍OJPMultiPointTripRequest

0:1

→‍OJPMultiPointTripRequest

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

MultiPointTripResponse

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

2.29. The toplevel element OJPTripRefineRequest

OJPTripRefineRequest

+OJPTripRefineRequest (↔ siri:AbstractFunctionalServiceRequest)

2.30. The complex type OJPTripRefineRequestStructure

+ + + + + + + +

OJPTripRefineRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

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.

→‍siri:Extensions

0:1

→‍siri:Extensions

2.31. The toplevel element OJPTripRefineDelivery

OJPTripRefineDelivery

+OJPTripRefineDelivery (↔ siri:AbstractFunctionalServiceDelivery)

2.32. The complex type OJPTripRefineDeliveryStructure

+ + + + + + + + + + + +

OJPTripRefineDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

→‍OJPTripRefineRequest

0:1

→‍OJPTripRefineRequest

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

TripRefineResponse

TripResponseContext

0:1

+ResponseContext

Context to hold trip response objects that occur frequently.

UnknownLegRef

0:*

xs:NMTOKEN

Refers to a leg that was not found in the data of the server. If the to be refined TripResult could not be found or unequivocally determined, all RefineLegRefs are returned as UnknownLegRefs.

TripResult

0:*

+TripResult

The trip results refined by the server.

→‍siri:Extensions

0:1

→‍siri:Extensions

2.33. The toplevel element OJPAvailabilityRequest

OJPAvailabilityRequest

+OJPAvailabilityRequest (↔ siri:AbstractFunctionalServiceRequest)

2.34. The complex type OJPAvailabilityRequestStructure

+ + + + + + + + + + + +

OJPAvailabilityRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

Then, 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.

MinMaxTimeBand

EarliestDepartureTime

0:1

xs:dateTime

LatestArrivalTime

0:1

xs:dateTime

AvailabilityRequest

Extension

0:1

xs:anyType

→‍siri:Extensions

0:1

→‍siri:Extensions

2.35. The toplevel element OJPAvailabilityDelivery

OJPAvailabilityDelivery

+OJPAvailabilityDelivery (↔ siri:AbstractFunctionalServiceDelivery)

2.36. The complex type OJPAvailabilityDeliveryStructure

+ + + + + + + + + + +

OJPAvailabilityDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

AvailabilityResponse

AvailabilityResult

0:1

+AvailabilityResult

Indication of the availability of the requested service.

Extension

0:1

xs:anyType

→‍siri:Extensions

0:1

→‍siri:Extensions

+

3. OJP/OJP_RequestSupport.xsd - Supporting definitions for OJP service requests and their responses

3.1. Simple type definitions

CalcTimeType

xs:integer

Type definition for calculation time in milliseconds.

CertificateIdType

xs:NMTOKEN

Type definition for the form of identification that can be used as a Message Integrity Property (public key cryptography)

OJPGenericProblemTypeEnumeration

OJPGENERIC_REQUESTNOTSUPPORTED | OJPGENERIC_FEATURENOTSUPPORTED | OJPGENERIC_LANGUAGENOTSUPPORTED | OJPGENERIC_EXCEPTIONFROMREQUESTEDLANGUAGE | OJPGENERIC_DATAFRAMEREFNOTAVAILABLE | OJPGENERIC_OTHER

Types of problems that may be returned in case of generic problems with the request.

SignatureType

xs:string

data for transmission of message signatures (public key cryptography), used to prove Message Integrity

3.2. The MessageIntegrityPropertiesGroup group

+ + +

MessageIntegrityPropertiesGroup

Properties that allow checks for message integrity.

MessageIntegrityProperties

Signature

0:1

Signature

Authorisation signature (data for transmission of message signatures (public key cryptography), used to prove Message Integrity).

CertificateId

0:1

CertificateId

form of identification that can be used as a Message Integrity Property (public key cryptography)

3.3. The ServiceRequestContextGroup group

+ + +

ServiceRequestContextGroup

Generic context for all request messages.

ServiceRequestContext

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.

Extension

0:1

xs:anyType

3.4. The ServiceResponseContextGroup group

+ + + +

ServiceResponseContextGroup

Generic context for all response messages.

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

3.5. The SubscriptionRequestContextGroup group

+ + + + + + + +

SubscriptionRequestContextGroup

Generic context for all subscription requests.

SubscriptionRequestContext

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.

Language

0:*

xs:language

Preferred language in which to return text values.

MessageIntegrityProperties

Signature

0:1

Signature

Authorisation signature (data for transmission of message signatures (public key cryptography), used to prove Message Integrity).

CertificateId

0:1

CertificateId

form of identification that can be used as a Message Integrity Property (public key cryptography)

SubscriptionRequestContext

Extension

0:1

xs:anyType

3.6. The complex type AbstractOJPServiceRequestStructure

+ + + + + + +

AbstractOJPServiceRequestStructure

siri:AbstractFunctionalServiceRequestStructure

Basic request structure common for all OJP service requests.

ServiceRequestContext

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.

Extension

0:1

xs:anyType

3.7. The complex type AbstractOJPSubscriptionRequestStructure

+ + + + + + + + + + + +

AbstractOJPSubscriptionRequestStructure

siri:AbstractSubscriptionRequestStructure

Basic structure common for all OJP subscription requests.

SubscriptionRequestContext

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.

Language

0:*

xs:language

Preferred language in which to return text values.

MessageIntegrityProperties

Signature

0:1

Signature

Authorisation signature (data for transmission of message signatures (public key cryptography), used to prove Message Integrity).

CertificateId

0:1

CertificateId

form of identification that can be used as a Message Integrity Property (public key cryptography)

SubscriptionRequestContext

Extension

0:1

xs:anyType

3.8. The DeliveryRequestGroup group

+ +

DeliveryRequestGroup

Wrapper for SIRI delivery request group.

→‍siri:DeliveryRequestGroup

3.9. The StatusRequestGroup group

+ +

StatusRequestGroup

Wrapper for SIRI status request group.

→‍siri:StatusRequestGroup

3.10. The toplevel element TerminateSubscriptionRequest

TerminateSubscriptionRequest

siri:TerminateSubscriptionRequestStructure

Request element for terminating subscriptions (from SIRI).

3.11. The ServiceResponseGroup group

+ +

ServiceResponseGroup

Wrapper for SIRI service response group.

→‍siri:ServiceResponseGroup

3.12. The complex type PlacesStructure

PlacesStructure

Structure providing a collection of places.

The element contains only one element:

Place

1:*

+Place

3.13. The complex type ResponseContextStructure

ResponseContextStructure

Structure providing response contexts related to journeys, containing collections of places and situations.

The element contains a sequence of the following elements:

Places

0:1

+Places

Container for place objects. Only place objects that are referenced in the response should be put into the container.

Situations

0:1

+Situations

Container for SIRI SX situation objects. Only situations that are referenced in the response should be put into the container.

3.14. The complex type OJPGenericProblemStructure

-

OJPGenericProblemStructure

Problem that may be returned in case of generic problems with the request.

The element contains a sequence of the following elements:

Type

1:1

OJPGenericProblemType

Type of the generic problem.

ProblemDetail

Title

0:1

+InternationalText

Title of the problem.

Details

0:1

+InternationalText

Explanation of the problem.

LogData

0:1

xs:string

Additional log data.

2.3. 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.

2.4. The complex type LinkProjectionStructure

LinkProjectionStructure

An oriented correspondence from one LINK of a source layer, onto an entity in a target layer: e.g. LINK SEQUENCE.

The element contains only one element:

Position

2:*

siri:LocationStructure

Ordered list of locations representing the geogemtry of the link.

2.5. 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.

2.6. 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))

2.7. The toplevel element OperatorRef

OperatorRef

siri:OperatorRefStructure

Reference to an Operator ([TMv6] company providing public transport services.)

2.8. 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

2.9. The complex type ProductCategoryRefStructure

ProductCategoryRefStructure

ProductCategoryCode

Reference to a product category. 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, e.g. to identify boats that run with steam in Switzerland ("BAV")

2.10. 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)

2.11. 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 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.

2.12. The complex type JourneyRefStructure

JourneyRefStructure

JourneyCode

Reference to a Journey

2.13. The toplevel element JourneyRef

JourneyRef

+JourneyRef

Reference to a Journey

2.14. 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

2.15. The TimedVehicleRefGroup group

- - -

TimedVehicleRefGroup

Reference to a vehicle for a specific point in time.

TimedVehicleRef

→‍siri:VehicleRef

1:1

→‍siri:VehicleRef

TimeOfOperation

1:1

xs:dateTime

Time stamp when the vehicle is operating. In most use cases equal to "now".

2.16. The complex type VehicleFilterStructure

VehicleFilterStructure

Filter for Vehicles

The element contains a sequence of the following elements:

Exclude

0:1

xs:boolean

Whether to include or exclude given VehicleRefs and TRAIN NUMBERS in the list from the search. Default is exclude.

VehicleRef

0:*

siri:VehicleRefStructure

Reference to VEHICLE

TrainNumber

0:*

xs:normalizedString

TRAIN NUMBERs

2.17. The SharingServiceUsageGroup group

- - -

SharingServiceUsageGroup

Usage parameters of a sharing service.

SharingServiceUsage

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.

2.18. The complex type SharingServiceStructure

- - -

SharingServiceStructure

Service that provides shared vehicles.

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.

SharingModel

0:1

SharingModel

Type of the sharing scheme.

SharingServiceUsage

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 web page providing more details on service.

2.19. The complex type OwnerRefStructure

OwnerRefStructure

OwnerCode

Reference to an ORGANISATION with ownership as the RESPONSIBILITY ROLE

2.20. The toplevel element OwnerRef

OwnerRef

+OwnerRef

Reference to an ORGANISATION with ownership as the RESPONSIBILITY ROLE

2.21. The complex type OperatingDayRefStructure

OperatingDayRefStructure

OperatingDayCode

Reference to an Operating Day

2.22. The toplevel element OperatingDayRef

OperatingDayRef

+OperatingDayRef

Reference to an Operating Day

2.23. 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.

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.

2.24. 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".

2.25. 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.

2.26. 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:

Text

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.

→‍siri:AllFacilitiesGroup

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.

-

3. OJP/OJP_FacilitySupport.xsd - Supporting definitions for facilities containing wrappers for SIRI

3.1. The AllFacilitiesGroup group

- -

AllFacilitiesGroup

Wrapper for SIRI facilities.

→‍siri:AllFacilitiesGroup

3.2. The StopFacilityGroup group

- -

StopFacilityGroup

Wrapper for SIRI stop facilities.

→‍siri:StopFacilityGroup

3.3. The ServiceFacilityGroup group

- -

ServiceFacilityGroup

Wrapper for SIRI service facilities.

→‍siri:ServiceFacilityGroup

+

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

4.1. The FareRequestGroup group

@@ -179,229 +383,14 @@

OJP - Open API for distributed Journey

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

StaticFareRequest

-1:1

+StaticFareRequest

A request for general/static Fare information.

c

StopFareRequest

-1:1

+StopFareRequest

A request for stop-related Fare information.

d

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.

Details

0:1

+InternationalText

Explanation of the problem.

LogData

0:1

xs:string

Additional log data.

-

6. OJP/OJP_JourneySupport.xsd - Supporting definitions for journeys on public transport vehicles

6.1. Simple type definitions

ReservationNeededEnumeration

none | service | stop

Possible types of reservation needed for services.

VehicleProgressEnumeration

Not yet operated | Operation finished | At stop | Between stops

Vehicle progress relative to timetable service pattern.

6.2. The complex type ServiceViaPointStructure

- - - - - -

ServiceViaPointStructure

[a specialisation of VIA in TMv6] STOP PLACE or SCHEDULED STOP POINT as a VIA for a particular SERVICE PATTERN. Specialisation of a VIA.

The element contains a sequence of the following elements:

StopPoint

→‍siri:StopPointRef

1:1

→‍siri:StopPointRef

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. F.e. "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.

6.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".

6.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.

6.5. The ScheduledJourneyGroup group

- - - - - - - - - - - - - - -

ScheduledJourneyGroup

Vehicle journey (not dated).

ScheduledJourney

→‍JourneyRef

1:1

→‍JourneyRef

Reference to a Journey

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, f.e. "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.

→‍OperatorRef

0:1

→‍OperatorRef

Reference to an Operator ([TMv6] company providing public transport services.) Reference to transport operatorIdentifier of the operator of the sharing service

RouteDescription

0:1

+InternationalText

Descriptive text for a route, f.e. "Airport via City Centre"

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public.

Attribute

0:*

+GeneralAttribute

Note or service attribute.

6.6. The ServiceGroup group

- - - - - - - - - - -

ServiceGroup

Properties of a service (line and direction): attributes of Continuous Journey Structure or Dated Journey Structure.

→‍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, f.e. "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.

→‍OperatorRef

0:1

→‍OperatorRef

Reference to an Operator ([TMv6] company providing public transport services.) Reference to transport operatorIdentifier of the operator of the sharing service

RouteDescription

0:1

+InternationalText

Descriptive text for a route, f.e. "Airport via City Centre"

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public.

Attribute

0:*

+GeneralAttribute

Note or service attribute.

6.7. The ServiceOriginGroup group

- - -

ServiceOriginGroup

First serviced stop of a vehicle journey.

ServiceOrigin

OriginStopPointRef

0:1

siri:StopPointRefStructure

First stop of the vehicle journey; origin stop point.

OriginText

1:1

+InternationalText

Label for first stop.

6.8. The ServiceDestinationGroup group

- - -

ServiceDestinationGroup

Last serviced stop of a vehicle journey.

ServiceDestination

DestinationStopPointRef

0:1

siri:StopPointRefStructure

Last stop of vehicle journey; destination stop point.

DestinationText

1:1

+InternationalText

Label for last stop.

6.9. The RouteDescriptionGroup group

- -

RouteDescriptionGroup

Descriptive text for a route, f.e. "Airport via City Centre"

RouteDescription

RouteDescriptionText

1:1

+InternationalText

6.10. The DatedJourneyGroup group

- - - - - - - - - - - - - - - - - - -

DatedJourneyGroup

Vehicle journey that runs at a specific date.

DatedJourney

→‍OperatingDayRef

1:1

→‍OperatingDayRef

Reference to an Operating Day

→‍siri:VehicleRef

0:1

→‍siri:VehicleRef

ScheduledJourney

→‍JourneyRef

1:1

→‍JourneyRef

Reference to a Journey

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, f.e. "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.

→‍OperatorRef

0:1

→‍OperatorRef

Reference to an Operator ([TMv6] company providing public transport services.) Reference to transport operatorIdentifier of the operator of the sharing service

RouteDescription

0:1

+InternationalText

Descriptive text for a route, f.e. "Airport via City Centre"

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public.

Attribute

0:*

+GeneralAttribute

Note or service attribute.

6.11. The PrivateServiceGroup group

- - - - -

PrivateServiceGroup

specific service operated by a Private Mode

PrivateService

→‍JourneyRef

0:1

→‍JourneyRef

Reference to a Journey

PrivateMode

1:1

PrivateModes

[a category of MODE in TMv6] MODEs offered by private individuals

OrganisationRef

0:1

siri:OperatorRefStructure

InfoUrl

0:1

+WebLink

Link to web page providing more details on service.

6.12. The complex type DatedJourneyStructure

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

DatedJourneyStructure

[equivalent to DATED VEHICLE JOURNEY in TMv6] passenger carrying VEHICLE JOURNEY for one specified DAY TYPE for which the pattern of working is in principle defined by a SERVICE JOURNEY PATTERN. DatedJourney details of a service include its operating days.

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

DatedJourney

a

→‍OperatingDayRef

1:1

→‍OperatingDayRef

Reference to an Operating Day

a

→‍siri:VehicleRef

0:1

→‍siri:VehicleRef

ScheduledJourney

a

→‍JourneyRef

1:1

→‍JourneyRef

Reference to a Journey

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, f.e. "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

→‍OperatorRef

0:1

→‍OperatorRef

Reference to an Operator ([TMv6] company providing public transport services.) Reference to transport operatorIdentifier of the operator of the sharing service

a

RouteDescription

0:1

+InternationalText

Descriptive text for a route, f.e. "Airport via City Centre"

a

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public.

a

Attribute

0:*

+GeneralAttribute

Note or service attribute.

PrivateService

b

→‍JourneyRef

0:1

→‍JourneyRef

Reference to a Journey

b

PrivateMode

1:1

PrivateModes

[a category of MODE in TMv6] MODEs offered by private individuals

b

OrganisationRef

0:1

siri:OperatorRefStructure

b

InfoUrl

0:1

+WebLink

Link to web page providing more details on service.

ServiceOrigin

OriginStopPointRef

0:1

siri:StopPointRefStructure

First stop of the vehicle journey; origin stop point.

OriginText

1:1

+InternationalText

Label for first stop.

ServiceDestination

DestinationStopPointRef

0:1

siri:StopPointRefStructure

Last stop of vehicle journey; destination stop point.

DestinationText

1:1

+InternationalText

Label for last stop.

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.

Occupancy

0:1

siri:OccupancyEnumeration

[equivalent to OCCUPANCY in SIRI] passenger load status of a VEHICLE. If omitted, not known.

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.

→‍SituationFullRef

0:*

→‍SituationFullRef

Reference to situation message. Message details might be found in response context or through other communication channels.

Extension

0:1

xs:anyType

6.13. The complex type TripPlaceStructure

TripPlaceStructure

A trip place represents the current logical position of a journey service. It can be used similarly to a place e.g. for starting a new trip requests from within this service. A trip place 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

6.14. The TimeWindowGroup group

- - -

TimeWindowGroup

The window of opportunity that the traveller has to perform this leg of the journey.

TimeWindow

TimeWindowStart

0:1

xs:dateTime

Time at which window begins.

TimeWindowEnd

0:1

xs:dateTime

Time at which window ends.

6.15. The ServiceTimeGroup group

- - - - - - - -

ServiceTimeGroup

Contains at least scheduled time, but can contain real time and estimated times

ServiceTime

TimetabledTime

1:1

xs:dateTime

time at point as it is published

RecordedAtTime

0:1

xs:dateTime

time as it was recorded

EstimatedTime

0:1

xs:dateTime

estimated time (for prognosis)

EstimatedTimeBand

EstimatedTimeLow

0:1

xs:dateTime

Estimated lower limit for time.

EstimatedTimeHigh

0:1

xs:dateTime

Estimated upper limit for time.

6.16. The EstimatedTimeBandGroup group

- - -

EstimatedTimeBandGroup

Range for estimated time.

EstimatedTimeBand

EstimatedTimeLow

0:1

xs:dateTime

Estimated lower limit for time.

EstimatedTimeHigh

0:1

xs:dateTime

Estimated upper limit for time.

6.17. The complex type ServiceArrivalStructure

- - - - - - - -

ServiceArrivalStructure

Arrival times of a service at a stop (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME).

The element contains only one element:

ServiceTime

TimetabledTime

1:1

xs:dateTime

time at point as it is published

RecordedAtTime

0:1

xs:dateTime

time as it was recorded

EstimatedTime

0:1

xs:dateTime

estimated time (for prognosis)

EstimatedTimeBand

EstimatedTimeLow

0:1

xs:dateTime

Estimated lower limit for time.

EstimatedTimeHigh

0:1

xs:dateTime

Estimated upper limit for time.

6.18. The complex type ServiceDepartureStructure

- - - - - - - -

ServiceDepartureStructure

Departure times of a service at a stop (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME).

The element contains only one element:

ServiceTime

TimetabledTime

1:1

xs:dateTime

time at point as it is published

RecordedAtTime

0:1

xs:dateTime

time as it was recorded

EstimatedTime

0:1

xs:dateTime

estimated time (for prognosis)

EstimatedTimeBand

EstimatedTimeLow

0:1

xs:dateTime

Estimated lower limit for time.

EstimatedTimeHigh

0:1

xs:dateTime

Estimated upper limit for time.

6.19. The complex type CallAtStopStructure

- - - - - - - - - - - - -

CallAtStopStructure

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

The element contains a sequence of the following elements:

StopPoint

→‍siri:StopPointRef

1:1

→‍siri:StopPointRef

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. F.e. "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).

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.

→‍SituationFullRef

0:*

→‍SituationFullRef

Reference to situation message. Message details might be found in response context or through other communication channels.

6.20. The StopCallStatusGroup group

- - - - - - -

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.

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.

6.21. The ServiceStatusGroup group

- - - - -

ServiceStatusGroup

parameters which describe the current 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.

Occupancy

0:1

siri:OccupancyEnumeration

[equivalent to OCCUPANCY in SIRI] passenger load status of a VEHICLE. If omitted, not known.

6.22. The complex type ContinuousServiceStructure

- - - - - - - - - - - - - - - - - - - - - - - - -

ContinuousServiceStructure

[a special form of SERVICE JOURNEY in TMv6] a vehicle movement on a continuous, non-timetabled service.

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

a

ContinuousMode

-1:1

ContinuousModes

Continuous transport options.

b

IndividualMode

-1:1

IndividualModes

Individual transport options.

Then, the element contains one of the following elements:

DatedJourney

a

→‍OperatingDayRef

1:1

→‍OperatingDayRef

Reference to an Operating Day

a

→‍siri:VehicleRef

0:1

→‍siri:VehicleRef

ScheduledJourney

a

→‍JourneyRef

1:1

→‍JourneyRef

Reference to a Journey

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, f.e. "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

→‍OperatorRef

0:1

→‍OperatorRef

Reference to an Operator ([TMv6] company providing public transport services.) Reference to transport operatorIdentifier of the operator of the sharing service

a

RouteDescription

0:1

+InternationalText

Descriptive text for a route, f.e. "Airport via City Centre"

a

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public.

a

Attribute

0:*

+GeneralAttribute

Note or service attribute.

b

SharingService

-0:1

+SharingService

ServiceOrigin

OriginStopPointRef

0:1

siri:StopPointRefStructure

First stop of the vehicle journey; origin stop point.

OriginText

1:1

+InternationalText

Label for first stop.

ServiceDestination

DestinationStopPointRef

0:1

siri:StopPointRefStructure

Last stop of vehicle journey; destination stop point.

DestinationText

1:1

+InternationalText

Label for last stop.

BookingArrangements

0:1

+BookingArrangementsContainer

Container with information on booking possibilities for this service.

→‍SituationFullRef

0:*

→‍SituationFullRef

Reference to situation message. Message details might be found in response context or through other communication channels.

Extension

0:1

xs:anyType

6.23. 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.

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.

6.24. 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

TripPlace

-1:1

+TripPlace

Place 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 place is required.

b

TimeAllowance

-0:1

xs:duration

Extra time needed before reaching/after leaving this place.

IndividualTransportOptions

0:*

+IndividualTransportOptions

Options how to access/leave the place by individual transport.

6.25. 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

1:1

xs:nonNegativeInteger

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

NumberOfResultsAfter

1:1

xs:nonNegativeInteger

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

6.26. The BaseTripPolicyGroup group

- - - - - - -

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

1:1

xs:nonNegativeInteger

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

a

NumberOfResultsAfter

1: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.

IgnoreRealtimeData

0:1

xs:boolean

The trip calculation should not use any realtime or incident data.

ImmediateTripStart

0:1

xs:boolean

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

6.27. The BaseTripMobilityFilterGroup group

- - - - - - -

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 climb one step.

NoStairs

0:1

xs:boolean

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

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 an ramp.

NoSight

0:1

xs:boolean

The user is not able to see.

6.28. The BaseTripContentFilterGroup group

- - - - - - -

BaseTripContentFilterGroup

Parameters to control the level of detail of both public and individual transport journey results.

BaseTripContentFilter

IncludeTrackSections

0:1

xs:boolean

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

IncludeLegProjection

0:1

xs:boolean

Whether the result should include the geographic projection (coordinates) of each journey leg.

IncludeTurnDescription

0:1

xs:boolean

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

IncludeAccessibility

0:1

xs:boolean

Whether the result should include accessibility information.

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

6.29. 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.

6.30. 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

LINK PROJECTION on the infrastructure network of the trip leg section together with time information.

6.31. The complex type TrackSectionStructure

TrackSectionStructure

LINK PROJECTION on the infrastructure network of the TRIP LEG together with time information

The element contains a sequence of the following elements:

TrackStart

0:1

+PlaceRef

Start place of this track.

TrackEnd

0:1

+PlaceRef

End place of this track.

LinkProjection

0:1

+LinkProjection

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.

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

-

7. OJP/OJP_ModesSupport.xsd - Supporting definitions for the classification of modes of transport

7.1. Simple type definitions

ContinuousModesEnumeration

walk | demandResponsive | replacementService

Types of cmodes that run at any time without a timetable.

IndividualModesEnumeration

walk | cycle | taxi | self-drive-car | others-drive-car | motorcycle | truck | scooter | ride-pool-car | car-sharing | cycle-sharing | scooter-sharing

modes which an individual powers themselves (such as walk, cycle)

PrivateModesEnumeration

carPooling

[a category of MODE in TMv6] MODEs offered by private individuals

TransferModesEnumeration

walk | parkAndRide | bikeAndRide | carHire | bikeHire | protectedConnection | guaranteedConnection | remainInVehicle | changeWithinVehicle | checkIn | checkOut

MODEs dedicated to peform TRANSFERs

7.2. The complex type IndividualTransportOptionsStructure

IndividualTransportOptionsStructure

Individual modes and their usage limits as stated by the passenger

The element contains a sequence of the following elements:

Mode

1:1

IndividualModes

Mode of individual transport. When mode self-drive-car is used the connection to another mode will need a parking space for the car. Thus, this mode is a generalisation of all park and ride use cases. The mode others-drive-car, however, only needs a place to let a person be set down from a car.

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.

7.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 mode

→‍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.

7.4. The ModeGroup group

- - -

ModeGroup

Elements for a Transport Mode

Mode

PtMode

1:1

siri:VehicleModesOfTransportEnumeration

Categorisation of mode

→‍siri:PtModeChoiceGroup

7.5. The complex type PtModeFilterStructure

PtModeFilterStructure

List of public transport modes ([from SIRI] mode of public transport service, corresponds to VEHICLE MODE) to exclude or include.

The element contains a sequence of the following elements:

Exclude

0:1

xs:boolean

Whether VEHICLE 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.

→‍siri:PtModeChoiceGroup

7.6. The complex type PrivateModeFilterStructure

PrivateModeFilterStructure

List of private mobility offers to include or exclude.

The element contains a sequence of the following elements:

Exclude

0:1

xs:boolean

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

PrivateMode

0:*

PrivateModes

List of private mobility offers to include/exclude.

-

8. OJP/OJP_Places.xsd - Request and response definitions for place information

8.1. Simple type definitions

PlaceTypeEnumeration

stop | address | poi | coord | location | topographicPlace

PlaceUsageEnumeration

origin | via | destination

8.2. The PlaceInformationRequestGroup group

+

6. OJP/OJP_Places.xsd - Request and response definitions for place information

6.1. Simple type definitions

PlaceInformationRequestGroup

PlaceTypeEnumeration

stop | address | poi | coord | location | topographicPlace

PlaceUsageEnumeration

origin | via | destination

6.2. The PlaceInformationRequestGroup group

-

PlaceInformationRequestGroup

The element contains one of the following elements:

PlaceInformationRequest

a

InitialInput

-1:1

+InitialPlaceInput

Initial input for the place information request. This input defines what is originally looked for.

b

PlaceRef

-1:1

+PlaceRef

Place for further refinement. If a place in a previous response was marked as not "complete" it can be refined by putting it here.

Restrictions

0:1

+PlaceParam

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

8.3. The PlaceInformationResponseGroup group

+

PlaceInformationResponseGroup

6.3. The PlaceInformationResponseGroup group

-

PlaceInformationResponseGroup

PlaceInformationResponse

PlaceInformationResponseContext

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

8.4. The complex type InitialPlaceInputStructure

InitialPlaceInputStructure

The element contains a sequence of the following elements:

Name

0:1

xs:string

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

GeoPosition

0:1

siri:LocationStructure

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

GeoRestriction

0:1

+GeoRestrictions

Restricts the resulting place objects to the given geographical area.

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.5. The complex type PlaceParamStructure

+

PlaceParamStructure

The element contains a sequence of the following elements:

6.4. The complex type InitialPlaceInputStructure

InitialPlaceInputStructure

The element contains a sequence of the following elements:

Name

0:1

xs:string

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

GeoPosition

0:1

siri:LocationStructure

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

GeoRestriction

0:1

+GeoRestrictions

Restricts the resulting place objects to the given geographical area.

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/

6.5. The complex type PlaceParamStructure

@@ -413,28 +402,28 @@

OJP - Open API for distributed Journey

-

PlaceParamStructure

The element contains a sequence of the following elements:

PlaceDataFilter

Type

0:*

PlaceType

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

Usage

0:1

PlaceUsage

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

PtModes

0:1

+PtModeFilter

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

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.

IncludePtModes

0:1

xs:boolean

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

8.6. The complex type GeoRestrictionsStructure

GeoRestrictionsStructure

The element contains one of the following elements:

a

Area

-1:1

+GeoArea

Area is defined by a polyline

b

Circle

-1:1

+GeoCircle

c

Rectangle

-1:1

+GeoRectangle

8.7. The complex type GeoCircleStructure

GeoCircleStructure

The element contains a sequence of the following elements:

Center

1:1

siri:LocationStructure

Radius

1:1

siri:DistanceType

Radius in metres.

8.8. The complex type GeoRectangleStructure

GeoRectangleStructure

The element contains a sequence of the following elements:

UpperLeft

1:1

siri:LocationStructure

LowerRight

1:1

siri:LocationStructure

8.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

8.10. The complex type PlaceResultStructure

+

PlaceResultStructure

The element contains a sequence of the following elements:

Problem

0:*

+LocationProblem

Problems related to this LOCATION result.

Place

1:1

+Place

Complete

1:1

xs:boolean

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

Probability

0:1

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

6.6. The complex type GeoRestrictionsStructure

GeoRestrictionsStructure

The element contains one of the following elements:

a

Area

-1:1

+GeoArea

Area is defined by a polyline

b

Circle

-1:1

+GeoCircle

c

Rectangle

-1:1

+GeoRectangle

6.7. The complex type GeoCircleStructure

GeoCircleStructure

The element contains a sequence of the following elements:

Center

1:1

siri:LocationStructure

Radius

1:1

siri:DistanceType

Radius in metres.

6.8. The complex type GeoRectangleStructure

GeoRectangleStructure

The element contains a sequence of the following elements:

UpperLeft

1:1

siri:LocationStructure

LowerRight

1:1

siri:LocationStructure

6.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

6.10. The complex type PlaceResultStructure

-

PlaceResultStructure

The element contains a sequence of the following elements:

Problem

0:*

+LocationProblem

Problems related to this LOCATION result.

Place

1:1

+Place

Complete

1:1

xs:boolean

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

Probability

0:1

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

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.

8.11. The PlacePolicyGroup group

+

PlacePolicyGroup

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.

6.11. The PlacePolicyGroup group

-

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.

IncludePtModes

0:1

xs:boolean

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

8.12. The PlaceDataFilterGroup group

+

PlaceDataFilterGroup

6.12. The PlaceDataFilterGroup group

-

PlaceDataFilterGroup

PlaceDataFilter

Type

0:*

PlaceType

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

Usage

0:1

PlaceUsage

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

PtModes

0:1

+PtModeFilter

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

OperatorFilter

0:1

+OperatorFilter

Filter for places that are operated by certain organisations.

TopographicPlaceRef

0:*

+TopographicPlaceRef

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

PointOfInterestFilter

0:1

+PointOfInterestFilter

Filter to narrow down POI searches.

8.13. The ExchangePointsRequestGroup group

+

ExchangePointsRequestGroup

6.13. The ExchangePointsRequestGroup group

-

ExchangePointsRequestGroup

ExchangePointsRequest

PlaceRef

0:1

+PlaceRef

Place for which exchange points to other "neighbour" systems are to be searched. This place is usually the origin/destination of a passenger journey. May be omitted if all exchange points shall be returned.

Params

0:1

+ExchangePointsParam

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

8.14. The complex type ExchangePointsParamStructure

+

ExchangePointsParamStructure

The element contains a sequence of the following elements:

6.14. The complex type ExchangePointsParamStructure

@@ -446,7 +435,7 @@

OJP - Open API for distributed Journey

-

ExchangePointsParamStructure

The element contains a sequence of the following elements:

ExchangePointsDataFilter

Type

0:*

PlaceType

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

Usage

0:1

PlaceUsage

Defines, whether the place object of this request acts as origin, via or destination point of the passenger journey.

PtModes

0:1

+PtModeFilter

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

ExchangePointsPolicy

Language

0:*

xs:language

Preferred language in which to return text values.

NumberOfResults

0:1

xs:positiveInteger

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.

8.15. The ExchangePointsDataFilterGroup group

+

ExchangePointsDataFilterGroup

6.15. The ExchangePointsDataFilterGroup group

@@ -454,22 +443,22 @@

OJP - Open API for distributed Journey

-

ExchangePointsDataFilterGroup

ExchangePointsDataFilter

Type

0:*

PlaceType

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

Usage

0:1

PlaceUsage

Defines, whether the place object of this request acts as origin, via or destination point of the passenger journey.

PtModes

0:1

+PtModeFilter

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

TopographicPlaceRef

0:*

+TopographicPlaceRef

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

DestinationSystem

0:1

siri:ParticipantRefStructure

Reference to system in which the destination (or origin) of the passenger is located.

AdjacentSystem

0:*

siri:ParticipantRefStructure

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

8.16. The ExchangePointsPolicyGroup group

+

ExchangePointsPolicyGroup

6.16. The ExchangePointsPolicyGroup group

-

ExchangePointsPolicyGroup

ExchangePointsPolicy

Language

0:*

xs:language

Preferred language in which to return text values.

NumberOfResults

0:1

xs:positiveInteger

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.

8.17. The ExchangePointsResponseGroup group

+

ExchangePointsResponseGroup

6.17. The ExchangePointsResponseGroup group

-

ExchangePointsResponseGroup

ExchangePointsResponse

ExchangePointResponseContext

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.

Place

0:*

+ExchangePointsResult

8.18. The complex type ExchangePointsResultStructure

ExchangePointsResultStructure

The element contains a sequence of the following elements:

Problem

0:*

+ExchangePointProblem

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 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.

-

9. OJP/OJP_PlaceSupport.xsd - Supporting definitions for place information

9.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_OTHER

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

PointOfInterestCodeType

xs:normalizedString

Identifier of a Point of Interest

StopPlaceCodeType

xs:normalizedString

Identifier of a Stop Place

TopographicPlaceCodeType

xs:normalizedString

Identifier of a TopographicPlace

9.2. The StopPointGroup group

+

StopPointGroup

A stop point with id and name

6.18. The complex type ExchangePointsResultStructure

ExchangePointsResultStructure

The element contains a sequence of the following elements:

Problem

0:*

+ExchangePointProblem

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 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.

+

7. OJP/OJP_PlaceSupport.xsd - Supporting definitions for place information

7.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_OTHER

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

PointOfInterestCodeType

xs:normalizedString

Identifier of a Point of Interest

StopPlaceCodeType

xs:normalizedString

Identifier of a Stop Place

TopographicPlaceCodeType

xs:normalizedString

Identifier of a TopographicPlace

7.2. The StopPointGroup group

-

StopPointGroup

A stop point with id and name

StopPoint

→‍siri:StopPointRef

1:1

→‍siri:StopPointRef

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. F.e. "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.

9.3. The complex type StopPointStructure

+

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:

7.3. The complex type StopPointStructure

@@ -479,11 +468,11 @@

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

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. F.e. "opposite main entrance".

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.

9.4. The complex type StopPlaceRefStructure

StopPlaceRefStructure

StopPlaceCode

Reference to a Stop Place

9.5. The toplevel element StopPlaceRef

StopPlaceRef

+StopPlaceRef

Reference to a Stop Place

9.6. The StopPlaceGroup group

+

StopPlaceGroup

A stop place with id and name

7.4. The complex type StopPlaceRefStructure

StopPlaceRefStructure

StopPlaceCode

Reference to a Stop Place

7.5. The toplevel element StopPlaceRef

StopPlaceRef

+StopPlaceRef

Reference to a Stop Place

7.6. The StopPlaceGroup group

-

StopPlaceGroup

A stop place with id and name

StopPlace

→‍StopPlaceRef

1:1

→‍StopPlaceRef

Reference to a Stop Place

StopPlaceName

1:1

+InternationalText

Name of this stop place for use in passenger information.

NameSuffix

0:1

+InternationalText

Additional description of the stop place that may be appended to the name if enough space is available. F.e. "Exhibition Center".

9.7. The complex type StopPlaceStructure

+

StopPlaceStructure

[an extended view of STOP PLACE in TMv6] a PLACE extended by ACCESSIBILITY LIMITATION properties and some attributes of the associated equipment, comprising one or more locations where vehicles may stop and where passengers may board or leave vehicles or prepare their trip, and which will usually have one or more wellknown names

The element contains a sequence of the following elements:

7.7. The complex type StopPlaceStructure

@@ -491,11 +480,11 @@

OJP - Open API for distributed Journey

-

StopPlaceStructure

[an extended view of STOP PLACE in TMv6] a PLACE extended by ACCESSIBILITY LIMITATION properties and some attributes of the associated equipment, comprising one or more locations where vehicles may stop and where passengers may board or leave vehicles or prepare their trip, and which will usually have one or more wellknown names

The element contains a sequence of the following elements:

StopPlace

→‍StopPlaceRef

1:1

→‍StopPlaceRef

Reference to a Stop Place

StopPlaceName

1:1

+InternationalText

Name of this stop place for use in passenger information.

NameSuffix

0:1

+InternationalText

Additional description of the stop place that may be appended to the name if enough space is available. F.e. "Exhibition Center".

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.

9.8. The StopAttributesGroup group

+

StopAttributesGroup

[properties of a SCHEDULED STOP POINT or STOP PLACE in TMv6] selection of attributes of ACCESSIBIITY LIMITATION related to a SCHEDULED STOP POINT extended by attributes referring to some equipment.

7.8. The StopAttributesGroup group

-

StopAttributesGroup

[properties of a SCHEDULED STOP POINT or STOP PLACE in TMv6] selection of attributes of ACCESSIBIITY LIMITATION related to a SCHEDULED STOP POINT extended by attributes referring to some equipment.

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.

9.9. The complex type TopographicPlaceRefStructure

TopographicPlaceRefStructure

Reference to a TopographicPlace

9.10. The toplevel element TopographicPlaceRef

TopographicPlaceRef

+TopographicPlaceRef

Reference to a TopographicPlace

9.11. 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.

ReferredSystemId

0:1

xs:normalizedString

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.

9.12. The complex type PointOfInterestRefStructure

PointOfInterestRefStructure

PointOfInterestCode

Reference to a Point of Interest

9.13. The toplevel element PointOfInterestRef

PointOfInterestRef

+PointOfInterestRef

Reference to a Point of Interest

9.14. 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. F.e. "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 place objects within the given localities are allowed.If at least one is set, only place objects within the given localities are allowed.Reference to a TopographicPlace

9.15. 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

Open Street Map 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]")

9.16. The complex type OsmTagStructure

OsmTagStructure

Structure of an Open Street Map tag.

The element contains a sequence of the following elements:

Tag

1:1

xs:NMTOKEN

Name of Open Street Map tag (amenity, leisure, tourism, bike, ...)

Value

1:1

xs:NMTOKEN

Value for Open Street Map tag (charging_station, hostel, yes, ...)

9.17. 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).

9.18. The complex type AddressRefStructure

AddressRefStructure

AddressCode

Reference to an Address

9.19. The toplevel element AddressRef

AddressRef

+AddressRef

Reference to an Address

9.20. The AddressDetailGroup group

+

AddressDetailGroup

An address with its name entities

7.9. The complex type TopographicPlaceRefStructure

TopographicPlaceRefStructure

Reference to a TopographicPlace

7.10. The toplevel element TopographicPlaceRef

TopographicPlaceRef

+TopographicPlaceRef

Reference to a TopographicPlace

7.11. 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.

ReferredSystemId

0:1

xs:normalizedString

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.

7.12. The complex type PointOfInterestRefStructure

PointOfInterestRefStructure

PointOfInterestCode

Reference to a Point of Interest

7.13. The toplevel element PointOfInterestRef

PointOfInterestRef

+PointOfInterestRef

Reference to a Point of Interest

7.14. 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. F.e. "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 place objects within the given localities are allowed.If at least one is set, only place objects within the given localities are allowed.Reference to a TopographicPlace

7.15. 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

Open Street Map 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]")

7.16. The complex type OsmTagStructure

OsmTagStructure

Structure of an Open Street Map tag.

The element contains a sequence of the following elements:

Tag

1:1

xs:NMTOKEN

Name of Open Street Map tag (amenity, leisure, tourism, bike, ...)

Value

1:1

xs:NMTOKEN

Value for Open Street Map tag (charging_station, hostel, yes, ...)

7.17. 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).

7.18. The complex type AddressRefStructure

AddressRefStructure

AddressCode

Reference to an Address

7.19. The toplevel element AddressRef

AddressRef

+AddressRef

Reference to an Address

7.20. The AddressDetailGroup group

@@ -503,7 +492,7 @@

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.

9.21. The complex type AddressStructure

+

AddressStructure

descriptive data associated with a PLACE that can be used to describe the unique geographical context of a PLACE for the purposes of identifying it. May be refined as either a ROAD ADDRESS, a POSTAL ADDRESS or both

The element contains a sequence of the following elements:

PublicCode

1:1

AddressCode

ID of this address.

PrivateCode

0:*

+PrivateCode

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

Name

1:1

+InternationalText

Name or description of address for use in passenger information.

NameSuffix

0:1

+InternationalText

Additional description of the address that may be appended to the name if enough space is available. F.e. "Crossing with Peterstraße".

7.21. The complex type AddressStructure

@@ -511,301 +500,87 @@

OJP - Open API for distributed Journey

-

AddressStructure

descriptive data associated with a PLACE that can be used to describe the unique geographical context of a PLACE for the purposes of identifying it. May be refined as either a ROAD ADDRESS, a POSTAL ADDRESS or both

The element contains a sequence of the following elements:

PublicCode

1:1

AddressCode

ID of this address.

PrivateCode

0:*

+PrivateCode

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

Name

1:1

+InternationalText

Name or description of address for use in passenger information.

NameSuffix

0:1

+InternationalText

Additional description of the address that may be appended to the name if enough space is available. F.e. "Crossing with Peterstraße".

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.

9.22. 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

Attribute

0:*

+GeneralAttribute

Attribute associated with this place.

Extension

0:1

xs:anyType

9.23. 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 a sequence of the following elements:

Then, the element contains one of the following elements:

a

→‍siri:StopPointRef

-1:1

→‍siri:StopPointRef

b

→‍StopPlaceRef

-1:1

→‍StopPlaceRef

Reference to a Stop Place

c

→‍TopographicPlaceRef

-1:1

→‍TopographicPlaceRef

If at least one is set, only place objects within the given localities are allowed.If at least one is set, only 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/

9.24. The complex type LocationProblemStructure

+

LocationProblemStructure

Problem that may be returned in responses to LOCATION requests.

The element contains a sequence of the following elements:

Type

1:1

LocationProblemType

Type of the LOCATION problem.

7.22. 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

Attribute

0:*

+GeneralAttribute

Attribute associated with this place.

Extension

0:1

xs:anyType

7.23. 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 a sequence of the following elements:

Then, the element contains one of the following elements:

a

→‍siri:StopPointRef

-1:1

→‍siri:StopPointRef

b

→‍StopPlaceRef

-1:1

→‍StopPlaceRef

Reference to a Stop Place

c

→‍TopographicPlaceRef

-1:1

→‍TopographicPlaceRef

If at least one is set, only place objects within the given localities are allowed.If at least one is set, only 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/

7.24. The complex type LocationProblemStructure

-

LocationProblemStructure

Problem that may be returned in responses to LOCATION requests.

The element contains a sequence of the following elements:

Type

1:1

LocationProblemType

Type of the LOCATION problem.

ProblemDetail

Title

0:1

+InternationalText

Title of the problem.

Details

0:1

+InternationalText

Explanation of the problem.

LogData

0:1

xs:string

Additional log data.

9.25. The complex type ExchangePointProblemStructure

+

ExchangePointProblemStructure

Problem that may be returned in responses to EXCHANGE POINTS requests.

The element contains a sequence of the following elements:

Type

1:1

ExchangePointsProblemType

Type of the EXCHANGE POINTS problem.

7.25. The complex type ExchangePointProblemStructure

ExchangePointProblemStructure

Problem that may be returned in responses to EXCHANGE POINTS requests.

The element contains a sequence of the following elements:

Type

1:1

ExchangePointsProblemType

Type of the EXCHANGE POINTS problem.

ProblemDetail

Title

0:1

+InternationalText

Title of the problem.

Details

0:1

+InternationalText

Explanation of the problem.

LogData

0:1

xs:string

Additional log data.

-

10. OJP/OJP_Requests.xsd - OJP service requests and responses

10.1. The toplevel element OJPFareRequest

OJPFareRequest

+OJPFareRequest (↔ siri:AbstractFunctionalServiceRequest)

10.2. The complex type OJPFareRequestStructure

- - - - - - -

OJPFareRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

Then, 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

StaticFareRequest

-1:1

+StaticFareRequest

A request for general/static Fare information.

c

StopFareRequest

-1:1

+StopFareRequest

A request for stop-related Fare information.

d

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.

→‍siri:Extensions

0:1

→‍siri:Extensions

10.3. The toplevel element OJPFareDelivery

OJPFareDelivery

+OJPFareDelivery (↔ siri:AbstractFunctionalServiceDelivery)

10.4. The complex type OJPFareDeliveryStructure

- - - - - - - - - - -

OJPFareDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

FareResponse

FareResponseContext

0:1

+ResponseContext

Context to hold trip response objects that occur frequently.

FareResult

0:*

+FareResult

Fare result choice element.

→‍siri:Extensions

0:1

→‍siri:Extensions

10.5. The toplevel element OJPPlaceInformationRequest

OJPPlaceInformationRequest

+OJPPlaceInformationRequest (↔ siri:AbstractFunctionalServiceRequest)

10.6. The complex type OJPPlaceInformationRequestStructure

- - - - - - -

OJPPlaceInformationRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

PlaceInformationRequest

a

InitialInput

-1:1

+InitialPlaceInput

Initial input for the place information request. This input defines what is originally looked for.

b

PlaceRef

-1:1

+PlaceRef

Place for further refinement. If a place in a previous response was marked as not "complete" it can be refined by putting it here.

Restrictions

0:1

+PlaceParam

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

→‍siri:Extensions

0:1

→‍siri:Extensions

10.7. The toplevel element OJPPlaceInformationDelivery

OJPPlaceInformationDelivery

+OJPPlaceInformationDelivery (↔ siri:AbstractFunctionalServiceDelivery)

10.8. The complex type OJPPlaceInformationDeliveryStructure

- - - - - - - - - - - -

OJPPlaceInformationDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

→‍OJPPlaceInformationRequest

0:1

→‍OJPPlaceInformationRequest

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

PlaceInformationResponse

PlaceInformationResponseContext

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

→‍siri:Extensions

0:1

→‍siri:Extensions

10.9. The toplevel element OJPExchangePointsRequest

OJPExchangePointsRequest

+OJPExchangePointsRequest (↔ siri:AbstractFunctionalServiceRequest)

10.10. The complex type OJPExchangePointsRequestStructure

- - - - - - -

OJPExchangePointsRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

ExchangePointsRequest

PlaceRef

0:1

+PlaceRef

Place for which exchange points to other "neighbour" systems are to be searched. This place is usually the origin/destination of a passenger journey. May be omitted if all exchange points shall be returned.

Params

0:1

+ExchangePointsParam

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

→‍siri:Extensions

0:1

→‍siri:Extensions

10.11. The toplevel element OJPExchangePointsDelivery

OJPExchangePointsDelivery

+OJPExchangePointsDelivery (↔ siri:AbstractFunctionalServiceDelivery)

10.12. The complex type OJPExchangePointsDeliveryStructure

- - - - - - - - - - - -

OJPExchangePointsDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

→‍OJPExchangePointsRequest

0:1

→‍OJPExchangePointsRequest

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

ExchangePointsResponse

ExchangePointResponseContext

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.

Place

0:*

+ExchangePointsResult

→‍siri:Extensions

0:1

→‍siri:Extensions

10.13. The toplevel element OJPStopEventRequest

OJPStopEventRequest

+OJPStopEventRequest (↔ siri:AbstractFunctionalServiceRequest)

10.14. The complex type OJPStopEventRequestStructure

- - +

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

8.1. Simple type definitions

OJPStopEventRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

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 + 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". +

StopEventProblemTypeEnumeration

STOPEVENT_NOEVENTFOUND | STOPEVENT_LOCATIONUNSERVED | STOPEVENT_LOCATIONUNKNOWN | STOPEVENT_DATEOUTOFRANGE | STOPEVENT_LASTSERVICEOFTHISLINE | STOPEVENT_NOREALTIME | STOPEVENT_OTHER

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

StopEventTypeEnumeration

departure | arrival | both

Departure or arrival events or both

8.2. The StopEventRequestGroup group

- - -

StopEventRequestGroup

Request structure for departure and arrival events at stops

StopEventRequest

Place

1:1

+PlaceContext

Place for which to obtain stop event information.

Params

0:1

+StopEventParam

Request parameter

→‍siri:Extensions

0:1

→‍siri:Extensions

10.15. The toplevel element OJPStopEventDelivery

OJPStopEventDelivery

+OJPStopEventDelivery (↔ siri:AbstractFunctionalServiceDelivery)

10.16. The complex type OJPStopEventDeliveryStructure

- - - - - - +

OJPStopEventDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

→‍OJPStopEventRequest

0:1

→‍OJPStopEventRequest

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

8.3. The complex type StopEventParamStructure

+ + + + + + + + + + + + + + + +

StopEventParamStructure

Request specific parameters (parameters which define what is to be included in a Stop Event result)

The element contains a sequence of the following elements:

StopEventDataFilter

PtModeFilter

0:1

+PtModeFilter

Modes (VEHICLE MODE) to be excluded or included in stop events.

LineFilter

0:1

+LineDirectionFilter

Lines/Directions to include/exclude.

OperatorFilter

0:1

+OperatorFilter

Transport operators to include/exclude.

StopEventPolicy

NumberOfResults

0:1

xs:positiveInteger

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

TimeWindow

0:1

xs:duration

Time window events should lie within. Starting from time given in PlaceContext.

StopEventType

0:1

StopEventType

Only departures or arrivals or both.

StopEventContentFilter

IncludePreviousCalls

0:1

xs:boolean

Whether the previous calls of each vehicle journey should be included in the response.

IncludeOnwardCalls

0:1

xs:boolean

Whether the onward calls of each vehicle journey should be included in the response.

IncludeOperatingDays

0:1

xs:boolean

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

IncludeRealtimeData

0:1

xs:boolean

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

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

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 + 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". +

8.4. The StopEventDataFilterGroup group

+ + + +

StopEventDataFilterGroup

Request data filters

StopEventDataFilter

PtModeFilter

0:1

+PtModeFilter

Modes (VEHICLE MODE) to be excluded or included in stop events.

LineFilter

0:1

+LineDirectionFilter

Lines/Directions to include/exclude.

OperatorFilter

0:1

+OperatorFilter

Transport operators to include/exclude.

8.5. The StopEventPolicyGroup group

+ + + +

StopEventPolicyGroup

Request policies

StopEventPolicy

NumberOfResults

0:1

xs:positiveInteger

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

TimeWindow

0:1

xs:duration

Time window events should lie within. Starting from time given in PlaceContext.

StopEventType

0:1

StopEventType

Only departures or arrivals or both.

8.6. The StopEventContentFilterGroup group

+ + + + + + + +

StopEventContentFilterGroup

Content filters which data is expected in the response

StopEventContentFilter

IncludePreviousCalls

0:1

xs:boolean

Whether the previous calls of each vehicle journey should be included in the response.

IncludeOnwardCalls

0:1

xs:boolean

Whether the onward calls of each vehicle journey should be included in the response.

IncludeOperatingDays

0:1

xs:boolean

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

IncludeRealtimeData

0:1

xs:boolean

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

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

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 + 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". +

8.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.

→‍siri:Extensions

0:1

→‍siri:Extensions

10.17. The toplevel element OJPTripInfoRequest

OJPTripInfoRequest

+OJPTripInfoRequest (↔ siri:AbstractFunctionalServiceRequest)

10.18. The complex type OJPTripInfoRequestStructure

- - - - - - - - - - - - -

OJPTripInfoRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

DatedJourneyRef

a

→‍JourneyRef

1:1

→‍JourneyRef

Reference to a Journey

a

→‍OperatingDayRef

1:1

→‍OperatingDayRef

Reference to an Operating Day

TimedVehicleRef

b

→‍siri:VehicleRef

1:1

→‍siri:VehicleRef

b

TimeOfOperation

1:1

xs:dateTime

Time stamp when the vehicle is operating. In most use cases equal to "now".

TripInfoRequest

Params

0:1

+TripInfoParam

Request parameter.

→‍siri:Extensions

0:1

→‍siri:Extensions

10.19. The toplevel element OJPTripInfoDelivery

OJPTripInfoDelivery

+OJPTripInfoDelivery (↔ siri:AbstractFunctionalServiceDelivery)

10.20. The complex type OJPTripInfoDeliveryStructure

- - - - - - - - - - -

OJPTripInfoDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

→‍OJPTripInfoRequest

0:1

→‍OJPTripInfoRequest

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

TripInfoResponse

TripInfoResponseContext

0:1

+ResponseContext

Response context.

TripInfoResult

0:1

+TripInfoResult

Result structure.

→‍siri:Extensions

0:1

→‍siri:Extensions

10.21. The toplevel element OJPTripRequest

OJPTripRequest

+OJPTripRequest (↔ siri:AbstractFunctionalServiceRequest)

10.22. The complex type OJPTripRequestStructure

- - - - - - - - - - -

OJPTripRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

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.

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.

Params

0:1

+TripParam

Options to control the search behaviour and response contents.

→‍siri:Extensions

0:1

→‍siri:Extensions

10.23. The toplevel element OJPTripDelivery

OJPTripDelivery

+OJPTripDelivery (↔ siri:AbstractFunctionalServiceDelivery)

10.24. The complex type OJPTripDeliveryStructure

- - - - - - - - - - -

OJPTripDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

→‍OJPTripRequest

0:1

→‍OJPTripRequest

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

TripResponse

TripResponseContext

0:1

+ResponseContext

Context to hold trip response objects that occur frequently.

TripResult

0:*

+TripResult

The trip results found by the server.

→‍siri:Extensions

0:1

→‍siri:Extensions

10.25. The toplevel element OJPMultiPointTripRequest

OJPMultiPointTripRequest

+OJPMultiPointTripRequest (↔ siri:AbstractFunctionalServiceRequest)

10.26. The complex type OJPMultiPointTripRequestStructure

- - - - - - - - - - -

OJPMultiPointTripRequestStructure

+AbstractOJPServiceRequest

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.

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

Params

0:1

+MultiPointTripParam

Options to control the search behaviour and response contents.

→‍siri:Extensions

0:1

→‍siri:Extensions

10.27. The toplevel element OJPMultiPointTripDelivery

OJPMultiPointTripDelivery

+OJPMultiPointTripDelivery (↔ siri:AbstractFunctionalServiceDelivery)

10.28. The complex type OJPMultiPointTripDeliveryStructure

- - - - - - - - - - -

OJPMultiPointTripDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

→‍OJPMultiPointTripRequest

0:1

→‍OJPMultiPointTripRequest

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

MultiPointTripResponse

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

10.29. The toplevel element OJPTripRefineRequest

OJPTripRefineRequest

+OJPTripRefineRequest (↔ siri:AbstractFunctionalServiceRequest)

10.30. The complex type OJPTripRefineRequestStructure

- - - - - - - -

OJPTripRefineRequestStructure

+AbstractOJPServiceRequest

The element contains a sequence of the following elements:

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.

→‍siri:Extensions

0:1

→‍siri:Extensions

10.31. The toplevel element OJPTripRefineDelivery

OJPTripRefineDelivery

+OJPTripRefineDelivery (↔ siri:AbstractFunctionalServiceDelivery)

10.32. The complex type OJPTripRefineDeliveryStructure

- - - - - - - - - - - -

OJPTripRefineDeliveryStructure

siri:AbstractServiceDeliveryStructure

The element contains a sequence of the following elements:

→‍OJPTripRefineRequest

0:1

→‍OJPTripRefineRequest

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

TripRefineResponse

TripResponseContext

0:1

+ResponseContext

Context to hold trip response objects that occur frequently.

UnknownLegRef

0:*

xs:NMTOKEN

Refers to a leg that was not found in the data of the server. If the to be refined TripResult could not be found or unequivocally determined, all RefineLegRefs are returned as UnknownLegRefs.

TripResult

0:*

+TripResult

The trip results refined by the server.

→‍siri:Extensions

0:1

→‍siri:Extensions

-

11. OJP/OJP_RequestSupport.xsd - Supporting definitions for OJP service requests and their responses

11.1. Simple type definitions

CalcTimeType

xs:integer

Type definition for calculation time in milliseconds.

CertificateIdType

xs:NMTOKEN

Type definition for the form of identification that can be used as a Message Integrity Property (public key cryptography)

OJPGenericProblemTypeEnumeration

OJPGENERIC_REQUESTNOTSUPPORTED | OJPGENERIC_FEATURENOTSUPPORTED | OJPGENERIC_LANGUAGENOTSUPPORTED | OJPGENERIC_EXCEPTIONFROMREQUESTEDLANGUAGE | OJPGENERIC_DATAFRAMEREFNOTAVAILABLE | OJPGENERIC_OTHER

Types of problems that may be returned in case of generic problems with the request.

SignatureType

xs:string

data for transmission of message signatures (public key cryptography), used to prove Message Integrity

11.2. The MessageIntegrityPropertiesGroup group

- - -

MessageIntegrityPropertiesGroup

Properties that allow checks for message integrity.

MessageIntegrityProperties

Signature

0:1

Signature

Authorisation signature (data for transmission of message signatures (public key cryptography), used to prove Message Integrity).

CertificateId

0:1

CertificateId

form of identification that can be used as a Message Integrity Property (public key cryptography)

11.3. The ServiceRequestContextGroup group

- - -

ServiceRequestContextGroup

Generic context for all request messages.

ServiceRequestContext

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.

Extension

0:1

xs:anyType

11.4. The ServiceResponseContextGroup group

- - - -

ServiceResponseContextGroup

Generic context for all response messages.

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.

Problem

0:*

+OJPGenericProblem

OJP generic problem for the whole delivery.

11.5. The SubscriptionRequestContextGroup group

- - - - - - - -

SubscriptionRequestContextGroup

Generic context for all subscription requests.

SubscriptionRequestContext

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.

Language

0:*

xs:language

Preferred language in which to return text values.

MessageIntegrityProperties

Signature

0:1

Signature

Authorisation signature (data for transmission of message signatures (public key cryptography), used to prove Message Integrity).

CertificateId

0:1

CertificateId

form of identification that can be used as a Message Integrity Property (public key cryptography)

SubscriptionRequestContext

Extension

0:1

xs:anyType

11.6. The complex type AbstractOJPServiceRequestStructure

- - - - - - -

AbstractOJPServiceRequestStructure

siri:AbstractFunctionalServiceRequestStructure

Basic request structure common for all OJP service requests.

ServiceRequestContext

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.

Extension

0:1

xs:anyType

11.7. The complex type AbstractOJPSubscriptionRequestStructure

- - - - - - - - - - - -

AbstractOJPSubscriptionRequestStructure

siri:AbstractSubscriptionRequestStructure

Basic structure common for all OJP subscription requests.

SubscriptionRequestContext

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.

Language

0:*

xs:language

Preferred language in which to return text values.

MessageIntegrityProperties

Signature

0:1

Signature

Authorisation signature (data for transmission of message signatures (public key cryptography), used to prove Message Integrity).

CertificateId

0:1

CertificateId

form of identification that can be used as a Message Integrity Property (public key cryptography)

SubscriptionRequestContext

Extension

0:1

xs:anyType

11.8. The DeliveryRequestGroup group

- -

DeliveryRequestGroup

Wrapper for SIRI delivery request group.

→‍siri:DeliveryRequestGroup

11.9. The StatusRequestGroup group

- -

StatusRequestGroup

Wrapper for SIRI status request group.

→‍siri:StatusRequestGroup

11.10. The toplevel element TerminateSubscriptionRequest

TerminateSubscriptionRequest

siri:TerminateSubscriptionRequestStructure

Request element for terminating subscriptions (from SIRI).

11.11. The ServiceResponseGroup group

- -

ServiceResponseGroup

Wrapper for SIRI service response group.

→‍siri:ServiceResponseGroup

11.12. The complex type PlacesStructure

PlacesStructure

Structure providing a collection of places.

The element contains only one element:

Place

1:*

+Place

11.13. The complex type ResponseContextStructure

ResponseContextStructure

Structure providing response contexts related to journeys, containing collections of places and situations.

The element contains a sequence of the following elements:

Places

0:1

+Places

Container for place objects. Only place objects that are referenced in the response should be put into the container.

Situations

0:1

+Situations

Container for SIRI SX situation objects. Only situations that are referenced in the response should be put into the container.

11.14. The complex type OJPGenericProblemStructure

- - - -

OJPGenericProblemStructure

Problem that may be returned in case of generic problems with the request.

The element contains a sequence of the following elements:

Type

1:1

OJPGenericProblemType

Type of the generic problem.

ProblemDetail

Title

0:1

+InternationalText

Title of the problem.

Details

0:1

+InternationalText

Explanation of the problem.

LogData

0:1

xs:string

Additional log data.

-

12. OJP/OJP_SituationSupport.xsd - Supporting definitions for situations containing wrappers for SIRI Situation Exchange service (SIRI SX)

12.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.

RoadSituation

0:*

siri:RoadSituationElementStructure

12.2. The toplevel element SituationFullRef

SituationFullRef

+SituationFullRef

Reference to situation message. Message details might be found in response context or through other communication channels.

12.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.

-

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

13.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 - 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". -

StopEventProblemTypeEnumeration

STOPEVENT_NOEVENTFOUND | STOPEVENT_LOCATIONUNSERVED | STOPEVENT_LOCATIONUNKNOWN | STOPEVENT_DATEOUTOFRANGE | STOPEVENT_LASTSERVICEOFTHISLINE | STOPEVENT_NOREALTIME | STOPEVENT_OTHER

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

StopEventTypeEnumeration

departure | arrival | both

Departure or arrival events or both

13.2. The StopEventRequestGroup group

- - -

StopEventRequestGroup

Request structure for departure and arrival events at stops

StopEventRequest

Place

1:1

+PlaceContext

Place for which to obtain stop event information.

Params

0:1

+StopEventParam

Request parameter

13.3. The complex type StopEventParamStructure

- - - - - - - - - - - - - - - -

StopEventParamStructure

Request specific parameters (parameters which define what is to be included in a Stop Event result)

The element contains a sequence of the following elements:

StopEventDataFilter

PtModeFilter

0:1

+PtModeFilter

Modes (VEHICLE MODE) to be excluded or included in stop events.

LineFilter

0:1

+LineDirectionFilter

Lines/Directions to include/exclude.

OperatorFilter

0:1

+OperatorFilter

Transport operators to include/exclude.

StopEventPolicy

NumberOfResults

0:1

xs:positiveInteger

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

TimeWindow

0:1

xs:duration

Time window events should lie within. Starting from time given in PlaceContext.

StopEventType

0:1

StopEventType

Only departures or arrivals or both.

StopEventContentFilter

IncludePreviousCalls

0:1

xs:boolean

Whether the previous calls of each vehicle journey should be included in the response.

IncludeOnwardCalls

0:1

xs:boolean

Whether the onward calls of each vehicle journey should be included in the response.

IncludeOperatingDays

0:1

xs:boolean

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

IncludeRealtimeData

0:1

xs:boolean

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

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

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 - 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". -

13.4. The StopEventDataFilterGroup group

- - - -

StopEventDataFilterGroup

Request data filters

StopEventDataFilter

PtModeFilter

0:1

+PtModeFilter

Modes (VEHICLE MODE) to be excluded or included in stop events.

LineFilter

0:1

+LineDirectionFilter

Lines/Directions to include/exclude.

OperatorFilter

0:1

+OperatorFilter

Transport operators to include/exclude.

13.5. The StopEventPolicyGroup group

- - - -

StopEventPolicyGroup

Request policies

StopEventPolicy

NumberOfResults

0:1

xs:positiveInteger

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

TimeWindow

0:1

xs:duration

Time window events should lie within. Starting from time given in PlaceContext.

StopEventType

0:1

StopEventType

Only departures or arrivals or both.

13.6. The StopEventContentFilterGroup group

- - - - - - - -

StopEventContentFilterGroup

Content filters which data is expected in the response

StopEventContentFilter

IncludePreviousCalls

0:1

xs:boolean

Whether the previous calls of each vehicle journey should be included in the response.

IncludeOnwardCalls

0:1

xs:boolean

Whether the onward calls of each vehicle journey should be included in the response.

IncludeOperatingDays

0:1

xs:boolean

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

IncludeRealtimeData

0:1

xs:boolean

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

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

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 - 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". -

13.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.

13.8. The complex type StopEventResultStructure

StopEventResultStructure

Wrapper element for a single stop event result.

The element contains a sequence of the following elements:

ResultId

1:1

xs:NMTOKEN

ID of this result.

Problem

0:*

+StopEventProblem

Problems related to this STOPEVENT result.

StopEvent

1:1

+StopEvent

Stop event data element.

13.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.

8.8. The complex type StopEventResultStructure

StopEventResultStructure

Wrapper element for a single stop event result.

The element contains a sequence of the following elements:

ResultId

1:1

xs:NMTOKEN

ID of this result.

Problem

0:*

+StopEventProblem

Problems related to this STOPEVENT result.

StopEvent

1:1

+StopEvent

Stop event data element.

8.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".

Extension

0:1

xs:anyType

13.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 place (f.e. address) to this stop in metres.

WalkDuration

0:1

xs:duration

Walking duration from request place (f.e. address) to this stop. All user options taken into account (f.e. walk speed).

13.11. The complex type StopEventProblemStructure

+

StopEventProblemStructure

Problem that may be returned in responses to STOPEVENT requests.

The element contains a sequence of the following elements:

Type

1:1

StopEventProblemType

Type of the STOPEVENT problem.

Extension

0:1

xs:anyType

8.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 place (f.e. address) to this stop in metres.

WalkDuration

0:1

xs:duration

Walking duration from request place (f.e. address) to this stop. All user options taken into account (f.e. walk speed).

8.11. The complex type StopEventProblemStructure

StopEventProblemStructure

Problem that may be returned in responses to STOPEVENT requests.

The element contains a sequence of the following elements:

Type

1:1

StopEventProblemType

Type of the STOPEVENT problem.

ProblemDetail

Title

0:1

+InternationalText

Title of the problem.

Details

0:1

+InternationalText

Explanation of the problem.

LogData

0:1

xs:string

Additional log data.

-

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

14.1. Simple type definitions

TripInfoProblemTypeEnumeration

TRIPINFO_JOURNEYREFUNKNOWN | TRIPINFO_VEHICLEUNKNOWN | TRIPINFO_NOJOURNEYFOUND | TRIPINFO_NOGEOINFO | TRIPINFO_OTHER

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

14.2. The TripInfoRequestGroup group

+

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

9.1. Simple type definitions

TripInfoRequestGroup

TripInfo request structure.

TripInfoProblemTypeEnumeration

TRIPINFO_JOURNEYREFUNKNOWN | TRIPINFO_VEHICLEUNKNOWN | TRIPINFO_NOJOURNEYFOUND | TRIPINFO_NOGEOINFO | TRIPINFO_OTHER

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

9.2. The TripInfoRequestGroup group

@@ -814,7 +589,7 @@

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

a

→‍OperatingDayRef

1:1

→‍OperatingDayRef

Reference to an Operating Day

b

TimeOfOperation

1:1

xs:dateTime

Time stamp when the vehicle is operating. In most use cases equal to "now".

TripInfoRequest

Params

0:1

+TripInfoParam

Request parameter.

14.3. The complex type TripInfoParamStructure

+

TripInfoParamStructure

TripInfo request parameter structure.

The element contains a sequence of the following elements:

9.3. The complex type TripInfoParamStructure

@@ -824,9 +599,9 @@

OJP - Open API for distributed Journey

-

TripInfoParamStructure

TripInfo request parameter structure.

The element contains a sequence of the following elements:

TripInfoPolicy

UseTimetabledDataOnly

0:1

xs:boolean

Do not show any realtime or incident data. Default is false.

TripInfoContentFilter

IncludeCalls

0:1

xs:boolean

Whether call information is to be included. Default is true.

IncludeTrackProjection

0:1

xs:boolean

Whether the result should include the geographic projection (coordinates) of this vehicle journey.

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

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

Extension

0:1

xs:anyType

14.4. The TripInfoPolicyGroup group

+

TripInfoPolicyGroup

Parameters that control the response behaviour.

Extension

0:1

xs:anyType

9.4. The TripInfoPolicyGroup group

-

TripInfoPolicyGroup

Parameters that control the response behaviour.

TripInfoPolicy

UseTimetabledDataOnly

0:1

xs:boolean

Do not show any realtime or incident data. Default is false.

14.5. The TripInfoContentFilterGroup group

+

TripInfoContentFilterGroup

Parameters that control the level of detail to be returned in the results.

9.5. The TripInfoContentFilterGroup group

@@ -834,23 +609,23 @@

OJP - Open API for distributed Journey

-

TripInfoContentFilterGroup

Parameters that control the level of detail to be returned in the results.

TripInfoContentFilter

IncludeCalls

0:1

xs:boolean

Whether call information is to be included. Default is true.

IncludePosition

0:1

xs:boolean

Whether current position is to be included. Default is true.

IncludeService

0:1

xs:boolean

Whether service information is to be included. Default is true.

IncludeTrackProjection

0:1

xs:boolean

Whether the result should include the geographic projection (coordinates) of this vehicle journey.

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

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

14.6. The TripInfoResponseGroup group

+

TripInfoResponseGroup

TripInfo response structure.

9.6. The TripInfoResponseGroup group

-

TripInfoResponseGroup

TripInfo response structure.

TripInfoResponse

TripInfoResponseContext

0:1

+ResponseContext

Response context.

TripInfoResult

0:1

+TripInfoResult

Result structure.

14.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:

Problem

0:*

+TripInfoProblem

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.

9.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:

Problem

0:*

+TripInfoProblem

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".

→‍siri:ServiceFacilityGroup

JourneyTrack

0:1

+LegTrack

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

Extension

0:1

xs:anyType

14.8. The complex type TripInfoProblemStructure

TripInfoProblemStructure

Problem that may be returned in responses to TripInfo requests.

The element contains only one element:

Type

1:1

TripInfoProblemType

Type of the TripInfo problem.

-

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

15.1. Simple type definitions

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).

GuidanceAdviceEnumeration

origin | destination | continue | keep | turn | leave | enter

various types of guidance advice given to travelle

MultiPointTypeEnumeration

anyPoint | eachOrigin | eachDestination

How the multiple origin/destination points should be considered

OptimisationMethodEnumeration

fastest | minChanges | leastWalking | leastCost | leastDistance | earliestArrival | latestDeparture | earliestArrivalAndLatestDeparture

the types of algorithm that can be used for planning a journey (fastest, least walking, etc). If multiple optimisation methods are needed, then several requests should be performed in parallel.

TransitionEnumeration

up | down | level | upAndDown | downAndUp

Transition types for interchanges.

TripProblemTypeEnumeration

TRIP_NOTRIPFOUND | TRIP_ORIGINUNKNOWN | TRIP_DESTINATIONUNKNOWN | TRIP_VIAUNKNOWN | TRIP_NOTVIAUNKNOWN | TRIP_NOCHANGEATUNKNOWN | TRIP_NOORIGIN | TRIP_NODESTINATION | TRIP_ORIGINDESTINATIONIDENTICAL | TRIP_DATETIMEERROR | TRIP_DEPARTUREAFTERARRIVAL | TRIP_DATEOUTOFRANGE | TRIP_ORIGINEQUIVALENT | TRIP_DESTINATIONEQUIVALENT | TRIP_VIAEQUIVALENT | TRIP_REALTIMEINCOMPLETE | TRIP_ITTIMEEXTENDED | TRIP_ITMODECHANGED | TRIP_INCONVENIENTWAITING | TRIP_MULTIPOINT_NOTALLPOINTSCOVERED | TRIP_MULTIPOINT_TOOMANYPOINTS | TRIP_OTHER

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

TurnActionEnumeration

sharp left | left | half left | straight on | half right | right | sharp right | uturn

the range of alternative turns that can be described

15.2. The TripRequestGroup group

+

TripRequestGroup

Trip request structure.

JourneyTrack

0:1

+LegTrack

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

Extension

0:1

xs:anyType

9.8. The complex type TripInfoProblemStructure

TripInfoProblemStructure

Problem that may be returned in responses to TripInfo requests.

The element contains only one element:

Type

1:1

TripInfoProblemType

Type of the TripInfo problem.

+

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

10.1. Simple type definitions

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).

GuidanceAdviceEnumeration

origin | destination | continue | keep | turn | leave | enter

various types of guidance advice given to travelle

MultiPointTypeEnumeration

anyPoint | eachOrigin | eachDestination

How the multiple origin/destination points should be considered

OptimisationMethodEnumeration

fastest | minChanges | leastWalking | leastCost | leastDistance | earliestArrival | latestDeparture | earliestArrivalAndLatestDeparture

the types of algorithm that can be used for planning a journey (fastest, least walking, etc). If multiple optimisation methods are needed, then several requests should be performed in parallel.

TransitionEnumeration

up | down | level | upAndDown | downAndUp

Transition types for interchanges.

TripProblemTypeEnumeration

TRIP_NOTRIPFOUND | TRIP_ORIGINUNKNOWN | TRIP_DESTINATIONUNKNOWN | TRIP_VIAUNKNOWN | TRIP_NOTVIAUNKNOWN | TRIP_NOCHANGEATUNKNOWN | TRIP_NOORIGIN | TRIP_NODESTINATION | TRIP_ORIGINDESTINATIONIDENTICAL | TRIP_DATETIMEERROR | TRIP_DEPARTUREAFTERARRIVAL | TRIP_DATEOUTOFRANGE | TRIP_ORIGINEQUIVALENT | TRIP_DESTINATIONEQUIVALENT | TRIP_VIAEQUIVALENT | TRIP_REALTIMEINCOMPLETE | TRIP_ITTIMEEXTENDED | TRIP_ITMODECHANGED | TRIP_INCONVENIENTWAITING | TRIP_MULTIPOINT_NOTALLPOINTSCOVERED | TRIP_MULTIPOINT_TOOMANYPOINTS | TRIP_OTHER

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

TurnActionEnumeration

sharp left | left | half left | straight on | half right | right | sharp right | uturn

the range of alternative turns that can be described

10.2. The TripRequestGroup group

-

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.

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.

Params

0:1

+TripParam

Options to control the search behaviour and response contents.

15.3. The complex type TripParamStructure

+

TripParamStructure

Trip request parameter structure.

The element contains a sequence of the following elements:

10.3. The complex type TripParamStructure

@@ -896,14 +671,14 @@

OJP - Open API for distributed Journey

-

TripParamStructure

Trip request parameter structure.

The element contains a sequence of the following elements:

TripDataFilter

PtModeFilter

0:1

+PtModeFilter

Modes (VEHICLE MODE) to be excluded or included in trip calculation.

LineFilter

0:1

+LineDirectionFilter

Lines/Directions to include/exclude.

OperatorFilter

0:1

+OperatorFilter

Transport operators to include/exclude.

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

Extension

0:1

xs:anyType

15.4. The TripDataFilterGroup group

+

TripDataFilterGroup

Data to be included/excluded from search, f.e. modes, operators.

FareParam

0:1

+FareParam

Extension

0:1

xs:anyType

10.4. The TripDataFilterGroup group

-

TripDataFilterGroup

Data to be included/excluded from search, f.e. modes, operators.

TripDataFilter

PtModeFilter

0:1

+PtModeFilter

Modes (VEHICLE MODE) to be excluded or included in trip calculation.

LineFilter

0:1

+LineDirectionFilter

Lines/Directions to include/exclude.

OperatorFilter

0:1

+OperatorFilter

Transport operators to include/exclude.

PrivateModeFilter

0:1

+PrivateModeFilter

Private mobility options to include/exclude.

VehicleFilter

0:1

+VehicleFilter

Filter for VEHICLE and TRAIN NUMBERs.

TariffzoneFilter

0:1

+TariffzoneFilter

Filter for trips using only specific tariff zones.

15.5. The TripPolicyGroup group

+

TripPolicyGroup

Policies that control the trip search behaviour.

10.5. The TripPolicyGroup group

@@ -916,7 +691,7 @@

OJP - Open API for distributed Journey

-

TripPolicyGroup

Policies that control the trip search behaviour.

The element contains one of the following elements:

NumberOfResults

a

NumberOfResultsBefore

1:1

xs:nonNegativeInteger

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

OptimisationMethod

0:1

OptimisationMethod

the types of algorithm that can be used for planning a journey (fastest, least walking, etc)

ItModesToCover

0:*

IndividualModes

For each mode in this list a separate monomodal trip shall be found - in addition to inter-modal solutions.

ConsiderElevationData

0:1

xs:boolean

Trip calculation takes elevation data into account (bike, walk)

15.6. The TripMobilityFilterGroup group

+

TripMobilityFilterGroup

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

10.6. The TripMobilityFilterGroup group

@@ -929,7 +704,7 @@

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 climb one step.

NoStairs

0:1

xs:boolean

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

BikeTransport

0:1

xs:boolean

The user wants to carry a bike on public transport.

WalkSpeed

0:1

OpenPercent

Deviation from average walk 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).

15.7. The TripContentFilterGroup group

+

TripContentFilterGroup

Parameters that control the level of detail of the trip results.

10.7. The TripContentFilterGroup group

@@ -942,13 +717,13 @@

OJP - Open API for distributed Journey

-

TripContentFilterGroup

Parameters that control the level of detail of the trip results.

BaseTripContentFilter

IncludeTrackSections

0:1

xs:boolean

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

IncludeLegProjection

0:1

xs:boolean

Whether the result should include the geographic projection (coordinates) of each journey leg.

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.

15.8. The complex type NotViaStructure

NotViaStructure

NNot-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

b

→‍StopPlaceRef

-1:1

→‍StopPlaceRef

Reference to a Stop Place

15.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

b

→‍StopPlaceRef

-1:1

→‍StopPlaceRef

Reference to a Stop Place

15.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

15.11. The TripResponseGroup group

+

TripResponseGroup

Trip response structure.

10.8. The complex type NotViaStructure

NotViaStructure

NNot-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

b

→‍StopPlaceRef

-1:1

→‍StopPlaceRef

Reference to a Stop Place

10.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

b

→‍StopPlaceRef

-1:1

→‍StopPlaceRef

Reference to a Stop Place

10.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

10.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.

15.12. The complex type TripResultStructure

TripResultStructure

Structure for a single trip result and associated problems.

The element contains a sequence of the following elements:

ResultId

1:1

xs:NMTOKEN

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

Problem

0:*

+TripProblem

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

15.13. The complex type TripSummaryStructure

+

TripSummaryStructure

Structure for trip overview information.

The element contains a sequence of the following elements:

TripId

1:1

xs:NMTOKEN

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.

StartTime

0:1

xs:dateTime

Departure time at origin.

EndTime

0:1

xs:dateTime

Arrival time at destination.

PTTripLegs

0:1

xs:nonNegativeInteger

Number of public transport trip legs.

Distance

0:1

siri:DistanceType

Trip distance.

10.12. The complex type TripResultStructure

TripResultStructure

Structure for a single trip result and associated problems.

The element contains a sequence of the following elements:

ResultId

1:1

xs:NMTOKEN

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

Problem

0:*

+TripProblem

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

10.13. The complex type TripSummaryStructure

-

TripSummaryStructure

Structure for trip overview information.

The element contains a sequence of the following elements:

TripId

1:1

xs:NMTOKEN

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.

StartTime

0:1

xs:dateTime

Departure time at origin.

EndTime

0:1

xs:dateTime

Arrival time at destination.

PTTripLegs

0:1

xs:nonNegativeInteger

Number of public transport trip legs.

Distance

0:1

siri:DistanceType

Trip distance.

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".

→‍SituationFullRef

0:*

→‍SituationFullRef

Reference to situation message. Message details might be found in response context or through other communication channels.

Extension

0:1

xs:anyType

15.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 trip LEGs

The element contains a sequence of the following elements:

TripId

1:1

xs:NMTOKEN

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

Duration

1:1

xs:duration

Overall duration of the trip.

StartTime

1:1

xs:dateTime

Departure time at origin.

EndTime

1:1

xs:dateTime

Arrival time at destination.

Transfers

1:1

xs:nonNegativeInteger

Number of interchanges.

Distance

0:1

siri:DistanceType

Trip distance.

TripLeg

1:*

+TripLeg

Legs of the trip

→‍SituationFullRef

0:*

→‍SituationFullRef

Reference to situation message. Message details might be found in response context or through other communication channels.

Extension

0:1

xs:anyType

10.14. The complex type TripStructure

@@ -957,20 +732,20 @@

OJP - Open API for distributed Journey

-

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 trip LEGs

The element contains a sequence of the following elements:

TripId

1:1

xs:NMTOKEN

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

Duration

1:1

xs:duration

Overall duration of the trip.

StartTime

1:1

xs:dateTime

Departure time at origin.

EndTime

1:1

xs:dateTime

Arrival time at destination.

Transfers

1:1

xs:nonNegativeInteger

Number of interchanges.

Distance

0:1

siri:DistanceType

Trip distance.

TripLeg

1:*

+TripLeg

Legs of the trip

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".

→‍SituationFullRef

0:*

→‍SituationFullRef

Reference to situation message. Message details might be found in response context or through other communication channels.

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.

Extension

0:1

xs:anyType

15.15. The complex type TripLegStructure

TripLegStructure

a single stage of a TRIP that is made without change of MODE or service (ie: between each interchange)

The element contains a sequence of the following elements:

LegId

1:1

xs:NMTOKEN

Id of this trip 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)

Then, the element contains one of the following elements:

a

ContinuousLeg

-1:1

+ContinuousLeg

b

TimedLeg

-1:1

+TimedLeg

c

TransferLeg

-1:1

+TransferLeg

15.16. The complex type TimedLegStructure

+

TimedLegStructure

passenger TRIP LEG with timetabled schedule. Corresponds to a RIDE.

The element contains a sequence of the following elements:

LegBoard

1:1

+LegBoard

Stop/Station where boarding is done

LegIntermediates

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 trip leg.

LegAttribute

0:*

+LegAttribute

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

Extension

0:1

xs:anyType

10.15. The complex type TripLegStructure

TripLegStructure

a single stage of a TRIP that is made without change of MODE or service (ie: between each interchange)

The element contains a sequence of the following elements:

LegId

1:1

xs:NMTOKEN

Id of this trip 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)

Then, the element contains one of the following elements:

a

ContinuousLeg

-1:1

+ContinuousLeg

b

TimedLeg

-1:1

+TimedLeg

c

TransferLeg

-1:1

+TransferLeg

10.16. The complex type TimedLegStructure

-

TimedLegStructure

passenger TRIP LEG with timetabled schedule. Corresponds to a RIDE.

The element contains a sequence of the following elements:

LegBoard

1:1

+LegBoard

Stop/Station where boarding is done

LegIntermediates

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 trip 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.

Extension

0:1

xs:anyType

15.17. The complex type TransferLegStructure

+

TransferLegStructure

[a specialised type of NAVIGATION PATH in TMv6] description of a LEG which links other LEGs of a TRIP where a TRANSFER between different LOCATIONs is required

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

a

ContinuousMode

-1:1

ContinuousModes

Mode that is used for this interchange between public services.

b

TransferMode

-1:1

TransferModes

Mode that is used for this interchange between public services.

LegStart

1:1

+PlaceRef

Stop/Station where boarding is done

LegEnd

1:1

+PlaceRef

Stop/Station to alight

LegTrack

0:1

+LegTrack

Geographic embedding of this leg.

Extension

0:1

xs:anyType

10.17. The complex type TransferLegStructure

-

TransferLegStructure

[a specialised type of NAVIGATION PATH in TMv6] description of a LEG which links other LEGs of a TRIP where a TRANSFER between different LOCATIONs is required

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

a

ContinuousMode

-1:1

ContinuousModes

Mode that is used for this interchange between public services.

b

TransferMode

-1:1

TransferModes

Mode that is used for this interchange between public services.

LegStart

1:1

+PlaceRef

Stop/Station where boarding is done

LegEnd

1:1

+PlaceRef

Stop/Station to alight

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.

WalkDuration

0:1

xs:duration

Walk time as part of the overall interchange duration.

BufferTime

0:1

xs:duration

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

LegDescription

0:1

+InternationalText

Text that describes this interchange.

Length

0:1

Length

Length of this interchange path.

Attribute

0:*

+GeneralAttribute

Note or service attribute.

PathGuidance

0:1

+PathGuidance

Structured model further describing this interchange, its geographic embedding and accessibility.

→‍SituationFullRef

0:*

→‍SituationFullRef

Reference to situation message. Message details might be found in response context or through other communication channels.

Extension

0:1

xs:anyType

15.18. The complex type ContinuousLegStructure

+

ContinuousLegStructure

[relates to a specific type of RIDE in TM and NeTEx] leg of a journey that is not bound to a timetable

The element contains a sequence of the following elements:

LegStart

1:1

+PlaceRef

Stop/Station where boarding is done

LegEnd

1:1

+PlaceRef

Stop/Station to alight

Service

1:1

+ContinuousService

Service of this leg. May be "walk" in most cases, but also cycling or taxi etc.

LegDescription

0:1

+InternationalText

Text that describes this interchange.

Length

0:1

Length

Length of this interchange path.

Attribute

0:*

+GeneralAttribute

Note or service attribute.

PathGuidance

0:1

+PathGuidance

Structured model further describing this interchange, its geographic embedding and accessibility.

→‍SituationFullRef

0:*

→‍SituationFullRef

Reference to situation message. Message details might be found in response context or through other communication channels.

Extension

0:1

xs:anyType

10.18. The complex type ContinuousLegStructure

-

ContinuousLegStructure

[relates to a specific type of RIDE in TM and NeTEx] leg of a journey that is not bound to a timetable

The element contains a sequence of the following elements:

LegStart

1:1

+PlaceRef

Stop/Station where boarding is done

LegEnd

1:1

+PlaceRef

Stop/Station to alight

Service

1:1

+ContinuousService

Service of this leg. May be "walk" in most cases, but also cycling or taxi etc.

TimeWindow

TimeWindowStart

0:1

xs:dateTime

Time at which window begins.

TimeWindowEnd

0:1

xs:dateTime

Time at which window ends.

Duration

1:1

xs:duration

Duration of this leg according to user preferences like walk 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.

→‍SituationFullRef

0:*

→‍SituationFullRef

Reference to situation message. Message details might be found in response context or through other communication channels.

Extension

0:1

xs:anyType

15.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:

Duration

1:1

xs:duration

Duration of this leg according to user preferences like walk 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.

→‍SituationFullRef

0:*

→‍SituationFullRef

Reference to situation message. Message details might be found in response context or through other communication channels.

Extension

0:1

xs:anyType

10.19. The complex type LegBoardStructure

@@ -983,7 +758,7 @@

OJP - Open API for distributed Journey

-

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:

StopPoint

→‍siri:StopPointRef

1:1

→‍siri:StopPointRef

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. F.e. "opposite main entrance".

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.

15.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:

10.20. The complex type LegAlightStructure

@@ -996,7 +771,7 @@

OJP - Open API for distributed Journey

-

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

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. F.e. "opposite main entrance".

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.

15.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:

10.21. The complex type LegIntermediateStructure

@@ -1009,18 +784,18 @@

OJP - Open API for distributed Journey

-

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

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. F.e. "opposite main entrance".

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.

15.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

one or more path guidance sections that build the trip Leg

15.23. The complex type PathGuidanceSectionStructure

PathGuidanceSectionStructure

[an extended definition of a NAVIGATION PATH in TMv6 to include the textual navigation instructions] description of a piece 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

LINK PROJECTION on the infrastructure network of the TRIP LEG together with time information

TurnDescription

0:1

+InternationalText

Textual description of a manoeuvre. This should imply the information from Manoeuvre, TurnAction, and TrackSection.RoadName.

GuidanceAdvice

0:1

GuidanceAdvice

various types of guidance advice given to travelle.

TurnAction

0:1

TurnAction

the range of alternative turns that can be described.

DirectionHint

0:1

+InternationalText

Textual direction hint for better understanding, e.g. "follow signs to Hamburg".

Bearing

0:1

siri:AbsoluteBearingType

Absolute bearing after the described manoeuvre.

PathLink

0:1

+PathLink

Description of the type of accessibility on this navigation section.

SituationFullRef

0:*

+SituationFullRef

15.24. 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..

10.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

one or more path guidance sections that build the trip Leg

10.23. The complex type PathGuidanceSectionStructure

PathGuidanceSectionStructure

[an extended definition of a NAVIGATION PATH in TMv6 to include the textual navigation instructions] description of a piece 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

LINK PROJECTION on the infrastructure network of the TRIP LEG together with time information

TurnDescription

0:1

+InternationalText

Textual description of a manoeuvre. This should imply the information from Manoeuvre, TurnAction, and TrackSection.RoadName.

GuidanceAdvice

0:1

GuidanceAdvice

various types of guidance advice given to travelle.

TurnAction

0:1

TurnAction

the range of alternative turns that can be described.

DirectionHint

0:1

+InternationalText

Textual direction hint for better understanding, e.g. "follow signs to Hamburg".

Bearing

0:1

siri:AbsoluteBearingType

Absolute bearing after the described manoeuvre.

PathLink

0:1

+PathLink

Description of the type of accessibility on this navigation section.

SituationFullRef

0:*

+SituationFullRef

10.24. 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.

WalkDuration

0:1

xs:duration

Walk time as part of the overall interchange duration.

BufferTime

0:1

xs:duration

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

15.25. 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.

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 how often the access feature occurs in this PathLink

AccessibilityFeature

0:*

AccessibilityFeatureTypes

Presence of an accessibility feature on the PathLink.

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.

15.26. 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

xs:normalizedString

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

15.27. The MultiPointTripRequestGroup group

+

MultiPointTripRequestGroup

Multi-point trip request structure.

10.25. 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.

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 how often the access feature occurs in this PathLink

AccessibilityFeature

0:*

AccessibilityFeatureTypes

Presence of an accessibility feature on the PathLink.

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.

10.26. 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

xs:normalizedString

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

10.27. The MultiPointTripRequestGroup group

-

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.

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

Params

0:1

+MultiPointTripParam

Options to control the search behaviour and response contents.

15.28. The complex type MultiPointTripParamStructure

+

MultiPointTripParamStructure

Multi-point trip request parameter structure.

The element contains a sequence of the following elements:

10.28. The complex type MultiPointTripParamStructure

@@ -1065,7 +840,7 @@

OJP - Open API for distributed Journey

-

MultiPointTripParamStructure

Multi-point trip request parameter structure.

The element contains a sequence of the following elements:

TripDataFilter

PtModeFilter

0:1

+PtModeFilter

Modes (VEHICLE MODE) to be excluded or included in trip calculation.

LineFilter

0:1

+LineDirectionFilter

Lines/Directions to include/exclude.

OperatorFilter

0:1

+OperatorFilter

Transport operators to include/exclude.

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

Extension

0:1

xs:anyType

15.29. The MultiPointTripPolicyGroup group

+

MultiPointTripPolicyGroup

Policies that control the multi-point trip search behaviour.

FareParam

0:1

+FareParam

Extension

0:1

xs:anyType

10.29. The MultiPointTripPolicyGroup group

@@ -1077,26 +852,26 @@

OJP - Open API for distributed Journey

-

MultiPointTripPolicyGroup

Policies that control the multi-point trip search behaviour.

The element contains one of the following elements:

NumberOfResults

a

NumberOfResultsBefore

1:1

xs:nonNegativeInteger

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

MultiPointTripPolicy

TransferLimit

0:1

xs:nonNegativeInteger

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

OptimisationMethod

0:1

OptimisationMethod

the types of algorithm that can be used for planning a journey (fastest, least walking, etc)

MultiPointType

0: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.

15.30. The MultiPointTripResponseGroup group

+

MultiPointTripResponseGroup

Multi-point trip response structure.

10.30. The MultiPointTripResponseGroup group

-

MultiPointTripResponseGroup

Multi-point trip response structure.

MultiPointTripResponse

MultiPointTripResponseContext

0:1

+ResponseContext

Context to hold trip response objects that occur frequently.

MultiPointTripResult

0:*

+MultiPointTripResult

The trip results found by the server.

15.31. The complex type MultiPointTripResultStructure

+

MultiPointTripResultStructure

Structure for a multipoint trip result and associated problems

The element contains a sequence of the following elements:

ResultId

1:1

xs:NMTOKEN

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

Problem

0:*

+TripProblem

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

10.31. The complex type MultiPointTripResultStructure

-

MultiPointTripResultStructure

Structure for a multipoint trip result and associated problems

The element contains a sequence of the following elements:

ResultId

1:1

xs:NMTOKEN

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

Problem

0:*

+TripProblem

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

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.

TripFare

0:*

+TripFareResult

15.32. The MultiPointWaitTimeGroup group

+

MultiPointWaitTimeGroup

Group for wait times at origin/destination.

TripFare

0:*

+TripFareResult

10.32. 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.

15.33. The TripStatusGroup group

+

TripStatusGroup

Parameters which describe the current status of a TRIP

10.33. The TripStatusGroup group

-

TripStatusGroup

Parameters which describe the current status of a TRIP

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.

15.34. The TripRefineRequestGroup group

+

TripRefineRequestGroup

Trip refinement request structure.

10.34. The TripRefineRequestGroup group

-

TripRefineRequestGroup

Trip refinement request structure.

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.

15.35. 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:*

xs:NMTOKEN

Refers to a leg to be refined by the server.

10.35. The complex type TripRefineParamStructure

@@ -1109,20 +884,380 @@

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:*

xs:NMTOKEN

Refers to a leg to be refined by the server.

BaseTripContentFilter

IncludeTrackSections

0:1

xs:boolean

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

IncludeLegProjection

0:1

xs:boolean

Whether the result should include the geographic projection (coordinates) of each journey leg.

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

15.36. The TripRefineResponseGroup group

+

TripRefineResponseGroup

Trip refinement response structure.

FareParam

0:1

+FareParam

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

Extension

0:1

xs:anyType

10.36. The TripRefineResponseGroup group

-

TripRefineResponseGroup

Trip refinement response structure.

TripRefineResponse

TripResponseContext

0:1

+ResponseContext

Context to hold trip response objects that occur frequently.

UnknownLegRef

0:*

xs:NMTOKEN

Refers to a leg that was not found in the data of the server. If the to be refined TripResult could not be found or unequivocally determined, all RefineLegRefs are returned as UnknownLegRefs.

TripResult

0:*

+TripResult

The trip results refined by the server.

15.37. The complex type TripProblemStructure

+

TripProblemStructure

Problem that may be returned in responses to trip requests.

The element contains a sequence of the following elements:

Type

1:1

TripProblemType

Type of the trip problem.

10.37. The complex type TripProblemStructure

+ + + +

TripProblemStructure

Problem that may be returned in responses to trip requests.

The element contains a sequence of the following elements:

Type

1:1

TripProblemType

Type of the trip problem.

ProblemDetail

Title

0:1

+InternationalText

Title of the problem.

Details

0:1

+InternationalText

Explanation of the problem.

LogData

0:1

xs:string

Additional log data.

+

11. OJP/OJP_JourneySupport.xsd - Supporting definitions for journeys on public transport vehicles

11.1. Simple type definitions

ReservationNeededEnumeration

none | service | stop

Possible types of reservation needed for services.

VehicleProgressEnumeration

Not yet operated | Operation finished | At stop | Between stops

Vehicle progress relative to timetable service pattern.

11.2. The complex type ServiceViaPointStructure

+ + + + + +

ServiceViaPointStructure

[a specialisation of VIA in TMv6] STOP PLACE or SCHEDULED STOP POINT as a VIA for a particular SERVICE PATTERN. Specialisation of a VIA.

The element contains a sequence of the following elements:

StopPoint

→‍siri:StopPointRef

1:1

→‍siri:StopPointRef

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. F.e. "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.

11.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".

11.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.

11.5. The ScheduledJourneyGroup group

+ + + + + + + + + + + + + + +

ScheduledJourneyGroup

Vehicle journey (not dated).

ScheduledJourney

→‍JourneyRef

1:1

→‍JourneyRef

Reference to a Journey

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, f.e. "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.

→‍OperatorRef

0:1

→‍OperatorRef

Reference to an Operator ([TMv6] company providing public transport services.) Reference to transport operatorIdentifier of the operator of the sharing service

RouteDescription

0:1

+InternationalText

Descriptive text for a route, f.e. "Airport via City Centre"

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public.

Attribute

0:*

+GeneralAttribute

Note or service attribute.

11.6. The ServiceGroup group

+ + + + + + + + + + +

ServiceGroup

Properties of a service (line and direction): attributes of Continuous Journey Structure or Dated Journey Structure.

→‍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, f.e. "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.

→‍OperatorRef

0:1

→‍OperatorRef

Reference to an Operator ([TMv6] company providing public transport services.) Reference to transport operatorIdentifier of the operator of the sharing service

RouteDescription

0:1

+InternationalText

Descriptive text for a route, f.e. "Airport via City Centre"

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public.

Attribute

0:*

+GeneralAttribute

Note or service attribute.

11.7. The ServiceOriginGroup group

+ + +

ServiceOriginGroup

First serviced stop of a vehicle journey.

ServiceOrigin

OriginStopPointRef

0:1

siri:StopPointRefStructure

First stop of the vehicle journey; origin stop point.

OriginText

1:1

+InternationalText

Label for first stop.

11.8. The ServiceDestinationGroup group

+ + +

ServiceDestinationGroup

Last serviced stop of a vehicle journey.

ServiceDestination

DestinationStopPointRef

0:1

siri:StopPointRefStructure

Last stop of vehicle journey; destination stop point.

DestinationText

1:1

+InternationalText

Label for last stop.

11.9. The RouteDescriptionGroup group

+ +

RouteDescriptionGroup

Descriptive text for a route, f.e. "Airport via City Centre"

RouteDescription

RouteDescriptionText

1:1

+InternationalText

11.10. The DatedJourneyGroup group

+ + + + + + + + + + + + + + + + + + +

DatedJourneyGroup

Vehicle journey that runs at a specific date.

DatedJourney

→‍OperatingDayRef

1:1

→‍OperatingDayRef

Reference to an Operating Day

→‍siri:VehicleRef

0:1

→‍siri:VehicleRef

ScheduledJourney

→‍JourneyRef

1:1

→‍JourneyRef

Reference to a Journey

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, f.e. "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.

→‍OperatorRef

0:1

→‍OperatorRef

Reference to an Operator ([TMv6] company providing public transport services.) Reference to transport operatorIdentifier of the operator of the sharing service

RouteDescription

0:1

+InternationalText

Descriptive text for a route, f.e. "Airport via City Centre"

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public.

Attribute

0:*

+GeneralAttribute

Note or service attribute.

11.11. The PrivateServiceGroup group

+ + + + +

PrivateServiceGroup

specific service operated by a Private Mode

PrivateService

→‍JourneyRef

0:1

→‍JourneyRef

Reference to a Journey

PrivateMode

1:1

PrivateModes

[a category of MODE in TMv6] MODEs offered by private individuals

OrganisationRef

0:1

siri:OperatorRefStructure

InfoUrl

0:1

+WebLink

Link to web page providing more details on service.

11.12. The complex type DatedJourneyStructure

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

DatedJourneyStructure

[equivalent to DATED VEHICLE JOURNEY in TMv6] passenger carrying VEHICLE JOURNEY for one specified DAY TYPE for which the pattern of working is in principle defined by a SERVICE JOURNEY PATTERN. DatedJourney details of a service include its operating days.

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

DatedJourney

a

→‍OperatingDayRef

1:1

→‍OperatingDayRef

Reference to an Operating Day

a

→‍siri:VehicleRef

0:1

→‍siri:VehicleRef

ScheduledJourney

a

→‍JourneyRef

1:1

→‍JourneyRef

Reference to a Journey

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, f.e. "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

→‍OperatorRef

0:1

→‍OperatorRef

Reference to an Operator ([TMv6] company providing public transport services.) Reference to transport operatorIdentifier of the operator of the sharing service

a

RouteDescription

0:1

+InternationalText

Descriptive text for a route, f.e. "Airport via City Centre"

a

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public.

a

Attribute

0:*

+GeneralAttribute

Note or service attribute.

PrivateService

b

→‍JourneyRef

0:1

→‍JourneyRef

Reference to a Journey

b

PrivateMode

1:1

PrivateModes

[a category of MODE in TMv6] MODEs offered by private individuals

b

OrganisationRef

0:1

siri:OperatorRefStructure

b

InfoUrl

0:1

+WebLink

Link to web page providing more details on service.

ServiceOrigin

OriginStopPointRef

0:1

siri:StopPointRefStructure

First stop of the vehicle journey; origin stop point.

OriginText

1:1

+InternationalText

Label for first stop.

ServiceDestination

DestinationStopPointRef

0:1

siri:StopPointRefStructure

Last stop of vehicle journey; destination stop point.

DestinationText

1:1

+InternationalText

Label for last stop.

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.

Occupancy

0:1

siri:OccupancyEnumeration

[equivalent to OCCUPANCY in SIRI] passenger load status of a VEHICLE. If omitted, not known.

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.

→‍SituationFullRef

0:*

→‍SituationFullRef

Reference to situation message. Message details might be found in response context or through other communication channels.

Extension

0:1

xs:anyType

11.13. The complex type TripPlaceStructure

TripPlaceStructure

A trip place represents the current logical position of a journey service. It can be used similarly to a place e.g. for starting a new trip requests from within this service. A trip place 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

11.14. The TimeWindowGroup group

+ + +

TimeWindowGroup

The window of opportunity that the traveller has to perform this leg of the journey.

TimeWindow

TimeWindowStart

0:1

xs:dateTime

Time at which window begins.

TimeWindowEnd

0:1

xs:dateTime

Time at which window ends.

11.15. The ServiceTimeGroup group

+ + + + + + + +

ServiceTimeGroup

Contains at least scheduled time, but can contain real time and estimated times

ServiceTime

TimetabledTime

1:1

xs:dateTime

time at point as it is published

RecordedAtTime

0:1

xs:dateTime

time as it was recorded

EstimatedTime

0:1

xs:dateTime

estimated time (for prognosis)

EstimatedTimeBand

EstimatedTimeLow

0:1

xs:dateTime

Estimated lower limit for time.

EstimatedTimeHigh

0:1

xs:dateTime

Estimated upper limit for time.

11.16. The EstimatedTimeBandGroup group

+ + +

EstimatedTimeBandGroup

Range for estimated time.

EstimatedTimeBand

EstimatedTimeLow

0:1

xs:dateTime

Estimated lower limit for time.

EstimatedTimeHigh

0:1

xs:dateTime

Estimated upper limit for time.

11.17. The complex type ServiceArrivalStructure

+ + + + + + + +

ServiceArrivalStructure

Arrival times of a service at a stop (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME).

The element contains only one element:

ServiceTime

TimetabledTime

1:1

xs:dateTime

time at point as it is published

RecordedAtTime

0:1

xs:dateTime

time as it was recorded

EstimatedTime

0:1

xs:dateTime

estimated time (for prognosis)

EstimatedTimeBand

EstimatedTimeLow

0:1

xs:dateTime

Estimated lower limit for time.

EstimatedTimeHigh

0:1

xs:dateTime

Estimated upper limit for time.

11.18. The complex type ServiceDepartureStructure

+ + + + + + + +

ServiceDepartureStructure

Departure times of a service at a stop (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME).

The element contains only one element:

ServiceTime

TimetabledTime

1:1

xs:dateTime

time at point as it is published

RecordedAtTime

0:1

xs:dateTime

time as it was recorded

EstimatedTime

0:1

xs:dateTime

estimated time (for prognosis)

EstimatedTimeBand

EstimatedTimeLow

0:1

xs:dateTime

Estimated lower limit for time.

EstimatedTimeHigh

0:1

xs:dateTime

Estimated upper limit for time.

11.19. The complex type CallAtStopStructure

+ + + + + + + + + + + + +

CallAtStopStructure

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

The element contains a sequence of the following elements:

StopPoint

→‍siri:StopPointRef

1:1

→‍siri:StopPointRef

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. F.e. "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).

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.

→‍SituationFullRef

0:*

→‍SituationFullRef

Reference to situation message. Message details might be found in response context or through other communication channels.

11.20. The StopCallStatusGroup group

+ + + + + + +

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.

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.

11.21. The ServiceStatusGroup group

+ + + + +

ServiceStatusGroup

parameters which describe the current 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.

Occupancy

0:1

siri:OccupancyEnumeration

[equivalent to OCCUPANCY in SIRI] passenger load status of a VEHICLE. If omitted, not known.

11.22. The complex type ContinuousServiceStructure

+ + + + + + + + + + + + + + + + + + + + + + + + +

ContinuousServiceStructure

[a special form of SERVICE JOURNEY in TMv6] a vehicle movement on a continuous, non-timetabled service.

The element contains a sequence of the following elements:

Then, the element contains one of the following elements:

a

ContinuousMode

-1:1

ContinuousModes

Continuous transport options.

b

IndividualMode

-1:1

IndividualModes

Individual transport options.

Then, the element contains one of the following elements:

DatedJourney

a

→‍OperatingDayRef

1:1

→‍OperatingDayRef

Reference to an Operating Day

a

→‍siri:VehicleRef

0:1

→‍siri:VehicleRef

ScheduledJourney

a

→‍JourneyRef

1:1

→‍JourneyRef

Reference to a Journey

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, f.e. "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

→‍OperatorRef

0:1

→‍OperatorRef

Reference to an Operator ([TMv6] company providing public transport services.) Reference to transport operatorIdentifier of the operator of the sharing service

a

RouteDescription

0:1

+InternationalText

Descriptive text for a route, f.e. "Airport via City Centre"

a

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public.

a

Attribute

0:*

+GeneralAttribute

Note or service attribute.

b

SharingService

-0:1

+SharingService

ServiceOrigin

OriginStopPointRef

0:1

siri:StopPointRefStructure

First stop of the vehicle journey; origin stop point.

OriginText

1:1

+InternationalText

Label for first stop.

ServiceDestination

DestinationStopPointRef

0:1

siri:StopPointRefStructure

Last stop of vehicle journey; destination stop point.

DestinationText

1:1

+InternationalText

Label for last stop.

BookingArrangements

0:1

+BookingArrangementsContainer

Container with information on booking possibilities for this service.

→‍SituationFullRef

0:*

→‍SituationFullRef

Reference to situation message. Message details might be found in response context or through other communication channels.

Extension

0:1

xs:anyType

11.23. 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.

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.

11.24. 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

TripPlace

-1:1

+TripPlace

Place 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 place is required.

b

TimeAllowance

-0:1

xs:duration

Extra time needed before reaching/after leaving this place.

IndividualTransportOptions

0:*

+IndividualTransportOptions

Options how to access/leave the place by individual transport.

11.25. 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

1:1

xs:nonNegativeInteger

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

NumberOfResultsAfter

1:1

xs:nonNegativeInteger

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

11.26. The BaseTripPolicyGroup group

+ + + + + + +

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

1:1

xs:nonNegativeInteger

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

a

NumberOfResultsAfter

1: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.

IgnoreRealtimeData

0:1

xs:boolean

The trip calculation should not use any realtime or incident data.

ImmediateTripStart

0:1

xs:boolean

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

11.27. The BaseTripMobilityFilterGroup group

+ + + + + + +

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 climb one step.

NoStairs

0:1

xs:boolean

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

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 an ramp.

NoSight

0:1

xs:boolean

The user is not able to see.

11.28. The BaseTripContentFilterGroup group

+ + + + + + +

BaseTripContentFilterGroup

Parameters to control the level of detail of both public and individual transport journey results.

BaseTripContentFilter

IncludeTrackSections

0:1

xs:boolean

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

IncludeLegProjection

0:1

xs:boolean

Whether the result should include the geographic projection (coordinates) of each journey leg.

IncludeTurnDescription

0:1

xs:boolean

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

IncludeAccessibility

0:1

xs:boolean

Whether the result should include accessibility information.

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

11.29. 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.

11.30. 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

LINK PROJECTION on the infrastructure network of the trip leg section together with time information.

11.31. The complex type TrackSectionStructure

TrackSectionStructure

LINK PROJECTION on the infrastructure network of the TRIP LEG together with time information

The element contains a sequence of the following elements:

TrackStart

0:1

+PlaceRef

Start place of this track.

TrackEnd

0:1

+PlaceRef

End place of this track.

LinkProjection

0:1

+LinkProjection

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.

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. OJP/OJP_Availability.xsd - Request and response definitions for availability of tickets and services on a journey leg.

12.1. Simple type definitions

AvailabilityProblemTypeEnumeration

AVAILIBILITY_NOSERIVCEFOUND | 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.

12.2. The AvailabilityRequestGroup group

+ + + + + + + +

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.

MinMaxTimeBand

EarliestDepartureTime

0:1

xs:dateTime

LatestArrivalTime

0:1

xs:dateTime

AvailabilityRequest

Extension

0:1

xs:anyType

12.3. The complex type BookingPTLegStructure

+ + + + + + + + + + +

BookingPTLegStructure

Journey leg by public transport.

The element contains a sequence of the following elements:

PickUpLocation

1:1

+ProvisionedCallAtPlace

Location where passenger intends to enter the service.

SetDownLocation

1:1

+ProvisionedCallAtPlace

Location where passenger intends to leave the service.

→‍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, f.e. "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.

→‍OperatorRef

0:1

→‍OperatorRef

Reference to an Operator ([TMv6] company providing public transport services.) Reference to transport operatorIdentifier of the operator of the sharing service

RouteDescription

0:1

+InternationalText

Descriptive text for a route, f.e. "Airport via City Centre"

Via

0:*

+ServiceViaPoint

Via points of the service that may help identify the vehicle to the public.

Attribute

0:*

+GeneralAttribute

Note or service attribute.

Extension

0:1

xs:anyType

12.4. The complex type BookingUserStructure

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +

BookingUserStructure

Passenger(s) for whom the service needs to be booked.

The element contains a sequence of the following elements:

Age

0:1

xs:nonNegativeInteger

Age of the passenger on the day of travel.

PassengerProfile

WheelchairUser

0:1

xs:boolean

Passenger uses a wheelchair. Default is FALSE.

WalkingFrame

0:1

xs:boolean

Passenger uses a walking frame. Default is FALSE.

WalkingStick

0:1

xs:boolean

Passenger uses a walking stick. Default is FALSE.

WalkingImpaired

0:1

xs:boolean

Passenger is (maybe temporarily) walking impaired. Default is FALSE.

Pram

0:1

xs:boolean

Passenger has a pram with him/her. Default is FALSE.

HeavyLuggage

0:1

xs:boolean

Passenger has got heavy luggage. Default is FALSE.

VisuallyImpaired

0:1

xs:boolean

Passenger is visually impaired.

HearingImpaired

0:1

xs:boolean

Passenger is hearing impaired.

ReadingImpaired

0:1

xs:boolean

Passenger is reading impaired.

BaseTripMobilityFilter

NoSingleStep

0:1

xs:boolean

The user is not able to climb one step.

NoStairs

0:1

xs:boolean

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

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 an ramp.

NoSight

0:1

xs:boolean

The user is not able to see.

TripMobilityFilter

LevelEntrance

0:1

xs:boolean

The user needs vehicles with level entrance between platform and vehicle, f.e. for wheelchair access.

BikeTransport

0:1

xs:boolean

The user wants to carry a bike on public transport.

WalkSpeed

0:1

OpenPercent

Deviation from average walk 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).

DriverAssistance

BoardingAssistance

0:1

xs:boolean

Whether assistance is required for boarding. Could be offered by the driver or station staff. Default is FALSE.

AlightingAssistance

0:1

xs:boolean

Whether assistance is required for alighting. Could be offered by the driver or station staff. Default is FALSE.

12.5. The complex type ProvisionedCallAtPlaceStructure

+ + + + + + + + + +

ProvisionedCallAtPlaceStructure

Provisioned vehicle call at a general location.

The element contains a sequence of the following elements:

DatedJourneyRef

→‍JourneyRef

1:1

→‍JourneyRef

Reference to a Journey

→‍OperatingDayRef

1:1

→‍OperatingDayRef

Reference to an Operating Day

CallPlace

1:1

+PlaceRef

More general location for a call than stop points. May be used with flexible services or "Area Dial-A-Ride".

ServiceArrival

0:1

+ServiceArrival

Arrival times of the service at this stop.

ServiceDeparture

0:1

+ServiceDeparture

Departure times of the service at this stop.

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.

12.6. The MinMaxTimeBandGroup group

+ + +

MinMaxTimeBandGroup

Earliest possible departure time from a start location and latest possible arrival at a different destination location.

MinMaxTimeBand

EarliestDepartureTime

0:1

xs:dateTime

LatestArrivalTime

0:1

xs:dateTime

12.7. The PassengerProfileGroup group

+ + + + + + + + + +

PassengerProfileGroup

Profile of the passenger's abilities.

PassengerProfile

WheelchairUser

0:1

xs:boolean

Passenger uses a wheelchair. Default is FALSE.

WalkingFrame

0:1

xs:boolean

Passenger uses a walking frame. Default is FALSE.

WalkingStick

0:1

xs:boolean

Passenger uses a walking stick. Default is FALSE.

WalkingImpaired

0:1

xs:boolean

Passenger is (maybe temporarily) walking impaired. Default is FALSE.

Pram

0:1

xs:boolean

Passenger has a pram with him/her. Default is FALSE.

HeavyLuggage

0:1

xs:boolean

Passenger has got heavy luggage. Default is FALSE.

VisuallyImpaired

0:1

xs:boolean

Passenger is visually impaired.

HearingImpaired

0:1

xs:boolean

Passenger is hearing impaired.

ReadingImpaired

0:1

xs:boolean

Passenger is reading impaired.

12.8. The PassengerRequirementsGroup group

+ + + + + + + + + + + + + + + + + + +

PassengerRequirementsGroup

Description of passenger's accessibility requirements

BaseTripMobilityFilter

NoSingleStep

0:1

xs:boolean

The user is not able to climb one step.

NoStairs

0:1

xs:boolean

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

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 an ramp.

NoSight

0:1

xs:boolean

The user is not able to see.

TripMobilityFilter

LevelEntrance

0:1

xs:boolean

The user needs vehicles with level entrance between platform and vehicle, f.e. for wheelchair access.

BikeTransport

0:1

xs:boolean

The user wants to carry a bike on public transport.

WalkSpeed

0:1

OpenPercent

Deviation from average walk 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).

DriverAssistance

BoardingAssistance

0:1

xs:boolean

Whether assistance is required for boarding. Could be offered by the driver or station staff. Default is FALSE.

AlightingAssistance

0:1

xs:boolean

Whether assistance is required for alighting. Could be offered by the driver or station staff. Default is FALSE.

12.9. The DriverAssistanceGroup group

+ + +

DriverAssistanceGroup

Requirements for the driver/staff to assist the passenger when boarding/alighting.

DriverAssistance

BoardingAssistance

0:1

xs:boolean

Whether assistance is required for boarding. Could be offered by the driver or station staff. Default is FALSE.

AlightingAssistance

0:1

xs:boolean

Whether assistance is required for alighting. Could be offered by the driver or station staff. Default is FALSE.

12.10. The AvailabilityResponseGroup group

+ + +

AvailabilityResponseGroup

Availability response.

AvailabilityResponse

AvailabilityResult

0:1

+AvailabilityResult

Indication of the availability of the requested service.

Extension

0:1

xs:anyType

12.11. The complex type AvailabilityResultStructure

+ + + + +

AvailabilityResultStructure

Availability result structure.

The element contains a sequence of the following elements:

Problem

0:*

+AvailabilityProblem

Problems related to this AVAILABILITY result.

b

PublicTransport

-1:1

+BookingPTLeg

Definition of the journey leg that should be made by public transport. Other mobility services may be added later.

BookableTicketAndServiceInformation

BookableTicket

0:*

+FareProduct

Sequence of bookable tickets or surcharges for this part of the trip. If ticket price is zero: an already purchased/virtual ticket of this type presented to the driver would be accepted.

BookableServiceItem

0:*

+BookableServiceItem

Sequence of bookable service items for this part of the trip.

Extension

0:1

xs:anyType

12.12. The BookableTicketAndServiceInformationGroup group

+ + +

BookableTicketAndServiceInformationGroup

Lists those tickets or surcharges and service characteristics such as the transportation of wheelchairs, prams, luggage etc. or the provision of required child seats or booster seats that are offered in the trips transport company to be booked for the trip.

BookableTicketAndServiceInformation

BookableTicket

0:*

+FareProduct

Sequence of bookable tickets or surcharges for this part of the trip. If ticket price is zero: an already purchased/virtual ticket of this type presented to the driver would be accepted.

BookableServiceItem

0:*

+BookableServiceItem

Sequence of bookable service items for this part of the trip.

12.13. The complex type BookableServiceItemStructure

BookableServiceItemStructure

Possible service items that can be booked in the actual booking system (defined by the traffic company of charge). Only those elements with value greater 0 are bookable. The indicated capacity corresponds to the maximum number that can be booked in one booking. This number does not have to be available for the specific booking and may result in booking failure. Caution: list can vary widely from one traffic company to another.

The element contains a sequence of the following elements:

Type

1:1

BookableServiceItemType

The type of bookable service.

MaxBookableCapacity

1:1

xs:nonNegativeInteger

Maximum number of service items that can be booked in one booking transaction. Default is 0.

12.14. The complex type AvailabilityProblemStructure

AvailabilityProblemStructure

Problem that may be returned in responses to AVAILABILITY requests.

The element contains a sequence of the following elements:

Type

1:1

AvailabilityProblemType

Type of the AVAILABILITY problem.

ProblemDetail

Title

0:1

+InternationalText

Title of the problem.

Details

0:1

+InternationalText

Explanation of the problem.

LogData

0:1

xs:string

Additional log data.

-

16. OJP/OJP_Utility.xsd - Support definitions not specifically related to the public transport domain

16.1. Simple type definitions

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

16.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.

16.3. The WebLinkGroup group

+

13. OJP/OJP_Common.xsd - Supporting definitions of common structures

13.1. Simple type definitions

WebLinkGroup

URL of a web resource including type of resource.

JourneyCodeType

xs:NMTOKEN

Identifier of a Journey

OperatingDayCodeType

xs:NMTOKEN

Identifier of an Operating Day

OwnerCodeType

xs:NMTOKEN

identifier of ORGANISATION with ownership as the RESPONSIBILITY ROLE

ProductCategoryCodeType

xs:NMTOKEN

Type for identifier of an product category code.

SharingModelEnumeration

singleStationBased | multipleStationBased | nonStationBased

Sharing service loan and return scheme.

WeekdayTypeEnumeration

Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday | PublicHoliday

[a specialisation of DAY OF WEEK in TMv6] enumeration of individual the seven DAYs OF WEEK, along with public holidays

13.2. The ProblemDetailGroup group

+ + + +

ProblemDetailGroup

Detailed description of the problem.

ProblemDetail

Title

0:1

+InternationalText

Title of the problem.

Details

0:1

+InternationalText

Explanation of the problem.

LogData

0:1

xs:string

Additional log data.

13.3. 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.

13.4. The complex type LinkProjectionStructure

LinkProjectionStructure

An oriented correspondence from one LINK of a source layer, onto an entity in a target layer: e.g. LINK SEQUENCE.

The element contains only one element:

Position

2:*

siri:LocationStructure

Ordered list of locations representing the geogemtry of the link.

13.5. 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.

13.6. 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))

13.7. The toplevel element OperatorRef

OperatorRef

siri:OperatorRefStructure

Reference to an Operator ([TMv6] company providing public transport services.)

13.8. 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

13.9. The complex type ProductCategoryRefStructure

ProductCategoryRefStructure

ProductCategoryCode

Reference to a product category. 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, e.g. to identify boats that run with steam in Switzerland ("BAV")

13.10. 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)

13.11. 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 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.

13.12. The complex type JourneyRefStructure

JourneyRefStructure

JourneyCode

Reference to a Journey

13.13. The toplevel element JourneyRef

JourneyRef

+JourneyRef

Reference to a Journey

13.14. 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

13.15. The TimedVehicleRefGroup group

+ + +

TimedVehicleRefGroup

Reference to a vehicle for a specific point in time.

TimedVehicleRef

→‍siri:VehicleRef

1:1

→‍siri:VehicleRef

TimeOfOperation

1:1

xs:dateTime

Time stamp when the vehicle is operating. In most use cases equal to "now".

13.16. The complex type VehicleFilterStructure

VehicleFilterStructure

Filter for Vehicles

The element contains a sequence of the following elements:

Exclude

0:1

xs:boolean

Whether to include or exclude given VehicleRefs and TRAIN NUMBERS in the list from the search. Default is exclude.

VehicleRef

0:*

siri:VehicleRefStructure

Reference to VEHICLE

TrainNumber

0:*

xs:normalizedString

TRAIN NUMBERs

13.17. The SharingServiceUsageGroup group

+ + +

SharingServiceUsageGroup

Usage parameters of a sharing service.

SharingServiceUsage

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.

13.18. The complex type SharingServiceStructure

+ + +

SharingServiceStructure

Service that provides shared vehicles.

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.

SharingModel

0:1

SharingModel

Type of the sharing scheme.

SharingServiceUsage

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 web page providing more details on service.

13.19. The complex type OwnerRefStructure

OwnerRefStructure

OwnerCode

Reference to an ORGANISATION with ownership as the RESPONSIBILITY ROLE

13.20. The toplevel element OwnerRef

OwnerRef

+OwnerRef

Reference to an ORGANISATION with ownership as the RESPONSIBILITY ROLE

13.21. The complex type OperatingDayRefStructure

OperatingDayRefStructure

OperatingDayCode

Reference to an Operating Day

13.22. The toplevel element OperatingDayRef

OperatingDayRef

+OperatingDayRef

Reference to an Operating Day

13.23. 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.

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.

13.24. 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".

13.25. 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.

13.26. 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:

Text

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.

→‍siri:AllFacilitiesGroup

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.

+

14. OJP/OJP_FacilitySupport.xsd - Supporting definitions for facilities containing wrappers for SIRI

14.1. The AllFacilitiesGroup group

+ +

AllFacilitiesGroup

Wrapper for SIRI facilities.

→‍siri:AllFacilitiesGroup

14.2. The StopFacilityGroup group

+ +

StopFacilityGroup

Wrapper for SIRI stop facilities.

→‍siri:StopFacilityGroup

14.3. The ServiceFacilityGroup group

+ +

ServiceFacilityGroup

Wrapper for SIRI service facilities.

→‍siri:ServiceFacilityGroup

+

15. OJP/OJP_ModesSupport.xsd - Supporting definitions for the classification of modes of transport

15.1. Simple type definitions

ContinuousModesEnumeration

walk | demandResponsive | replacementService

Types of cmodes that run at any time without a timetable.

IndividualModesEnumeration

walk | cycle | taxi | self-drive-car | others-drive-car | motorcycle | truck | scooter | ride-pool-car | car-sharing | cycle-sharing | scooter-sharing

modes which an individual powers themselves (such as walk, cycle)

PrivateModesEnumeration

carPooling

[a category of MODE in TMv6] MODEs offered by private individuals

TransferModesEnumeration

walk | parkAndRide | bikeAndRide | carHire | bikeHire | protectedConnection | guaranteedConnection | remainInVehicle | changeWithinVehicle | checkIn | checkOut

MODEs dedicated to peform TRANSFERs

15.2. The complex type IndividualTransportOptionsStructure

IndividualTransportOptionsStructure

Individual modes and their usage limits as stated by the passenger

The element contains a sequence of the following elements:

Mode

1:1

IndividualModes

Mode of individual transport. When mode self-drive-car is used the connection to another mode will need a parking space for the car. Thus, this mode is a generalisation of all park and ride use cases. The mode others-drive-car, however, only needs a place to let a person be set down from a car.

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.

15.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 mode

→‍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.

15.4. The ModeGroup group

+ + +

ModeGroup

Elements for a Transport Mode

Mode

PtMode

1:1

siri:VehicleModesOfTransportEnumeration

Categorisation of mode

→‍siri:PtModeChoiceGroup

15.5. The complex type PtModeFilterStructure

PtModeFilterStructure

List of public transport modes ([from SIRI] mode of public transport service, corresponds to VEHICLE MODE) to exclude or include.

The element contains a sequence of the following elements:

Exclude

0:1

xs:boolean

Whether VEHICLE 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.

→‍siri:PtModeChoiceGroup

15.6. The complex type PrivateModeFilterStructure

PrivateModeFilterStructure

List of private mobility offers to include or exclude.

The element contains a sequence of the following elements:

Exclude

0:1

xs:boolean

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

PrivateMode

0:*

PrivateModes

List of private mobility offers to include/exclude.

+

16. OJP/OJP_SituationSupport.xsd - Supporting definitions for situations containing wrappers for SIRI Situation Exchange service (SIRI SX)

16.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.

RoadSituation

0:*

siri:RoadSituationElementStructure

16.2. The toplevel element SituationFullRef

SituationFullRef

+SituationFullRef

Reference to situation message. Message details might be found in response context or through other communication channels.

16.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. OJP/OJP_Utility.xsd - Support definitions not specifically related to the public transport domain

17.1. Simple type definitions

EMailAddressType

xs:normalizedString

Type definition for e-mail 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

17.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.

17.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.

16.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.

17.4. The complex type WebLinkStructure

diff --git a/docs/schema-collection.xml b/docs/schema-collection.xml index 197ab377b..c6829f989 100644 --- a/docs/schema-collection.xml +++ b/docs/schema-collection.xml @@ -1,19 +1,23 @@ + - - + + - - - - - + + + + + + diff --git a/examples/function/OJPAvailabilityRequest.xml b/examples/function/OJPAvailabilityRequest.xml new file mode 100644 index 000000000..bcb2cb1af --- /dev/null +++ b/examples/function/OJPAvailabilityRequest.xml @@ -0,0 +1,70 @@ + + + + + 2020-01-19T12:00:00Z + MyClient + + 2020-01-19T12:00:00Z + 231231-231 + + + + ch:1:sloid:7000 + + origin + + + 7 + + + + + 20.12121 + 30.134123 + 20 + + + destiniation + + sbb + + + 2022-10-19T12:00:00Z + 2022-10-19T11:55:00Z + 2022-10-19T12:10:00Z + + 10 + true + false + false + + ch:1:slnid:102301231 + + bus + demandAndResponseBus + + + NB + + + NB 1 + + 1293912-1231 + ch:1:sboid:13123 + + + 19 + true + true + true + true + 70 + PT2M + + 2022-10-19T11:30:00Z + 2022-10-19T12:10:00Z + + + + diff --git a/examples/function/OJPAvailabilityRequest_1.xml b/examples/function/OJPAvailabilityRequest_1.xml new file mode 100644 index 000000000..5c48f06a4 --- /dev/null +++ b/examples/function/OJPAvailabilityRequest_1.xml @@ -0,0 +1,29 @@ + + + 2022-12-12T11:46:00Z + + + + de:05766:2317:0:1 + + Kt-Kalldorf, Winterberg + + + + 2022-12-12T11:46:00Z + + + + + de:05766:3437:0:2 + + Kt-Stemmen, Elfenborner Weg + + + + 2022-12-12T12:02:00Z + + + + + diff --git a/examples/function/OJPAvailabilityRequest_2.xml b/examples/function/OJPAvailabilityRequest_2.xml new file mode 100644 index 000000000..8c204435d --- /dev/null +++ b/examples/function/OJPAvailabilityRequest_2.xml @@ -0,0 +1,29 @@ + + + 2022-12-12T11:46:00Z + + + + de:05766:2317:0:1 + + Kt-Kalldorf, Winterberg + + + + 2022-12-14T09:46:00Z + + + + + de:05766:3437:0:2 + + Kt-Stemmen, Elfenborner Weg + + + + 2022-12-14T10:02:00Z + + + + + diff --git a/examples/function/OJPAvailabilityResponse notOK.xml b/examples/function/OJPAvailabilityResponse notOK.xml new file mode 100644 index 000000000..b1b4cab06 --- /dev/null +++ b/examples/function/OJPAvailabilityResponse notOK.xml @@ -0,0 +1,10 @@ + + + 2001-12-17T09:30:47Z + false + + + Anfrage konnte nicht verarbeitet werden + + + diff --git a/examples/function/OJPAvailabilityResponse_OK.xml b/examples/function/OJPAvailabilityResponse_OK.xml new file mode 100644 index 000000000..c926b370f --- /dev/null +++ b/examples/function/OJPAvailabilityResponse_OK.xml @@ -0,0 +1,27 @@ + + + 2001-12-17T09:30:47Z + + + + + de:05766:2317 + + Winterberg/Kalldorf + + + + + + de:05766:3437 + + Elfenborner Weg/Stemmen (Kalletal) + + + + 2022-12-14T11:02:00+01:00 + + + + + From fe7b49d36ff61dae73a872e63a4b18a6b8396ec1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Matthias=20G=C3=BCnter?= Date: Wed, 18 Jan 2023 09:15:04 +0100 Subject: [PATCH 2/3] Rename FareProductCode to FareProductId (#267) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Stephan Großberndt --- OJP/OJP_FareSupport.xsd | 12 ++++++------ docs/generated/index.html | 6 +++--- 2 files changed, 9 insertions(+), 9 deletions(-) diff --git a/OJP/OJP_FareSupport.xsd b/OJP/OJP_FareSupport.xsd index 505e6e080..db8c2b86f 100644 --- a/OJP/OJP_FareSupport.xsd +++ b/OJP/OJP_FareSupport.xsd @@ -186,7 +186,7 @@ ========================================== Tickets ========================================== - + Identifier of a FareProduct @@ -197,7 +197,7 @@ Reference to a FareProduct. - + @@ -255,20 +255,20 @@ [related to FARE PRODUCT in TM and NeTEx] different FARE PRODUCTs that may be available with related information - + - Unique Id of the FareProduct. + Identifier of a FareProduct - printable FareProduct name + Printable FareProduct name - 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 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/ diff --git a/docs/generated/index.html b/docs/generated/index.html index d6b2d16d5..678b0a613 100644 --- a/docs/generated/index.html +++ b/docs/generated/index.html @@ -321,16 +321,16 @@

OJP - Open API for distributed Journey

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.

FareResponse

FareResponseContext

0:1

+ResponseContext

Context to hold trip response objects that occur frequently.

FareResult

0:*

+FareResult

Fare result choice element.

4.7. The complex type FareResultStructure

FareResultStructure

Wrapper element for Fare results.

The element contains a sequence of the following elements:

ResultId

1:1

xs:NMTOKEN

ID of this result.

Problem

0:*

+FareProblem

Problems related to this FARE result.

Then, the element contains one of the following elements:

a

MultiTripFareResult

-1:*

+MultiTripFareResult

Fare and FareProducts for multiple trips.

b

StaticFareResult

-1:1

+StaticFareResult

Static Fare information.

c

StopFareResult

-1:1

+StopFareResult

Stop-related Fare information.

d

TripFareResult

-1:*

+TripFareResult

Fare and FareProducts for a given trip.

4.8. 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.9. 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.10. 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

xs:NMTOKEN

Identifies the "valid from" trip.

FromTripLegIdRef

0:1

xs:NMTOKEN

Identifies the "valid from" tripLeg. If missing, then valid from the first leg.

ToTripIdRef

1:1

xs:NMTOKEN

Identifies the "valid to" trip.

ToTripLegIdRef

0:1

xs:NMTOKEN

Identifies the "valid to" tripLeg. If missing, then valid to the last leg.

4.11. 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

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.

FareProductCodeType

xs:NMTOKEN

Identifier of a FareProduct

PassengerCategoryEnumeration

Adult | Child | Senior | Youth | Disabled

[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.

Percentage

xs:decimal

A percentage value between 0 and 100

TariffZoneCodeType

xs:NMTOKEN

Identifier of a fare zone.

TypeOfFareClassEnumeration

all | first | second | third | business | economy

classes of travel available on a particular service which will affect the price to be paid

5.2. 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.3. The toplevel element FareAuthorityRef

FareAuthorityRef

+FareAuthorityRef

Reference to a Fare Authority.

5.4. The FareAuthorityGroup group

+

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

5.1. Simple type definitions

FareAuthorityGroup

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

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

PassengerCategoryEnumeration

Adult | Child | Senior | Youth | Disabled

[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.

Percentage

xs:decimal

A percentage value between 0 and 100

TariffZoneCodeType

xs:NMTOKEN

Identifier of a fare zone.

TypeOfFareClassEnumeration

all | first | second | third | business | economy

classes of travel available on a particular service which will affect the price to be paid

5.2. 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.3. The toplevel element FareAuthorityRef

FareAuthorityRef

+FareAuthorityRef

Reference to a Fare Authority.

5.4. 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.5. The complex type TariffZoneRefStructure

TariffZoneRefStructure

Reference to a fare zone.

5.6. The toplevel element TariffZoneRef

TariffZoneRef

+TariffZoneRef

Reference to a fare zone.

5.7. 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.8. The complex type TariffZoneListInAreaStructure

-

TariffZoneListInAreaStructure

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

The element contains a sequence of the following elements:

FareAuthority

→‍FareAuthorityRef

1:1

→‍FareAuthorityRef

Reference to a Fare Authority.

FareAuthorityText

1:1

xs:string

Textual description or name of Fare authority.

TariffZone

1:*

+TariffZone

Fare zone in area.

5.9. The complex type TariffZoneRefListStructure

TariffZoneRefListStructure

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

The element contains a sequence of the following elements:

→‍FareAuthorityRef

1:1

→‍FareAuthorityRef

Reference to a Fare Authority.

→‍TariffZoneRef

1:*

→‍TariffZoneRef

Reference to a fare zone.

5.10. The complex type BookingArrangementStructure

BookingArrangementStructure

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

The element contains a sequence of the following elements:

BookingAgencyName

0:1

+InternationalText

Name of the booking agency (contractual partner).

BookingUrl

0:1

+WebLink

URL to online booking service.

InfoUrl

0:1

+WebLink

URL to information page.

PhoneNumber

0:1

PhoneNumber

Phone number for booking.

MinimumBookingPeriod

0:1

xs:duration

Minimum duration bookings must be completed before trip starts.

Extension

0:1

xs:anyType

5.11. The complex type BookingArrangementsContainerStructure

BookingArrangementsContainerStructure

Container for multiple booking arrangements.

The element contains a sequence of the following elements:

BookingArrangement

1:*

+BookingArrangement

[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.12. The complex type FareProductRefStructure

FareProductRefStructure

FareProductCode

Reference to a FareProduct.

5.13. The toplevel element FareProductRef

FareProductRef

+FareProductRef

Reference to a FareProduct.

5.14. 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.15. 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.16. 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

FareProductCode

Unique Id of the FareProduct.

FareProductName

1:1

xs:string

printable FareProduct name

TariffZone

1:*

+TariffZone

Fare zone in area.

5.9. The complex type TariffZoneRefListStructure

TariffZoneRefListStructure

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

The element contains a sequence of the following elements:

→‍FareAuthorityRef

1:1

→‍FareAuthorityRef

Reference to a Fare Authority.

→‍TariffZoneRef

1:*

→‍TariffZoneRef

Reference to a fare zone.

5.10. The complex type BookingArrangementStructure

BookingArrangementStructure

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

The element contains a sequence of the following elements:

BookingAgencyName

0:1

+InternationalText

Name of the booking agency (contractual partner).

BookingUrl

0:1

+WebLink

URL to online booking service.

InfoUrl

0:1

+WebLink

URL to information page.

PhoneNumber

0:1

PhoneNumber

Phone number for booking.

MinimumBookingPeriod

0:1

xs:duration

Minimum duration bookings must be completed before trip starts.

Extension

0:1

xs:anyType

5.11. The complex type BookingArrangementsContainerStructure

BookingArrangementsContainerStructure

Container for multiple booking arrangements.

The element contains a sequence of the following elements:

BookingArrangement

1:*

+BookingArrangement

[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.12. The complex type FareProductRefStructure

FareProductRefStructure

FareProductId

Reference to a FareProduct.

5.13. The toplevel element FareProductRef

FareProductRef

+FareProductRef

Reference to a FareProduct.

5.14. 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.15. 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.16. The complex type FareProductStructure

- + From 0e21b03ac26402f3c512a389659e6cb8e90b860d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Matthias=20G=C3=BCnter?= Date: Thu, 19 Jan 2023 12:20:59 +0100 Subject: [PATCH 3/3] LineInformation Request and Response service (#243) Co-authored-by: Stefan de Konink --- OJP/OJP_All.xsd | 1 + OJP/OJP_Common.xsd | 6 +- OJP/OJP_JourneySupport.xsd | 2 +- OJP/OJP_Lines.xsd | 50 +++++ OJP/OJP_Requests.xsd | 26 +++ docs/generated/index.html | 274 +++++++++++++++------------- docs/schema-collection.xml | 1 + examples/functions/LineRequest.xml | 20 ++ examples/functions/LineResponse.xml | 45 +++++ 9 files changed, 291 insertions(+), 134 deletions(-) create mode 100644 OJP/OJP_Lines.xsd create mode 100644 examples/functions/LineRequest.xml create mode 100644 examples/functions/LineResponse.xml diff --git a/OJP/OJP_All.xsd b/OJP/OJP_All.xsd index 879d7f59a..cf90d124d 100644 --- a/OJP/OJP_All.xsd +++ b/OJP/OJP_All.xsd @@ -9,6 +9,7 @@ + diff --git a/OJP/OJP_Common.xsd b/OJP/OJP_Common.xsd index 187fe0f6a..1cc02494e 100644 --- a/OJP/OJP_Common.xsd +++ b/OJP/OJP_Common.xsd @@ -47,14 +47,14 @@ - + - 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 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. - Ordered list of locations representing the geogemtry of the link. + Ordered list of locations representing the geometry of the link or route. diff --git a/OJP/OJP_JourneySupport.xsd b/OJP/OJP_JourneySupport.xsd index 1da6469fd..2386083ca 100644 --- a/OJP/OJP_JourneySupport.xsd +++ b/OJP/OJP_JourneySupport.xsd @@ -684,7 +684,7 @@ End place of this track. - + 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 new file mode 100644 index 000000000..cceb773a0 --- /dev/null +++ b/OJP/OJP_Lines.xsd @@ -0,0 +1,50 @@ + + + + OJP/OJP_Lines.xsd - Request and response definitions for information on lines + + + + + =============================== Line Information Service ========================================== + + + =============================== Line Information Response Group ========================================== + + + + Line Information response group. + + + + + + + =============================== LineInformation support functions ========================================== + + + + + + Reference to the LINE. + + + + + + DIRECTION of LINE. + + + + + The LINE's route geometry. A line can have multiple ROUTEs and each has its own geometry. The first should be the "main" geometry. + + + + + List of transport modes that are supported by this line. + + + + + diff --git a/OJP/OJP_Requests.xsd b/OJP/OJP_Requests.xsd index a79b4f479..5534e40fe 100644 --- a/OJP/OJP_Requests.xsd +++ b/OJP/OJP_Requests.xsd @@ -247,4 +247,30 @@ + + ========================================== Line Information Service ========================================== + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/generated/index.html b/docs/generated/index.html index 678b0a613..b4353ac37 100644 --- a/docs/generated/index.html +++ b/docs/generated/index.html @@ -58,22 +58,23 @@

OJP - Open API for distributed Journey
  • 1. OJP.xsd - OJP messages as extension of SIRI
  • -
  • 2. OJP/OJP_Requests.xsd - OJP service requests and responses
  • +
  • 2. OJP/OJP_Requests.xsd - OJP service requests and responses
  • 3. OJP/OJP_RequestSupport.xsd - Supporting definitions for OJP service requests and their responses
  • 4. OJP/OJP_Fare.xsd - Request and response definitions for general, stop-specific and trip-specific fare information
  • 5. OJP/OJP_FareSupport.xsd - Supporting definitions for fare information on passenger trips
  • -
  • 6. OJP/OJP_Places.xsd - Request and response definitions for place information
  • -
  • 7. OJP/OJP_PlaceSupport.xsd - Supporting definitions for place information
  • -
  • 8. OJP/OJP_StopEvents.xsd - Request and response definitions for arrivals and departures of public transport services at stops
  • -
  • 9. OJP/OJP_TripInfo.xsd - Request and response definitions for information on a single trip
  • -
  • 10. OJP/OJP_Trips.xsd - Request and response definitions for trip requests and distributed journey planning
  • -
  • 11. OJP/OJP_JourneySupport.xsd - Supporting definitions for journeys on public transport vehicles
  • -
  • 12. OJP/OJP_Availability.xsd - Request and response definitions for availability of tickets and services on a journey leg.
  • -
  • 13. OJP/OJP_Common.xsd - Supporting definitions of common structures
  • -
  • 14. OJP/OJP_FacilitySupport.xsd - Supporting definitions for facilities containing wrappers for SIRI
  • -
  • 15. OJP/OJP_ModesSupport.xsd - Supporting definitions for the classification of modes of transport
  • -
  • 16. OJP/OJP_SituationSupport.xsd - Supporting definitions for situations containing wrappers for SIRI Situation Exchange service (SIRI SX)
  • -
  • 17. OJP/OJP_Utility.xsd - Support definitions not specifically related to the public transport domain
  • +
  • 6. OJP/OJP_Lines.xsd - Request and response definitions for information on lines
  • +
  • 7. OJP/OJP_Places.xsd - Request and response definitions for place information
  • +
  • 8. OJP/OJP_PlaceSupport.xsd - Supporting definitions for place information
  • +
  • 9. OJP/OJP_StopEvents.xsd - Request and response definitions for arrivals and departures of public transport services at stops
  • +
  • 10. OJP/OJP_TripInfo.xsd - Request and response definitions for information on a single trip
  • +
  • 11. OJP/OJP_Trips.xsd - Request and response definitions for trip requests and distributed journey planning
  • +
  • 12. OJP/OJP_JourneySupport.xsd - Supporting definitions for journeys on public transport vehicles
  • +
  • 13. OJP/OJP_Availability.xsd - Request and response definitions for availability of tickets and services on a journey leg.
  • +
  • 14. OJP/OJP_Common.xsd - Supporting definitions of common structures
  • +
  • 15. OJP/OJP_FacilitySupport.xsd - Supporting definitions for facilities containing wrappers for SIRI
  • +
  • 16. OJP/OJP_ModesSupport.xsd - Supporting definitions for the classification of modes of transport
  • +
  • 17. OJP/OJP_SituationSupport.xsd - Supporting definitions for situations containing wrappers for SIRI Situation Exchange service (SIRI SX)
  • +
  • 18. OJP/OJP_Utility.xsd - Support definitions not specifically related to the public transport domain
  • @@ -265,6 +266,16 @@

    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 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

    Extension

    0:1

    xs:anyType

    →‍siri:Extensions

    0:1

    →‍siri:Extensions

    2.37. The toplevel element OJPLineInformationRequest

    OJPLineInformationRequest

    +OJPLineInformationRequest (↔ siri:AbstractFunctionalServiceRequest)

    2.38. The complex type OJPLineInformationRequestStructure

    + + + +

    OJPLineInformationRequestStructure

    +AbstractOJPServiceRequest

    The element contains a sequence of the following elements:

    LineDirectionFilter

    0:1

    +LineDirectionFilter

    →‍siri:Extensions

    0:1

    →‍siri:Extensions

    2.39. The toplevel element OJPLineInformationDelivery

    OJPLineInformationDelivery

    +OJPLineInformationDelivery (↔ siri:AbstractFunctionalServiceDelivery)

    2.40. The complex type OJPLineInformationDeliveryStructure

    + + + + +

    OJPLineInformationDeliveryStructure

    siri:AbstractServiceDeliveryStructure

    The element contains a sequence of the following elements:

    →‍OJPLineInformationRequest

    0:1

    →‍OJPLineInformationRequest

    LineInformationResponse

    LineResult

    0:*

    +LineResult

    →‍siri:Extensions

    0:1

    →‍siri:Extensions

    3. OJP/OJP_RequestSupport.xsd - Supporting definitions for OJP service requests and their responses

    3.1. Simple type definitions

    CalcTimeType

    xs:integer

    Type definition for calculation time in milliseconds.

    CertificateIdType

    xs:NMTOKEN

    Type definition for the form of identification that can be used as a Message Integrity Property (public key cryptography)

    OJPGenericProblemTypeEnumeration

    OJPGENERIC_REQUESTNOTSUPPORTED | OJPGENERIC_FEATURENOTSUPPORTED | OJPGENERIC_LANGUAGENOTSUPPORTED | OJPGENERIC_EXCEPTIONFROMREQUESTEDLANGUAGE | OJPGENERIC_DATAFRAMEREFNOTAVAILABLE | OJPGENERIC_OTHER

    Types of problems that may be returned in case of generic problems with the request.

    SignatureType

    xs:string

    data for transmission of message signatures (public key cryptography), used to prove Message Integrity

    3.2. The MessageIntegrityPropertiesGroup group

    @@ -383,14 +394,17 @@

    OJP - Open API for distributed Journey

    MessageIntegrityPropertiesGroup

    Properties that allow checks for message integrity.

    MessageIntegrityProperties

    Signature

    0:1

    Signature

    Authorisation signature (data for transmission of message signatures (public key cryptography), used to prove Message Integrity).

    Details

    0:1

    +InternationalText

    Explanation of the problem.

    LogData

    0:1

    xs:string

    Additional log data.

    -

    6. OJP/OJP_Places.xsd - Request and response definitions for place information

    6.1. Simple type definitions

    PlaceTypeEnumeration

    stop | address | poi | coord | location | topographicPlace

    PlaceUsageEnumeration

    origin | via | destination

    6.2. The PlaceInformationRequestGroup group

    +

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

    6.1. The LineInformationResponseGroup group

    PlaceInformationRequestGroup

    + +

    LineInformationResponseGroup

    Line Information response group.

    LineInformationResponse

    LineResult

    0:*

    +LineResult

    6.2. The complex type LineResultStructure

    LineResultStructure

    The element contains a sequence of the following elements:

    LineRef

    1:1

    siri:LineRefStructure

    Reference to the LINE.

    →‍siri:PublishedLineName

    0:1

    →‍siri:PublishedLineName

    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.

    Mode

    0:*

    +Mode

    List of transport modes that are supported by this line.

    +

    7. OJP/OJP_Places.xsd - Request and response definitions for place information

    7.1. Simple type definitions

    PlaceTypeEnumeration

    stop | address | poi | coord | location | topographicPlace

    PlaceUsageEnumeration

    origin | via | destination

    7.2. The PlaceInformationRequestGroup group

    -

    PlaceInformationRequestGroup

    The element contains one of the following elements:

    PlaceInformationRequest

    a

    InitialInput

    -1:1

    +InitialPlaceInput

    Initial input for the place information request. This input defines what is originally looked for.

    b

    PlaceRef

    -1:1

    +PlaceRef

    Place for further refinement. If a place in a previous response was marked as not "complete" it can be refined by putting it here.

    Restrictions

    0:1

    +PlaceParam

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

    6.3. The PlaceInformationResponseGroup group

    +

    PlaceInformationResponseGroup

    7.3. The PlaceInformationResponseGroup group

    -

    PlaceInformationResponseGroup

    PlaceInformationResponse

    PlaceInformationResponseContext

    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

    6.4. The complex type InitialPlaceInputStructure

    InitialPlaceInputStructure

    The element contains a sequence of the following elements:

    Name

    0:1

    xs:string

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

    GeoPosition

    0:1

    siri:LocationStructure

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

    GeoRestriction

    0:1

    +GeoRestrictions

    Restricts the resulting place objects to the given geographical area.

    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/

    6.5. The complex type PlaceParamStructure

    +

    PlaceParamStructure

    The element contains a sequence of the following elements:

    7.4. The complex type InitialPlaceInputStructure

    InitialPlaceInputStructure

    The element contains a sequence of the following elements:

    Name

    0:1

    xs:string

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

    GeoPosition

    0:1

    siri:LocationStructure

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

    GeoRestriction

    0:1

    +GeoRestrictions

    Restricts the resulting place objects to the given geographical area.

    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/

    7.5. The complex type PlaceParamStructure

    @@ -402,28 +416,28 @@

    OJP - Open API for distributed Journey

    -

    PlaceParamStructure

    The element contains a sequence of the following elements:

    PlaceDataFilter

    Type

    0:*

    PlaceType

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

    Usage

    0:1

    PlaceUsage

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

    PtModes

    0:1

    +PtModeFilter

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

    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.

    IncludePtModes

    0:1

    xs:boolean

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

    6.6. The complex type GeoRestrictionsStructure

    GeoRestrictionsStructure

    The element contains one of the following elements:

    a

    Area

    -1:1

    +GeoArea

    Area is defined by a polyline

    b

    Circle

    -1:1

    +GeoCircle

    c

    Rectangle

    -1:1

    +GeoRectangle

    6.7. The complex type GeoCircleStructure

    GeoCircleStructure

    The element contains a sequence of the following elements:

    Center

    1:1

    siri:LocationStructure

    Radius

    1:1

    siri:DistanceType

    Radius in metres.

    6.8. The complex type GeoRectangleStructure

    GeoRectangleStructure

    The element contains a sequence of the following elements:

    UpperLeft

    1:1

    siri:LocationStructure

    LowerRight

    1:1

    siri:LocationStructure

    6.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

    6.10. The complex type PlaceResultStructure

    +

    PlaceResultStructure

    The element contains a sequence of the following elements:

    Problem

    0:*

    +LocationProblem

    Problems related to this LOCATION result.

    Place

    1:1

    +Place

    Complete

    1:1

    xs:boolean

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

    Probability

    0:1

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

    7.6. The complex type GeoRestrictionsStructure

    GeoRestrictionsStructure

    The element contains one of the following elements:

    a

    Area

    -1:1

    +GeoArea

    Area is defined by a polyline

    b

    Circle

    -1:1

    +GeoCircle

    c

    Rectangle

    -1:1

    +GeoRectangle

    7.7. The complex type GeoCircleStructure

    GeoCircleStructure

    The element contains a sequence of the following elements:

    Center

    1:1

    siri:LocationStructure

    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

    LowerRight

    1:1

    siri:LocationStructure

    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

    7.10. The complex type PlaceResultStructure

    -

    PlaceResultStructure

    The element contains a sequence of the following elements:

    Problem

    0:*

    +LocationProblem

    Problems related to this LOCATION result.

    Place

    1:1

    +Place

    Complete

    1:1

    xs:boolean

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

    Probability

    0:1

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

    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.

    6.11. The PlacePolicyGroup group

    +

    PlacePolicyGroup

    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.

    7.11. The PlacePolicyGroup group

    -

    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.

    IncludePtModes

    0:1

    xs:boolean

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

    6.12. The PlaceDataFilterGroup group

    +

    PlaceDataFilterGroup

    7.12. The PlaceDataFilterGroup group

    -

    PlaceDataFilterGroup

    PlaceDataFilter

    Type

    0:*

    PlaceType

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

    Usage

    0:1

    PlaceUsage

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

    PtModes

    0:1

    +PtModeFilter

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

    OperatorFilter

    0:1

    +OperatorFilter

    Filter for places that are operated by certain organisations.

    TopographicPlaceRef

    0:*

    +TopographicPlaceRef

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

    PointOfInterestFilter

    0:1

    +PointOfInterestFilter

    Filter to narrow down POI searches.

    6.13. The ExchangePointsRequestGroup group

    +

    ExchangePointsRequestGroup

    7.13. The ExchangePointsRequestGroup group

    -

    ExchangePointsRequestGroup

    ExchangePointsRequest

    PlaceRef

    0:1

    +PlaceRef

    Place for which exchange points to other "neighbour" systems are to be searched. This place is usually the origin/destination of a passenger journey. May be omitted if all exchange points shall be returned.

    Params

    0:1

    +ExchangePointsParam

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

    6.14. The complex type ExchangePointsParamStructure

    +

    ExchangePointsParamStructure

    The element contains a sequence of the following elements:

    7.14. The complex type ExchangePointsParamStructure

    @@ -435,7 +449,7 @@

    OJP - Open API for distributed Journey

    -

    ExchangePointsParamStructure

    The element contains a sequence of the following elements:

    ExchangePointsDataFilter

    Type

    0:*

    PlaceType

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

    Usage

    0:1

    PlaceUsage

    Defines, whether the place object of this request acts as origin, via or destination point of the passenger journey.

    PtModes

    0:1

    +PtModeFilter

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

    ExchangePointsPolicy

    Language

    0:*

    xs:language

    Preferred language in which to return text values.

    NumberOfResults

    0:1

    xs:positiveInteger

    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.

    6.15. The ExchangePointsDataFilterGroup group

    +

    ExchangePointsDataFilterGroup

    7.15. The ExchangePointsDataFilterGroup group

    @@ -443,22 +457,22 @@

    OJP - Open API for distributed Journey

    -

    ExchangePointsDataFilterGroup

    ExchangePointsDataFilter

    Type

    0:*

    PlaceType

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

    Usage

    0:1

    PlaceUsage

    Defines, whether the place object of this request acts as origin, via or destination point of the passenger journey.

    PtModes

    0:1

    +PtModeFilter

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

    TopographicPlaceRef

    0:*

    +TopographicPlaceRef

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

    DestinationSystem

    0:1

    siri:ParticipantRefStructure

    Reference to system in which the destination (or origin) of the passenger is located.

    AdjacentSystem

    0:*

    siri:ParticipantRefStructure

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

    6.16. The ExchangePointsPolicyGroup group

    +

    ExchangePointsPolicyGroup

    7.16. The ExchangePointsPolicyGroup group

    -

    ExchangePointsPolicyGroup

    ExchangePointsPolicy

    Language

    0:*

    xs:language

    Preferred language in which to return text values.

    NumberOfResults

    0:1

    xs:positiveInteger

    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.

    6.17. The ExchangePointsResponseGroup group

    +

    ExchangePointsResponseGroup

    7.17. The ExchangePointsResponseGroup group

    -

    ExchangePointsResponseGroup

    ExchangePointsResponse

    ExchangePointResponseContext

    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.

    Place

    0:*

    +ExchangePointsResult

    6.18. The complex type ExchangePointsResultStructure

    ExchangePointsResultStructure

    The element contains a sequence of the following elements:

    Problem

    0:*

    +ExchangePointProblem

    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 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.

    -

    7. OJP/OJP_PlaceSupport.xsd - Supporting definitions for place information

    7.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_OTHER

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

    PointOfInterestCodeType

    xs:normalizedString

    Identifier of a Point of Interest

    StopPlaceCodeType

    xs:normalizedString

    Identifier of a Stop Place

    TopographicPlaceCodeType

    xs:normalizedString

    Identifier of a TopographicPlace

    7.2. The StopPointGroup group

    +

    StopPointGroup

    A stop point with id and name

    7.18. The complex type ExchangePointsResultStructure

    ExchangePointsResultStructure

    The element contains a sequence of the following elements:

    Problem

    0:*

    +ExchangePointProblem

    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 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.

    +

    8. OJP/OJP_PlaceSupport.xsd - Supporting definitions for place 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_OTHER

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

    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

    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. F.e. "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.

    7.3. The complex type StopPointStructure

    +

    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:

    8.3. The complex type StopPointStructure

    @@ -468,11 +482,11 @@

    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

    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. F.e. "opposite main entrance".

    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.

    7.4. The complex type StopPlaceRefStructure

    StopPlaceRefStructure

    StopPlaceCode

    Reference to a Stop Place

    7.5. The toplevel element StopPlaceRef

    StopPlaceRef

    +StopPlaceRef

    Reference to a Stop Place

    7.6. The StopPlaceGroup group

    +

    StopPlaceGroup

    A stop place with id and name

    8.4. The complex type StopPlaceRefStructure

    StopPlaceRefStructure

    StopPlaceCode

    Reference to a Stop Place

    8.5. The toplevel element StopPlaceRef

    StopPlaceRef

    +StopPlaceRef

    Reference to a Stop Place

    8.6. The StopPlaceGroup group

    -

    StopPlaceGroup

    A stop place with id and name

    StopPlace

    →‍StopPlaceRef

    1:1

    →‍StopPlaceRef

    Reference to a Stop Place

    StopPlaceName

    1:1

    +InternationalText

    Name of this stop place for use in passenger information.

    NameSuffix

    0:1

    +InternationalText

    Additional description of the stop place that may be appended to the name if enough space is available. F.e. "Exhibition Center".

    7.7. The complex type StopPlaceStructure

    +

    StopPlaceStructure

    [an extended view of STOP PLACE in TMv6] a PLACE extended by ACCESSIBILITY LIMITATION properties and some attributes of the associated equipment, comprising one or more locations where vehicles may stop and where passengers may board or leave vehicles or prepare their trip, and which will usually have one or more wellknown names

    The element contains a sequence of the following elements:

    8.7. The complex type StopPlaceStructure

    @@ -480,11 +494,11 @@

    OJP - Open API for distributed Journey

    -

    StopPlaceStructure

    [an extended view of STOP PLACE in TMv6] a PLACE extended by ACCESSIBILITY LIMITATION properties and some attributes of the associated equipment, comprising one or more locations where vehicles may stop and where passengers may board or leave vehicles or prepare their trip, and which will usually have one or more wellknown names

    The element contains a sequence of the following elements:

    StopPlace

    →‍StopPlaceRef

    1:1

    →‍StopPlaceRef

    Reference to a Stop Place

    StopPlaceName

    1:1

    +InternationalText

    Name of this stop place for use in passenger information.

    NameSuffix

    0:1

    +InternationalText

    Additional description of the stop place that may be appended to the name if enough space is available. F.e. "Exhibition Center".

    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.

    7.8. The StopAttributesGroup group

    +

    StopAttributesGroup

    [properties of a SCHEDULED STOP POINT or STOP PLACE in TMv6] selection of attributes of ACCESSIBIITY LIMITATION related to a SCHEDULED STOP POINT extended by attributes referring to some equipment.

    8.8. The StopAttributesGroup group

    -

    StopAttributesGroup

    [properties of a SCHEDULED STOP POINT or STOP PLACE in TMv6] selection of attributes of ACCESSIBIITY LIMITATION related to a SCHEDULED STOP POINT extended by attributes referring to some equipment.

    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.

    7.9. The complex type TopographicPlaceRefStructure

    TopographicPlaceRefStructure

    Reference to a TopographicPlace

    7.10. The toplevel element TopographicPlaceRef

    TopographicPlaceRef

    +TopographicPlaceRef

    Reference to a TopographicPlace

    7.11. 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.

    ReferredSystemId

    0:1

    xs:normalizedString

    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.

    7.12. The complex type PointOfInterestRefStructure

    PointOfInterestRefStructure

    PointOfInterestCode

    Reference to a Point of Interest

    7.13. The toplevel element PointOfInterestRef

    PointOfInterestRef

    +PointOfInterestRef

    Reference to a Point of Interest

    7.14. 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. F.e. "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 place objects within the given localities are allowed.If at least one is set, only place objects within the given localities are allowed.Reference to a TopographicPlace

    7.15. 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

    Open Street Map 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]")

    7.16. The complex type OsmTagStructure

    OsmTagStructure

    Structure of an Open Street Map tag.

    The element contains a sequence of the following elements:

    Tag

    1:1

    xs:NMTOKEN

    Name of Open Street Map tag (amenity, leisure, tourism, bike, ...)

    Value

    1:1

    xs:NMTOKEN

    Value for Open Street Map tag (charging_station, hostel, yes, ...)

    7.17. 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).

    7.18. The complex type AddressRefStructure

    AddressRefStructure

    AddressCode

    Reference to an Address

    7.19. The toplevel element AddressRef

    AddressRef

    +AddressRef

    Reference to an Address

    7.20. The AddressDetailGroup group

    +

    AddressDetailGroup

    An address with its name entities

    8.9. The complex type TopographicPlaceRefStructure

    TopographicPlaceRefStructure

    Reference to a TopographicPlace

    8.10. The toplevel element TopographicPlaceRef

    TopographicPlaceRef

    +TopographicPlaceRef

    Reference to a TopographicPlace

    8.11. 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.

    ReferredSystemId

    0:1

    xs:normalizedString

    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.12. The complex type PointOfInterestRefStructure

    PointOfInterestRefStructure

    PointOfInterestCode

    Reference to a Point of Interest

    8.13. The toplevel element PointOfInterestRef

    PointOfInterestRef

    +PointOfInterestRef

    Reference to a Point of Interest

    8.14. 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. F.e. "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 place objects within the given localities are allowed.If at least one is set, only place objects within the given localities are allowed.Reference to a TopographicPlace

    8.15. 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

    Open Street Map 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.16. The complex type OsmTagStructure

    OsmTagStructure

    Structure of an Open Street Map tag.

    The element contains a sequence of the following elements:

    Tag

    1:1

    xs:NMTOKEN

    Name of Open Street Map tag (amenity, leisure, tourism, bike, ...)

    Value

    1:1

    xs:NMTOKEN

    Value for Open Street Map tag (charging_station, hostel, yes, ...)

    8.17. 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.18. The complex type AddressRefStructure

    AddressRefStructure

    AddressCode

    Reference to an Address

    8.19. The toplevel element AddressRef

    AddressRef

    +AddressRef

    Reference to an Address

    8.20. The AddressDetailGroup group

    @@ -492,7 +506,7 @@

    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.

    7.21. The complex type AddressStructure

    +

    AddressStructure

    descriptive data associated with a PLACE that can be used to describe the unique geographical context of a PLACE for the purposes of identifying it. May be refined as either a ROAD ADDRESS, a POSTAL ADDRESS or both

    The element contains a sequence of the following elements:

    PublicCode

    1:1

    AddressCode

    ID of this address.

    PrivateCode

    0:*

    +PrivateCode

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

    Name

    1:1

    +InternationalText

    Name or description of address for use in passenger information.

    NameSuffix

    0:1

    +InternationalText

    Additional description of the address that may be appended to the name if enough space is available. F.e. "Crossing with Peterstraße".

    8.21. The complex type AddressStructure

    @@ -500,16 +514,16 @@

    OJP - Open API for distributed Journey

    -

    AddressStructure

    descriptive data associated with a PLACE that can be used to describe the unique geographical context of a PLACE for the purposes of identifying it. May be refined as either a ROAD ADDRESS, a POSTAL ADDRESS or both

    The element contains a sequence of the following elements:

    PublicCode

    1:1

    AddressCode

    ID of this address.

    PrivateCode

    0:*

    +PrivateCode

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

    Name

    1:1

    +InternationalText

    Name or description of address for use in passenger information.

    NameSuffix

    0:1

    +InternationalText

    Additional description of the address that may be appended to the name if enough space is available. F.e. "Crossing with Peterstraße".

    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.

    7.22. 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

    Attribute

    0:*

    +GeneralAttribute

    Attribute associated with this place.

    Extension

    0:1

    xs:anyType

    7.23. 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 a sequence of the following elements:

    Then, the element contains one of the following elements:

    a

    →‍siri:StopPointRef

    -1:1

    →‍siri:StopPointRef

    b

    →‍StopPlaceRef

    -1:1

    →‍StopPlaceRef

    Reference to a Stop Place

    c

    →‍TopographicPlaceRef

    -1:1

    →‍TopographicPlaceRef

    If at least one is set, only place objects within the given localities are allowed.If at least one is set, only 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/

    7.24. The complex type LocationProblemStructure

    +

    LocationProblemStructure

    Problem that may be returned in responses to LOCATION requests.

    The element contains a sequence of the following elements:

    Type

    1:1

    LocationProblemType

    Type of the LOCATION problem.

    8.22. 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

    Attribute

    0:*

    +GeneralAttribute

    Attribute associated with this place.

    Extension

    0:1

    xs:anyType

    8.23. 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 a sequence of the following elements:

    Then, the element contains one of the following elements:

    a

    →‍siri:StopPointRef

    -1:1

    →‍siri:StopPointRef

    b

    →‍StopPlaceRef

    -1:1

    →‍StopPlaceRef

    Reference to a Stop Place

    c

    →‍TopographicPlaceRef

    -1:1

    →‍TopographicPlaceRef

    If at least one is set, only place objects within the given localities are allowed.If at least one is set, only 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/

    8.24. The complex type LocationProblemStructure

    -

    LocationProblemStructure

    Problem that may be returned in responses to LOCATION requests.

    The element contains a sequence of the following elements:

    Type

    1:1

    LocationProblemType

    Type of the LOCATION problem.

    ProblemDetail

    Title

    0:1

    +InternationalText

    Title of the problem.

    Details

    0:1

    +InternationalText

    Explanation of the problem.

    LogData

    0:1

    xs:string

    Additional log data.

    7.25. The complex type ExchangePointProblemStructure

    +

    ExchangePointProblemStructure

    Problem that may be returned in responses to EXCHANGE POINTS requests.

    The element contains a sequence of the following elements:

    Type

    1:1

    ExchangePointsProblemType

    Type of the EXCHANGE POINTS problem.

    8.25. The complex type ExchangePointProblemStructure

    ExchangePointProblemStructure

    Problem that may be returned in responses to EXCHANGE POINTS requests.

    The element contains a sequence of the following elements:

    Type

    1:1

    ExchangePointsProblemType

    Type of the EXCHANGE POINTS problem.

    ProblemDetail

    Title

    0:1

    +InternationalText

    Title of the problem.

    Details

    0:1

    +InternationalText

    Explanation of the problem.

    LogData

    0:1

    xs:string

    Additional log data.

    -

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

    8.1. Simple type definitions

    HierarchyEnumeration

    local | no | down | all

    +

    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 @@ -518,10 +532,10 @@

    OJP - Open API for distributed Journey

    StopEventProblemTypeEnumeration

    STOPEVENT_NOEVENTFOUND | STOPEVENT_LOCATIONUNSERVED | STOPEVENT_LOCATIONUNKNOWN | STOPEVENT_DATEOUTOFRANGE | STOPEVENT_LASTSERVICEOFTHISLINE | STOPEVENT_NOREALTIME | STOPEVENT_OTHER

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

    StopEventTypeEnumeration

    departure | arrival | both

    Departure or arrival events or both

    8.2. The StopEventRequestGroup group

    +

    StopEventRequestGroup

    Request structure for departure and arrival events at stops

    StopEventProblemTypeEnumeration

    STOPEVENT_NOEVENTFOUND | STOPEVENT_LOCATIONUNSERVED | STOPEVENT_LOCATIONUNKNOWN | STOPEVENT_DATEOUTOFRANGE | STOPEVENT_LASTSERVICEOFTHISLINE | STOPEVENT_NOREALTIME | STOPEVENT_OTHER

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

    StopEventTypeEnumeration

    departure | arrival | both

    Departure or arrival events or both

    9.2. The StopEventRequestGroup group

    -

    StopEventRequestGroup

    Request structure for departure and arrival events at stops

    StopEventRequest

    Place

    1:1

    +PlaceContext

    Place for which to obtain stop event information.

    Params

    0:1

    +StopEventParam

    Request parameter

    8.3. The complex type StopEventParamStructure

    +

    StopEventParamStructure

    Request specific parameters (parameters which define what is to be included in a Stop Event result)

    The element contains a sequence of the following elements:

    9.3. The complex type StopEventParamStructure

    @@ -545,15 +559,15 @@

    OJP - Open API for distributed Journey -

    StopEventParamStructure

    Request specific parameters (parameters which define what is to be included in a Stop Event result)

    The element contains a sequence of the following elements:

    StopEventDataFilter

    PtModeFilter

    0:1

    +PtModeFilter

    Modes (VEHICLE MODE) to be excluded or included in stop events.

    LineFilter

    0:1

    +LineDirectionFilter

    Lines/Directions to include/exclude.

    OperatorFilter

    0:1

    +OperatorFilter

    Transport operators to include/exclude.

    8.4. The StopEventDataFilterGroup group

    +

    StopEventDataFilterGroup

    Request data filters

    9.4. The StopEventDataFilterGroup group

    -

    StopEventDataFilterGroup

    Request data filters

    StopEventDataFilter

    PtModeFilter

    0:1

    +PtModeFilter

    Modes (VEHICLE MODE) to be excluded or included in stop events.

    LineFilter

    0:1

    +LineDirectionFilter

    Lines/Directions to include/exclude.

    OperatorFilter

    0:1

    +OperatorFilter

    Transport operators to include/exclude.

    8.5. The StopEventPolicyGroup group

    +

    StopEventPolicyGroup

    Request policies

    9.5. The StopEventPolicyGroup group

    -

    StopEventPolicyGroup

    Request policies

    StopEventPolicy

    NumberOfResults

    0:1

    xs:positiveInteger

    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

    TimeWindow

    0:1

    xs:duration

    Time window events should lie within. Starting from time given in PlaceContext.

    StopEventType

    0:1

    StopEventType

    Only departures or arrivals or both.

    8.6. The StopEventContentFilterGroup group

    +

    StopEventContentFilterGroup

    Content filters which data is expected in the response

    9.6. The StopEventContentFilterGroup group

    @@ -569,18 +583,18 @@

    OJP - Open API for distributed Journey -

    StopEventContentFilterGroup

    Content filters which data is expected in the response

    StopEventContentFilter

    IncludePreviousCalls

    0:1

    xs:boolean

    Whether the previous calls of each vehicle journey should be included in the response.

    IncludeOnwardCalls

    0:1

    xs:boolean

    Whether the onward calls of each vehicle journey should be included in the response.

    IncludeOperatingDays

    0:1

    xs:boolean

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

    8.7. The StopEventResponseGroup group

    +

    StopEventResponseGroup

    Response structure for departure and arrival events at stops

    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.

    8.8. The complex type StopEventResultStructure

    StopEventResultStructure

    Wrapper element for a single stop event result.

    The element contains a sequence of the following elements:

    ResultId

    1:1

    xs:NMTOKEN

    ID of this result.

    Problem

    0:*

    +StopEventProblem

    Problems related to this STOPEVENT result.

    StopEvent

    1:1

    +StopEvent

    Stop event data element.

    8.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.

    9.8. The complex type StopEventResultStructure

    StopEventResultStructure

    Wrapper element for a single stop event result.

    The element contains a sequence of the following elements:

    ResultId

    1:1

    xs:NMTOKEN

    ID of this result.

    Problem

    0:*

    +StopEventProblem

    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".

    Extension

    0:1

    xs:anyType

    8.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 place (f.e. address) to this stop in metres.

    WalkDuration

    0:1

    xs:duration

    Walking duration from request place (f.e. address) to this stop. All user options taken into account (f.e. walk speed).

    8.11. The complex type StopEventProblemStructure

    +

    StopEventProblemStructure

    Problem that may be returned in responses to STOPEVENT requests.

    The element contains a sequence of the following elements:

    Type

    1:1

    StopEventProblemType

    Type of the STOPEVENT problem.

    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 place (f.e. address) to this stop in metres.

    WalkDuration

    0:1

    xs:duration

    Walking duration from request place (f.e. address) to this stop. All user options taken into account (f.e. walk speed).

    9.11. The complex type StopEventProblemStructure

    StopEventProblemStructure

    Problem that may be returned in responses to STOPEVENT requests.

    The element contains a sequence of the following elements:

    Type

    1:1

    StopEventProblemType

    Type of the STOPEVENT problem.

    ProblemDetail

    Title

    0:1

    +InternationalText

    Title of the problem.

    Details

    0:1

    +InternationalText

    Explanation of the problem.

    LogData

    0:1

    xs:string

    Additional log data.

    -

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

    9.1. Simple type definitions

    TripInfoProblemTypeEnumeration

    TRIPINFO_JOURNEYREFUNKNOWN | TRIPINFO_VEHICLEUNKNOWN | TRIPINFO_NOJOURNEYFOUND | TRIPINFO_NOGEOINFO | TRIPINFO_OTHER

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

    9.2. The TripInfoRequestGroup group

    +

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

    10.1. Simple type definitions

    TripInfoRequestGroup

    TripInfo request structure.

    TripInfoProblemTypeEnumeration

    TRIPINFO_JOURNEYREFUNKNOWN | TRIPINFO_VEHICLEUNKNOWN | TRIPINFO_NOJOURNEYFOUND | TRIPINFO_NOGEOINFO | TRIPINFO_OTHER

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

    10.2. The TripInfoRequestGroup group

    @@ -589,7 +603,7 @@

    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

    a

    →‍OperatingDayRef

    1:1

    →‍OperatingDayRef

    Reference to an Operating Day

    b

    TimeOfOperation

    1:1

    xs:dateTime

    Time stamp when the vehicle is operating. In most use cases equal to "now".

    TripInfoRequest

    Params

    0:1

    +TripInfoParam

    Request parameter.

    9.3. The complex type TripInfoParamStructure

    +

    TripInfoParamStructure

    TripInfo request parameter structure.

    The element contains a sequence of the following elements:

    10.3. The complex type TripInfoParamStructure

    @@ -599,9 +613,9 @@

    OJP - Open API for distributed Journey

    -

    TripInfoParamStructure

    TripInfo request parameter structure.

    The element contains a sequence of the following elements:

    TripInfoPolicy

    UseTimetabledDataOnly

    0:1

    xs:boolean

    Do not show any realtime or incident data. Default is false.

    TripInfoContentFilter

    IncludeCalls

    0:1

    xs:boolean

    Whether call information is to be included. Default is true.

    IncludeTrackProjection

    0:1

    xs:boolean

    Whether the result should include the geographic projection (coordinates) of this vehicle journey.

    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

    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

    Extension

    0:1

    xs:anyType

    9.4. The TripInfoPolicyGroup group

    +

    TripInfoPolicyGroup

    Parameters that control the response behaviour.

    Extension

    0:1

    xs:anyType

    10.4. The TripInfoPolicyGroup group

    -

    TripInfoPolicyGroup

    Parameters that control the response behaviour.

    TripInfoPolicy

    UseTimetabledDataOnly

    0:1

    xs:boolean

    Do not show any realtime or incident data. Default is false.

    9.5. The TripInfoContentFilterGroup group

    +

    TripInfoContentFilterGroup

    Parameters that control the level of detail to be returned in the results.

    10.5. The TripInfoContentFilterGroup group

    @@ -609,23 +623,23 @@

    OJP - Open API for distributed Journey

    -

    TripInfoContentFilterGroup

    Parameters that control the level of detail to be returned in the results.

    TripInfoContentFilter

    IncludeCalls

    0:1

    xs:boolean

    Whether call information is to be included. Default is true.

    IncludePosition

    0:1

    xs:boolean

    Whether current position is to be included. Default is true.

    IncludeService

    0:1

    xs:boolean

    Whether service information is to be included. Default is true.

    IncludeTrackProjection

    0:1

    xs:boolean

    Whether the result should include the geographic projection (coordinates) of this vehicle journey.

    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

    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

    9.6. The TripInfoResponseGroup group

    +

    TripInfoResponseGroup

    TripInfo response structure.

    10.6. The TripInfoResponseGroup group

    -

    TripInfoResponseGroup

    TripInfo response structure.

    TripInfoResponse

    TripInfoResponseContext

    0:1

    +ResponseContext

    Response context.

    TripInfoResult

    0:1

    +TripInfoResult

    Result structure.

    9.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:

    Problem

    0:*

    +TripInfoProblem

    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 current status of a trip.

    The element contains a sequence of the following elements:

    Problem

    0:*

    +TripInfoProblem

    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".

    →‍siri:ServiceFacilityGroup

    JourneyTrack

    0:1

    +LegTrack

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

    Extension

    0:1

    xs:anyType

    9.8. The complex type TripInfoProblemStructure

    TripInfoProblemStructure

    Problem that may be returned in responses to TripInfo requests.

    The element contains only one element:

    Type

    1:1

    TripInfoProblemType

    Type of the TripInfo problem.

    -

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

    10.1. Simple type definitions

    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).

    GuidanceAdviceEnumeration

    origin | destination | continue | keep | turn | leave | enter

    various types of guidance advice given to travelle

    MultiPointTypeEnumeration

    anyPoint | eachOrigin | eachDestination

    How the multiple origin/destination points should be considered

    OptimisationMethodEnumeration

    fastest | minChanges | leastWalking | leastCost | leastDistance | earliestArrival | latestDeparture | earliestArrivalAndLatestDeparture

    the types of algorithm that can be used for planning a journey (fastest, least walking, etc). If multiple optimisation methods are needed, then several requests should be performed in parallel.

    TransitionEnumeration

    up | down | level | upAndDown | downAndUp

    Transition types for interchanges.

    TripProblemTypeEnumeration

    TRIP_NOTRIPFOUND | TRIP_ORIGINUNKNOWN | TRIP_DESTINATIONUNKNOWN | TRIP_VIAUNKNOWN | TRIP_NOTVIAUNKNOWN | TRIP_NOCHANGEATUNKNOWN | TRIP_NOORIGIN | TRIP_NODESTINATION | TRIP_ORIGINDESTINATIONIDENTICAL | TRIP_DATETIMEERROR | TRIP_DEPARTUREAFTERARRIVAL | TRIP_DATEOUTOFRANGE | TRIP_ORIGINEQUIVALENT | TRIP_DESTINATIONEQUIVALENT | TRIP_VIAEQUIVALENT | TRIP_REALTIMEINCOMPLETE | TRIP_ITTIMEEXTENDED | TRIP_ITMODECHANGED | TRIP_INCONVENIENTWAITING | TRIP_MULTIPOINT_NOTALLPOINTSCOVERED | TRIP_MULTIPOINT_TOOMANYPOINTS | TRIP_OTHER

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

    TurnActionEnumeration

    sharp left | left | half left | straight on | half right | right | sharp right | uturn

    the range of alternative turns that can be described

    10.2. The TripRequestGroup group

    +

    TripRequestGroup

    Trip request structure.

    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 complex type TripInfoProblemStructure

    TripInfoProblemStructure

    Problem that may be returned in responses to TripInfo requests.

    The element contains only one element:

    Type

    1:1

    TripInfoProblemType

    Type of the TripInfo problem.

    +

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

    11.1. Simple type definitions

    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).

    GuidanceAdviceEnumeration

    origin | destination | continue | keep | turn | leave | enter

    various types of guidance advice given to travelle

    MultiPointTypeEnumeration

    anyPoint | eachOrigin | eachDestination

    How the multiple origin/destination points should be considered

    OptimisationMethodEnumeration

    fastest | minChanges | leastWalking | leastCost | leastDistance | earliestArrival | latestDeparture | earliestArrivalAndLatestDeparture

    the types of algorithm that can be used for planning a journey (fastest, least walking, etc). If multiple optimisation methods are needed, then several requests should be performed in parallel.

    TransitionEnumeration

    up | down | level | upAndDown | downAndUp

    Transition types for interchanges.

    TripProblemTypeEnumeration

    TRIP_NOTRIPFOUND | TRIP_ORIGINUNKNOWN | TRIP_DESTINATIONUNKNOWN | TRIP_VIAUNKNOWN | TRIP_NOTVIAUNKNOWN | TRIP_NOCHANGEATUNKNOWN | TRIP_NOORIGIN | TRIP_NODESTINATION | TRIP_ORIGINDESTINATIONIDENTICAL | TRIP_DATETIMEERROR | TRIP_DEPARTUREAFTERARRIVAL | TRIP_DATEOUTOFRANGE | TRIP_ORIGINEQUIVALENT | TRIP_DESTINATIONEQUIVALENT | TRIP_VIAEQUIVALENT | TRIP_REALTIMEINCOMPLETE | TRIP_ITTIMEEXTENDED | TRIP_ITMODECHANGED | TRIP_INCONVENIENTWAITING | TRIP_MULTIPOINT_NOTALLPOINTSCOVERED | TRIP_MULTIPOINT_TOOMANYPOINTS | TRIP_OTHER

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

    TurnActionEnumeration

    sharp left | left | half left | straight on | half right | right | sharp right | uturn

    the range of alternative turns that can be described

    11.2. The TripRequestGroup group

    -

    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.

    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.

    Params

    0:1

    +TripParam

    Options to control the search behaviour and response contents.

    10.3. The complex type TripParamStructure

    +

    TripParamStructure

    Trip request parameter structure.

    The element contains a sequence of the following elements:

    11.3. The complex type TripParamStructure

    @@ -671,14 +685,14 @@

    OJP - Open API for distributed Journey

    -

    TripParamStructure

    Trip request parameter structure.

    The element contains a sequence of the following elements:

    TripDataFilter

    PtModeFilter

    0:1

    +PtModeFilter

    Modes (VEHICLE MODE) to be excluded or included in trip calculation.

    LineFilter

    0:1

    +LineDirectionFilter

    Lines/Directions to include/exclude.

    OperatorFilter

    0:1

    +OperatorFilter

    Transport operators to include/exclude.

    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

    Extension

    0:1

    xs:anyType

    10.4. The TripDataFilterGroup group

    +

    TripDataFilterGroup

    Data to be included/excluded from search, f.e. modes, operators.

    FareParam

    0:1

    +FareParam

    Extension

    0:1

    xs:anyType

    11.4. The TripDataFilterGroup group

    -

    TripDataFilterGroup

    Data to be included/excluded from search, f.e. modes, operators.

    TripDataFilter

    PtModeFilter

    0:1

    +PtModeFilter

    Modes (VEHICLE MODE) to be excluded or included in trip calculation.

    LineFilter

    0:1

    +LineDirectionFilter

    Lines/Directions to include/exclude.

    OperatorFilter

    0:1

    +OperatorFilter

    Transport operators to include/exclude.

    PrivateModeFilter

    0:1

    +PrivateModeFilter

    Private mobility options to include/exclude.

    VehicleFilter

    0:1

    +VehicleFilter

    Filter for VEHICLE and TRAIN NUMBERs.

    TariffzoneFilter

    0:1

    +TariffzoneFilter

    Filter for trips using only specific tariff zones.

    10.5. The TripPolicyGroup group

    +

    TripPolicyGroup

    Policies that control the trip search behaviour.

    11.5. The TripPolicyGroup group

    @@ -691,7 +705,7 @@

    OJP - Open API for distributed Journey

    -

    TripPolicyGroup

    Policies that control the trip search behaviour.

    The element contains one of the following elements:

    NumberOfResults

    a

    NumberOfResultsBefore

    1:1

    xs:nonNegativeInteger

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

    OptimisationMethod

    0:1

    OptimisationMethod

    the types of algorithm that can be used for planning a journey (fastest, least walking, etc)

    ItModesToCover

    0:*

    IndividualModes

    For each mode in this list a separate monomodal trip shall be found - in addition to inter-modal solutions.

    ConsiderElevationData

    0:1

    xs:boolean

    Trip calculation takes elevation data into account (bike, walk)

    10.6. The TripMobilityFilterGroup group

    +

    TripMobilityFilterGroup

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

    11.6. The TripMobilityFilterGroup group

    @@ -704,7 +718,7 @@

    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 climb one step.

    NoStairs

    0:1

    xs:boolean

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

    BikeTransport

    0:1

    xs:boolean

    The user wants to carry a bike on public transport.

    WalkSpeed

    0:1

    OpenPercent

    Deviation from average walk 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).

    10.7. The TripContentFilterGroup group

    +

    TripContentFilterGroup

    Parameters that control the level of detail of the trip results.

    11.7. The TripContentFilterGroup group

    @@ -717,13 +731,13 @@

    OJP - Open API for distributed Journey

    -

    TripContentFilterGroup

    Parameters that control the level of detail of the trip results.

    BaseTripContentFilter

    IncludeTrackSections

    0:1

    xs:boolean

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

    IncludeLegProjection

    0:1

    xs:boolean

    Whether the result should include the geographic projection (coordinates) of each journey leg.

    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.

    10.8. The complex type NotViaStructure

    NotViaStructure

    NNot-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

    b

    →‍StopPlaceRef

    -1:1

    →‍StopPlaceRef

    Reference to a Stop Place

    10.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

    b

    →‍StopPlaceRef

    -1:1

    →‍StopPlaceRef

    Reference to a Stop Place

    10.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

    10.11. The TripResponseGroup group

    +

    TripResponseGroup

    Trip response structure.

    11.8. The complex type NotViaStructure

    NotViaStructure

    NNot-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

    b

    →‍StopPlaceRef

    -1:1

    →‍StopPlaceRef

    Reference to a 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

    b

    →‍StopPlaceRef

    -1:1

    →‍StopPlaceRef

    Reference to a 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

    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.

    10.12. The complex type TripResultStructure

    TripResultStructure

    Structure for a single trip result and associated problems.

    The element contains a sequence of the following elements:

    ResultId

    1:1

    xs:NMTOKEN

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

    Problem

    0:*

    +TripProblem

    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

    10.13. The complex type TripSummaryStructure

    +

    TripSummaryStructure

    Structure for trip overview information.

    The element contains a sequence of the following elements:

    TripId

    1:1

    xs:NMTOKEN

    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.

    StartTime

    0:1

    xs:dateTime

    Departure time at origin.

    EndTime

    0:1

    xs:dateTime

    Arrival time at destination.

    PTTripLegs

    0:1

    xs:nonNegativeInteger

    Number of public transport trip legs.

    Distance

    0:1

    siri:DistanceType

    Trip distance.

    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:

    ResultId

    1:1

    xs:NMTOKEN

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

    Problem

    0:*

    +TripProblem

    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

    11.13. The complex type TripSummaryStructure

    -

    TripSummaryStructure

    Structure for trip overview information.

    The element contains a sequence of the following elements:

    TripId

    1:1

    xs:NMTOKEN

    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.

    StartTime

    0:1

    xs:dateTime

    Departure time at origin.

    EndTime

    0:1

    xs:dateTime

    Arrival time at destination.

    PTTripLegs

    0:1

    xs:nonNegativeInteger

    Number of public transport trip legs.

    Distance

    0:1

    siri:DistanceType

    Trip distance.

    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".

    →‍SituationFullRef

    0:*

    →‍SituationFullRef

    Reference to situation message. Message details might be found in response context or through other communication channels.

    Extension

    0:1

    xs:anyType

    10.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 trip LEGs

    The element contains a sequence of the following elements:

    TripId

    1:1

    xs:NMTOKEN

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

    Duration

    1:1

    xs:duration

    Overall duration of the trip.

    StartTime

    1:1

    xs:dateTime

    Departure time at origin.

    EndTime

    1:1

    xs:dateTime

    Arrival time at destination.

    Transfers

    1:1

    xs:nonNegativeInteger

    Number of interchanges.

    Distance

    0:1

    siri:DistanceType

    Trip distance.

    TripLeg

    1:*

    +TripLeg

    Legs of the trip

    →‍SituationFullRef

    0:*

    →‍SituationFullRef

    Reference to situation message. Message details might be found in response context or through other communication channels.

    Extension

    0:1

    xs:anyType

    11.14. The complex type TripStructure

    @@ -732,20 +746,20 @@

    OJP - Open API for distributed Journey

    -

    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 trip LEGs

    The element contains a sequence of the following elements:

    TripId

    1:1

    xs:NMTOKEN

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

    Duration

    1:1

    xs:duration

    Overall duration of the trip.

    StartTime

    1:1

    xs:dateTime

    Departure time at origin.

    EndTime

    1:1

    xs:dateTime

    Arrival time at destination.

    Transfers

    1:1

    xs:nonNegativeInteger

    Number of interchanges.

    Distance

    0:1

    siri:DistanceType

    Trip distance.

    TripLeg

    1:*

    +TripLeg

    Legs of the trip

    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".

    →‍SituationFullRef

    0:*

    →‍SituationFullRef

    Reference to situation message. Message details might be found in response context or through other communication channels.

    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.

    Extension

    0:1

    xs:anyType

    10.15. The complex type TripLegStructure

    TripLegStructure

    a single stage of a TRIP that is made without change of MODE or service (ie: between each interchange)

    The element contains a sequence of the following elements:

    LegId

    1:1

    xs:NMTOKEN

    Id of this trip 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)

    Then, the element contains one of the following elements:

    a

    ContinuousLeg

    -1:1

    +ContinuousLeg

    b

    TimedLeg

    -1:1

    +TimedLeg

    c

    TransferLeg

    -1:1

    +TransferLeg

    10.16. The complex type TimedLegStructure

    +

    TimedLegStructure

    passenger TRIP LEG with timetabled schedule. Corresponds to a RIDE.

    The element contains a sequence of the following elements:

    LegBoard

    1:1

    +LegBoard

    Stop/Station where boarding is done

    LegIntermediates

    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 trip leg.

    LegAttribute

    0:*

    +LegAttribute

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

    Extension

    0:1

    xs:anyType

    11.15. The complex type TripLegStructure

    TripLegStructure

    a single stage of a TRIP that is made without change of MODE or service (ie: between each interchange)

    The element contains a sequence of the following elements:

    LegId

    1:1

    xs:NMTOKEN

    Id of this trip 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)

    Then, the element contains one of the following elements:

    a

    ContinuousLeg

    -1:1

    +ContinuousLeg

    b

    TimedLeg

    -1:1

    +TimedLeg

    c

    TransferLeg

    -1:1

    +TransferLeg

    11.16. The complex type TimedLegStructure

    -

    TimedLegStructure

    passenger TRIP LEG with timetabled schedule. Corresponds to a RIDE.

    The element contains a sequence of the following elements:

    LegBoard

    1:1

    +LegBoard

    Stop/Station where boarding is done

    LegIntermediates

    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 trip 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.

    Extension

    0:1

    xs:anyType

    10.17. The complex type TransferLegStructure

    +

    TransferLegStructure

    [a specialised type of NAVIGATION PATH in TMv6] description of a LEG which links other LEGs of a TRIP where a TRANSFER between different LOCATIONs is required

    The element contains a sequence of the following elements:

    Then, the element contains one of the following elements:

    a

    ContinuousMode

    -1:1

    ContinuousModes

    Mode that is used for this interchange between public services.

    b

    TransferMode

    -1:1

    TransferModes

    Mode that is used for this interchange between public services.

    LegStart

    1:1

    +PlaceRef

    Stop/Station where boarding is done

    LegEnd

    1:1

    +PlaceRef

    Stop/Station to alight

    LegTrack

    0:1

    +LegTrack

    Geographic embedding of this leg.

    Extension

    0:1

    xs:anyType

    11.17. The complex type TransferLegStructure

    -

    TransferLegStructure

    [a specialised type of NAVIGATION PATH in TMv6] description of a LEG which links other LEGs of a TRIP where a TRANSFER between different LOCATIONs is required

    The element contains a sequence of the following elements:

    Then, the element contains one of the following elements:

    a

    ContinuousMode

    -1:1

    ContinuousModes

    Mode that is used for this interchange between public services.

    b

    TransferMode

    -1:1

    TransferModes

    Mode that is used for this interchange between public services.

    LegStart

    1:1

    +PlaceRef

    Stop/Station where boarding is done

    LegEnd

    1:1

    +PlaceRef

    Stop/Station to alight

    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.

    WalkDuration

    0:1

    xs:duration

    Walk time as part of the overall interchange duration.

    BufferTime

    0:1

    xs:duration

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

    LegDescription

    0:1

    +InternationalText

    Text that describes this interchange.

    Length

    0:1

    Length

    Length of this interchange path.

    Attribute

    0:*

    +GeneralAttribute

    Note or service attribute.

    PathGuidance

    0:1

    +PathGuidance

    Structured model further describing this interchange, its geographic embedding and accessibility.

    →‍SituationFullRef

    0:*

    →‍SituationFullRef

    Reference to situation message. Message details might be found in response context or through other communication channels.

    Extension

    0:1

    xs:anyType

    10.18. The complex type ContinuousLegStructure

    +

    ContinuousLegStructure

    [relates to a specific type of RIDE in TM and NeTEx] leg of a journey that is not bound to a timetable

    The element contains a sequence of the following elements:

    LegStart

    1:1

    +PlaceRef

    Stop/Station where boarding is done

    LegEnd

    1:1

    +PlaceRef

    Stop/Station to alight

    Service

    1:1

    +ContinuousService

    Service of this leg. May be "walk" in most cases, but also cycling or taxi etc.

    LegDescription

    0:1

    +InternationalText

    Text that describes this interchange.

    Length

    0:1

    Length

    Length of this interchange path.

    Attribute

    0:*

    +GeneralAttribute

    Note or service attribute.

    PathGuidance

    0:1

    +PathGuidance

    Structured model further describing this interchange, its geographic embedding and accessibility.

    →‍SituationFullRef

    0:*

    →‍SituationFullRef

    Reference to situation message. Message details might be found in response context or through other communication channels.

    Extension

    0:1

    xs:anyType

    11.18. The complex type ContinuousLegStructure

    -

    ContinuousLegStructure

    [relates to a specific type of RIDE in TM and NeTEx] leg of a journey that is not bound to a timetable

    The element contains a sequence of the following elements:

    LegStart

    1:1

    +PlaceRef

    Stop/Station where boarding is done

    LegEnd

    1:1

    +PlaceRef

    Stop/Station to alight

    Service

    1:1

    +ContinuousService

    Service of this leg. May be "walk" in most cases, but also cycling or taxi etc.

    TimeWindow

    TimeWindowStart

    0:1

    xs:dateTime

    Time at which window begins.

    TimeWindowEnd

    0:1

    xs:dateTime

    Time at which window ends.

    Duration

    1:1

    xs:duration

    Duration of this leg according to user preferences like walk 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.

    →‍SituationFullRef

    0:*

    →‍SituationFullRef

    Reference to situation message. Message details might be found in response context or through other communication channels.

    Extension

    0:1

    xs:anyType

    10.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:

    Duration

    1:1

    xs:duration

    Duration of this leg according to user preferences like walk 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.

    →‍SituationFullRef

    0:*

    →‍SituationFullRef

    Reference to situation message. Message details might be found in response context or through other communication channels.

    Extension

    0:1

    xs:anyType

    11.19. The complex type LegBoardStructure

    @@ -758,7 +772,7 @@

    OJP - Open API for distributed Journey

    -

    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:

    StopPoint

    →‍siri:StopPointRef

    1:1

    →‍siri:StopPointRef

    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. F.e. "opposite main entrance".

    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.

    10.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:

    11.20. The complex type LegAlightStructure

    @@ -771,7 +785,7 @@

    OJP - Open API for distributed Journey

    -

    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

    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. F.e. "opposite main entrance".

    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.

    10.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:

    11.21. The complex type LegIntermediateStructure

    @@ -784,18 +798,18 @@

    OJP - Open API for distributed Journey

    -

    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

    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. F.e. "opposite main entrance".

    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.

    10.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

    one or more path guidance sections that build the trip Leg

    10.23. The complex type PathGuidanceSectionStructure

    PathGuidanceSectionStructure

    [an extended definition of a NAVIGATION PATH in TMv6 to include the textual navigation instructions] description of a piece 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

    LINK PROJECTION on the infrastructure network of the TRIP LEG together with time information

    TurnDescription

    0:1

    +InternationalText

    Textual description of a manoeuvre. This should imply the information from Manoeuvre, TurnAction, and TrackSection.RoadName.

    GuidanceAdvice

    0:1

    GuidanceAdvice

    various types of guidance advice given to travelle.

    TurnAction

    0:1

    TurnAction

    the range of alternative turns that can be described.

    DirectionHint

    0:1

    +InternationalText

    Textual direction hint for better understanding, e.g. "follow signs to Hamburg".

    Bearing

    0:1

    siri:AbsoluteBearingType

    Absolute bearing after the described manoeuvre.

    PathLink

    0:1

    +PathLink

    Description of the type of accessibility on this navigation section.

    SituationFullRef

    0:*

    +SituationFullRef

    10.24. 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

    one or more path guidance sections that build the trip Leg

    11.23. The complex type PathGuidanceSectionStructure

    PathGuidanceSectionStructure

    [an extended definition of a NAVIGATION PATH in TMv6 to include the textual navigation instructions] description of a piece 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

    LINK PROJECTION on the infrastructure network of the TRIP LEG together with time information

    TurnDescription

    0:1

    +InternationalText

    Textual description of a manoeuvre. This should imply the information from Manoeuvre, TurnAction, and TrackSection.RoadName.

    GuidanceAdvice

    0:1

    GuidanceAdvice

    various types of guidance advice given to travelle.

    TurnAction

    0:1

    TurnAction

    the range of alternative turns that can be described.

    DirectionHint

    0:1

    +InternationalText

    Textual direction hint for better understanding, e.g. "follow signs to Hamburg".

    Bearing

    0:1

    siri:AbsoluteBearingType

    Absolute bearing after the described manoeuvre.

    PathLink

    0:1

    +PathLink

    Description of the type of accessibility on this navigation section.

    SituationFullRef

    0:*

    +SituationFullRef

    11.24. 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.

    WalkDuration

    0:1

    xs:duration

    Walk time as part of the overall interchange duration.

    BufferTime

    0:1

    xs:duration

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

    10.25. 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.

    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 how often the access feature occurs in this PathLink

    AccessibilityFeature

    0:*

    AccessibilityFeatureTypes

    Presence of an accessibility feature on the PathLink.

    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.

    10.26. 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

    xs:normalizedString

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

    10.27. The MultiPointTripRequestGroup group

    +

    MultiPointTripRequestGroup

    Multi-point trip request structure.

    11.25. 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.

    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 how often the access feature occurs in this PathLink

    AccessibilityFeature

    0:*

    AccessibilityFeatureTypes

    Presence of an accessibility feature on the PathLink.

    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.26. 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

    xs:normalizedString

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

    11.27. The MultiPointTripRequestGroup group

    -

    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.

    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

    Params

    0:1

    +MultiPointTripParam

    Options to control the search behaviour and response contents.

    10.28. The complex type MultiPointTripParamStructure

    +

    MultiPointTripParamStructure

    Multi-point trip request parameter structure.

    The element contains a sequence of the following elements:

    11.28. The complex type MultiPointTripParamStructure

    @@ -840,7 +854,7 @@

    OJP - Open API for distributed Journey

    -

    MultiPointTripParamStructure

    Multi-point trip request parameter structure.

    The element contains a sequence of the following elements:

    TripDataFilter

    PtModeFilter

    0:1

    +PtModeFilter

    Modes (VEHICLE MODE) to be excluded or included in trip calculation.

    LineFilter

    0:1

    +LineDirectionFilter

    Lines/Directions to include/exclude.

    OperatorFilter

    0:1

    +OperatorFilter

    Transport operators to include/exclude.

    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

    Extension

    0:1

    xs:anyType

    10.29. The MultiPointTripPolicyGroup group

    +

    MultiPointTripPolicyGroup

    Policies that control the multi-point trip search behaviour.

    FareParam

    0:1

    +FareParam

    Extension

    0:1

    xs:anyType

    11.29. The MultiPointTripPolicyGroup group

    @@ -852,26 +866,26 @@

    OJP - Open API for distributed Journey

    -

    MultiPointTripPolicyGroup

    Policies that control the multi-point trip search behaviour.

    The element contains one of the following elements:

    NumberOfResults

    a

    NumberOfResultsBefore

    1:1

    xs:nonNegativeInteger

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

    MultiPointTripPolicy

    TransferLimit

    0:1

    xs:nonNegativeInteger

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

    OptimisationMethod

    0:1

    OptimisationMethod

    the types of algorithm that can be used for planning a journey (fastest, least walking, etc)

    MultiPointType

    0: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.

    10.30. The MultiPointTripResponseGroup group

    +

    MultiPointTripResponseGroup

    Multi-point trip response structure.

    11.30. The MultiPointTripResponseGroup group

    -

    MultiPointTripResponseGroup

    Multi-point trip response structure.

    MultiPointTripResponse

    MultiPointTripResponseContext

    0:1

    +ResponseContext

    Context to hold trip response objects that occur frequently.

    MultiPointTripResult

    0:*

    +MultiPointTripResult

    The trip results found by the server.

    10.31. The complex type MultiPointTripResultStructure

    +

    MultiPointTripResultStructure

    Structure for a multipoint trip result and associated problems

    The element contains a sequence of the following elements:

    ResultId

    1:1

    xs:NMTOKEN

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

    Problem

    0:*

    +TripProblem

    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

    11.31. The complex type MultiPointTripResultStructure

    -

    MultiPointTripResultStructure

    Structure for a multipoint trip result and associated problems

    The element contains a sequence of the following elements:

    ResultId

    1:1

    xs:NMTOKEN

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

    Problem

    0:*

    +TripProblem

    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

    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.

    TripFare

    0:*

    +TripFareResult

    10.32. The MultiPointWaitTimeGroup group

    +

    MultiPointWaitTimeGroup

    Group for wait times at origin/destination.

    TripFare

    0:*

    +TripFareResult

    11.32. 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.

    10.33. The TripStatusGroup group

    +

    TripStatusGroup

    Parameters which describe the current status of a TRIP

    11.33. The TripStatusGroup group

    -

    TripStatusGroup

    Parameters which describe the current status of a TRIP

    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.

    10.34. The TripRefineRequestGroup group

    +

    TripRefineRequestGroup

    Trip refinement request structure.

    11.34. The TripRefineRequestGroup group

    -

    TripRefineRequestGroup

    Trip refinement request structure.

    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.

    10.35. 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:*

    xs:NMTOKEN

    Refers to a leg to be refined by the server.

    11.35. The complex type TripRefineParamStructure

    @@ -884,22 +898,22 @@

    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:*

    xs:NMTOKEN

    Refers to a leg to be refined by the server.

    BaseTripContentFilter

    IncludeTrackSections

    0:1

    xs:boolean

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

    IncludeLegProjection

    0:1

    xs:boolean

    Whether the result should include the geographic projection (coordinates) of each journey leg.

    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

    10.36. The TripRefineResponseGroup group

    +

    TripRefineResponseGroup

    Trip refinement response structure.

    FareParam

    0:1

    +FareParam

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

    Extension

    0:1

    xs:anyType

    11.36. The TripRefineResponseGroup group

    -

    TripRefineResponseGroup

    Trip refinement response structure.

    TripRefineResponse

    TripResponseContext

    0:1

    +ResponseContext

    Context to hold trip response objects that occur frequently.

    UnknownLegRef

    0:*

    xs:NMTOKEN

    Refers to a leg that was not found in the data of the server. If the to be refined TripResult could not be found or unequivocally determined, all RefineLegRefs are returned as UnknownLegRefs.

    TripResult

    0:*

    +TripResult

    The trip results refined by the server.

    10.37. The complex type TripProblemStructure

    +

    TripProblemStructure

    Problem that may be returned in responses to trip requests.

    The element contains a sequence of the following elements:

    Type

    1:1

    TripProblemType

    Type of the trip problem.

    11.37. The complex type TripProblemStructure

    TripProblemStructure

    Problem that may be returned in responses to trip requests.

    The element contains a sequence of the following elements:

    Type

    1:1

    TripProblemType

    Type of the trip problem.

    ProblemDetail

    Title

    0:1

    +InternationalText

    Title of the problem.

    Details

    0:1

    +InternationalText

    Explanation of the problem.

    LogData

    0:1

    xs:string

    Additional log data.

    -

    11. OJP/OJP_JourneySupport.xsd - Supporting definitions for journeys on public transport vehicles

    11.1. Simple type definitions

    ReservationNeededEnumeration

    none | service | stop

    Possible types of reservation needed for services.

    VehicleProgressEnumeration

    Not yet operated | Operation finished | At stop | Between stops

    Vehicle progress relative to timetable service pattern.

    11.2. The complex type ServiceViaPointStructure

    +

    12. OJP/OJP_JourneySupport.xsd - Supporting definitions for journeys on public transport vehicles

    12.1. Simple type definitions

    ServiceViaPointStructure

    [a specialisation of VIA in TMv6] STOP PLACE or SCHEDULED STOP POINT as a VIA for a particular SERVICE PATTERN. Specialisation of a VIA.

    The element contains a sequence of the following elements:

    ReservationNeededEnumeration

    none | service | stop

    Possible types of reservation needed for services.

    VehicleProgressEnumeration

    Not yet operated | Operation finished | At stop | Between stops

    Vehicle progress relative to timetable service pattern.

    12.2. The complex type ServiceViaPointStructure

    -

    ServiceViaPointStructure

    [a specialisation of VIA in TMv6] STOP PLACE or SCHEDULED STOP POINT as a VIA for a particular SERVICE PATTERN. Specialisation of a VIA.

    The element contains a sequence of the following elements:

    StopPoint

    →‍siri:StopPointRef

    1:1

    →‍siri:StopPointRef

    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. F.e. "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.

    11.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".

    11.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.

    11.5. The ScheduledJourneyGroup group

    +

    ScheduledJourneyGroup

    Vehicle journey (not dated).

    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 ScheduledJourneyGroup group

    @@ -914,7 +928,7 @@

    OJP - Open API for distributed Journey

    -

    ScheduledJourneyGroup

    Vehicle journey (not dated).

    ScheduledJourney

    →‍JourneyRef

    1:1

    →‍JourneyRef

    Reference to a Journey

    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".

    Via

    0:*

    +ServiceViaPoint

    Via points of the service that may help identify the vehicle to the public.

    Attribute

    0:*

    +GeneralAttribute

    Note or service attribute.

    11.6. The ServiceGroup group

    +

    ServiceGroup

    Properties of a service (line and direction): attributes of Continuous Journey Structure or Dated Journey Structure.

    12.6. The ServiceGroup group

    @@ -925,15 +939,15 @@

    OJP - Open API for distributed Journey

    -

    ServiceGroup

    Properties of a service (line and direction): attributes of Continuous Journey Structure or Dated Journey Structure.

    →‍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.

    RouteDescription

    0:1

    +InternationalText

    Descriptive text for a route, f.e. "Airport via City Centre"

    Via

    0:*

    +ServiceViaPoint

    Via points of the service that may help identify the vehicle to the public.

    Attribute

    0:*

    +GeneralAttribute

    Note or service attribute.

    11.7. The ServiceOriginGroup group

    +

    ServiceOriginGroup

    First serviced stop of a vehicle journey.

    12.7. The ServiceOriginGroup group

    -

    ServiceOriginGroup

    First serviced stop of a vehicle journey.

    ServiceOrigin

    OriginStopPointRef

    0:1

    siri:StopPointRefStructure

    First stop of the vehicle journey; origin stop point.

    OriginText

    1:1

    +InternationalText

    Label for first stop.

    11.8. The ServiceDestinationGroup group

    +

    ServiceDestinationGroup

    Last serviced stop of a vehicle journey.

    12.8. The ServiceDestinationGroup group

    -

    ServiceDestinationGroup

    Last serviced stop of a vehicle journey.

    ServiceDestination

    DestinationStopPointRef

    0:1

    siri:StopPointRefStructure

    Last stop of vehicle journey; destination stop point.

    DestinationText

    1:1

    +InternationalText

    Label for last stop.

    11.9. The RouteDescriptionGroup group

    +

    RouteDescriptionGroup

    Descriptive text for a route, f.e. "Airport via City Centre"

    12.9. The RouteDescriptionGroup group

    -

    RouteDescriptionGroup

    Descriptive text for a route, f.e. "Airport via City Centre"

    RouteDescription

    RouteDescriptionText

    1:1

    +InternationalText

    11.10. The DatedJourneyGroup group

    +

    DatedJourneyGroup

    Vehicle journey that runs at a specific date.

    12.10. The DatedJourneyGroup group

    @@ -952,12 +966,12 @@

    OJP - Open API for distributed Journey

    -

    DatedJourneyGroup

    Vehicle journey that runs at a specific date.

    DatedJourney

    →‍OperatingDayRef

    1:1

    →‍OperatingDayRef

    Reference to an Operating Day

    →‍siri:VehicleRef

    0:1

    →‍siri:VehicleRef

    Attribute

    0:*

    +GeneralAttribute

    Note or service attribute.

    11.11. The PrivateServiceGroup group

    +

    PrivateServiceGroup

    specific service operated by a Private Mode

    12.11. The PrivateServiceGroup group

    -

    PrivateServiceGroup

    specific service operated by a Private Mode

    PrivateService

    →‍JourneyRef

    0:1

    →‍JourneyRef

    Reference to a Journey

    PrivateMode

    1:1

    PrivateModes

    [a category of MODE in TMv6] MODEs offered by private individuals

    OrganisationRef

    0:1

    siri:OperatorRefStructure

    InfoUrl

    0:1

    +WebLink

    Link to web page providing more details on service.

    11.12. The complex type DatedJourneyStructure

    +

    DatedJourneyStructure

    [equivalent to DATED VEHICLE JOURNEY in TMv6] passenger carrying VEHICLE JOURNEY for one specified DAY TYPE for which the pattern of working is in principle defined by a SERVICE JOURNEY PATTERN. DatedJourney details of a service include its operating days.

    The element contains a sequence of the following elements:

    Then, the element contains one of the following elements:

    12.12. The complex type DatedJourneyStructure

    @@ -992,10 +1006,10 @@

    OJP - Open API for distributed Journey

    -

    DatedJourneyStructure

    [equivalent to DATED VEHICLE JOURNEY in TMv6] passenger carrying VEHICLE JOURNEY for one specified DAY TYPE for which the pattern of working is in principle defined by a SERVICE JOURNEY PATTERN. DatedJourney details of a service include its operating days.

    The element contains a sequence of the following elements:

    Then, the element contains one of the following elements:

    DatedJourney

    a

    →‍OperatingDayRef

    1:1

    →‍OperatingDayRef

    Reference to an Operating Day

    a

    →‍siri:VehicleRef

    0:1

    →‍siri:VehicleRef

    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.

    Occupancy

    0:1

    siri:OccupancyEnumeration

    [equivalent to OCCUPANCY in SIRI] passenger load status of a VEHICLE. If omitted, not known.

    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.

    →‍SituationFullRef

    0:*

    →‍SituationFullRef

    Reference to situation message. Message details might be found in response context or through other communication channels.

    Extension

    0:1

    xs:anyType

    11.13. The complex type TripPlaceStructure

    TripPlaceStructure

    A trip place represents the current logical position of a journey service. It can be used similarly to a place e.g. for starting a new trip requests from within this service. A trip place 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

    11.14. The TimeWindowGroup group

    +

    TimeWindowGroup

    The window of opportunity that the traveller has to perform this leg of the journey.

    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.

    →‍SituationFullRef

    0:*

    →‍SituationFullRef

    Reference to situation message. Message details might be found in response context or through other communication channels.

    Extension

    0:1

    xs:anyType

    12.13. The complex type TripPlaceStructure

    TripPlaceStructure

    A trip place represents the current logical position of a journey service. It can be used similarly to a place e.g. for starting a new trip requests from within this service. A trip place 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.14. The TimeWindowGroup group

    -

    TimeWindowGroup

    The window of opportunity that the traveller has to perform this leg of the journey.

    TimeWindow

    TimeWindowStart

    0:1

    xs:dateTime

    Time at which window begins.

    TimeWindowEnd

    0:1

    xs:dateTime

    Time at which window ends.

    11.15. The ServiceTimeGroup group

    +

    ServiceTimeGroup

    Contains at least scheduled time, but can contain real time and estimated times

    12.15. The ServiceTimeGroup group

    @@ -1003,10 +1017,10 @@

    OJP - Open API for distributed Journey

    -

    ServiceTimeGroup

    Contains at least scheduled time, but can contain real time and estimated times

    ServiceTime

    TimetabledTime

    1:1

    xs:dateTime

    time at point as it is published

    RecordedAtTime

    0:1

    xs:dateTime

    time as it was recorded

    EstimatedTime

    0:1

    xs:dateTime

    estimated time (for prognosis)

    EstimatedTimeBand

    EstimatedTimeLow

    0:1

    xs:dateTime

    Estimated lower limit for time.

    EstimatedTimeHigh

    0:1

    xs:dateTime

    Estimated upper limit for time.

    11.16. The EstimatedTimeBandGroup group

    +

    EstimatedTimeBandGroup

    Range for estimated time.

    12.16. The EstimatedTimeBandGroup group

    -

    EstimatedTimeBandGroup

    Range for estimated time.

    EstimatedTimeBand

    EstimatedTimeLow

    0:1

    xs:dateTime

    Estimated lower limit for time.

    EstimatedTimeHigh

    0:1

    xs:dateTime

    Estimated upper limit for time.

    11.17. The complex type ServiceArrivalStructure

    +

    ServiceArrivalStructure

    Arrival times of a service at a stop (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME).

    The element contains only one element:

    12.17. The complex type ServiceArrivalStructure

    @@ -1014,7 +1028,7 @@

    OJP - Open API for distributed Journey

    -

    ServiceArrivalStructure

    Arrival times of a service at a stop (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME).

    The element contains only one element:

    ServiceTime

    TimetabledTime

    1:1

    xs:dateTime

    time at point as it is published

    RecordedAtTime

    0:1

    xs:dateTime

    time as it was recorded

    EstimatedTime

    0:1

    xs:dateTime

    estimated time (for prognosis)

    EstimatedTimeBand

    EstimatedTimeLow

    0:1

    xs:dateTime

    Estimated lower limit for time.

    EstimatedTimeHigh

    0:1

    xs:dateTime

    Estimated upper limit for time.

    11.18. The complex type ServiceDepartureStructure

    +

    ServiceDepartureStructure

    Departure times of a service at a stop (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME).

    The element contains only one element:

    12.18. The complex type ServiceDepartureStructure

    @@ -1022,7 +1036,7 @@

    OJP - Open API for distributed Journey

    -

    ServiceDepartureStructure

    Departure times of a service at a stop (group of attributes of TIMETABLED PASSING TIME, ESTIMATED PASSING TIME, OBSERVED PASSING TIME).

    The element contains only one element:

    ServiceTime

    TimetabledTime

    1:1

    xs:dateTime

    time at point as it is published

    RecordedAtTime

    0:1

    xs:dateTime

    time as it was recorded

    EstimatedTime

    0:1

    xs:dateTime

    estimated time (for prognosis)

    EstimatedTimeBand

    EstimatedTimeLow

    0:1

    xs:dateTime

    Estimated lower limit for time.

    EstimatedTimeHigh

    0:1

    xs:dateTime

    Estimated upper limit for time.

    11.19. The complex type CallAtStopStructure

    +

    CallAtStopStructure

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

    The element contains a sequence of the following elements:

    12.19. The complex type CallAtStopStructure

    @@ -1035,19 +1049,19 @@

    OJP - Open API for distributed Journey

    -

    CallAtStopStructure

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

    The element contains a sequence of the following elements:

    StopPoint

    →‍siri:StopPointRef

    1:1

    →‍siri:StopPointRef

    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. F.e. "opposite main entrance".

    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.

    →‍SituationFullRef

    0:*

    →‍SituationFullRef

    Reference to situation message. Message details might be found in response context or through other communication channels.

    11.20. The StopCallStatusGroup group

    +

    StopCallStatusGroup

    Status properties for the vehicle call at this stop.

    →‍SituationFullRef

    0:*

    →‍SituationFullRef

    Reference to situation message. Message details might be found in response context or through other communication channels.

    12.20. The StopCallStatusGroup group

    -

    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.

    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.

    11.21. The ServiceStatusGroup group

    +

    ServiceStatusGroup

    parameters which describe the current status of a DATED VEHICLE JOURNEY

    12.21. The ServiceStatusGroup group

    -

    ServiceStatusGroup

    parameters which describe the current 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.

    Occupancy

    0:1

    siri:OccupancyEnumeration

    [equivalent to OCCUPANCY in SIRI] passenger load status of a VEHICLE. If omitted, not known.

    11.22. The complex type ContinuousServiceStructure

    +

    ContinuousServiceStructure

    [a special form of SERVICE JOURNEY in TMv6] a vehicle movement on a continuous, non-timetabled service.

    The element contains a sequence of the following elements:

    Then, the element contains one of the following elements:

    a

    ContinuousMode

    -1:1

    ContinuousModes

    Continuous transport options.

    b

    IndividualMode

    -1:1

    IndividualModes

    Individual transport options.

    Then, the element contains one of the following elements:

    12.22. The complex type ContinuousServiceStructure

    @@ -1072,36 +1086,36 @@

    OJP - Open API for distributed Journey

    -

    ContinuousServiceStructure

    [a special form of SERVICE JOURNEY in TMv6] a vehicle movement on a continuous, non-timetabled service.

    The element contains a sequence of the following elements:

    Then, the element contains one of the following elements:

    a

    ContinuousMode

    -1:1

    ContinuousModes

    Continuous transport options.

    b

    IndividualMode

    -1:1

    IndividualModes

    Individual transport options.

    Then, the element contains one of the following elements:

    DatedJourney

    a

    →‍OperatingDayRef

    1:1

    →‍OperatingDayRef

    Reference to an Operating Day

    a

    →‍siri:VehicleRef

    0:1

    →‍siri:VehicleRef

    ServiceDestination

    DestinationStopPointRef

    0:1

    siri:StopPointRefStructure

    Last stop of vehicle journey; destination stop point.

    DestinationText

    1:1

    +InternationalText

    Label for last stop.

    BookingArrangements

    0:1

    +BookingArrangementsContainer

    Container with information on booking possibilities for this service.

    →‍SituationFullRef

    0:*

    →‍SituationFullRef

    Reference to situation message. Message details might be found in response context or through other communication channels.

    Extension

    0:1

    xs:anyType

    11.23. 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.

    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.

    11.24. 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

    TripPlace

    -1:1

    +TripPlace

    Place 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 place is required.

    b

    TimeAllowance

    -0:1

    xs:duration

    Extra time needed before reaching/after leaving this place.

    IndividualTransportOptions

    0:*

    +IndividualTransportOptions

    Options how to access/leave the place by individual transport.

    11.25. 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

    BookingArrangements

    0:1

    +BookingArrangementsContainer

    Container with information on booking possibilities for this service.

    →‍SituationFullRef

    0:*

    →‍SituationFullRef

    Reference to situation message. Message details might be found in response context or through other communication channels.

    Extension

    0:1

    xs:anyType

    12.23. 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.

    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.24. 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

    TripPlace

    -1:1

    +TripPlace

    Place 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 place is required.

    b

    TimeAllowance

    -0:1

    xs:duration

    Extra time needed before reaching/after leaving this place.

    IndividualTransportOptions

    0:*

    +IndividualTransportOptions

    Options how to access/leave the place by individual transport.

    12.25. 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

    1:1

    xs:nonNegativeInteger

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

    NumberOfResultsAfter

    1:1

    xs:nonNegativeInteger

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

    11.26. The BaseTripPolicyGroup group

    +

    BaseTripPolicyGroup

    Policies that control the trip search behaviour for both public and individual transport.

    12.26. The BaseTripPolicyGroup group

    -

    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

    1:1

    xs:nonNegativeInteger

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

    a

    NumberOfResultsAfter

    1: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.

    IgnoreRealtimeData

    0:1

    xs:boolean

    The trip calculation should not use any realtime or incident data.

    ImmediateTripStart

    0:1

    xs:boolean

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

    11.27. The BaseTripMobilityFilterGroup group

    +

    BaseTripMobilityFilterGroup

    Base mobility options to be applied for both public and individual transport.

    12.27. The BaseTripMobilityFilterGroup group

    -

    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 climb one step.

    NoStairs

    0:1

    xs:boolean

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

    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 an ramp.

    NoSight

    0:1

    xs:boolean

    The user is not able to see.

    11.28. The BaseTripContentFilterGroup group

    +

    BaseTripContentFilterGroup

    Parameters to control the level of detail of both public and individual transport journey results.

    12.28. The BaseTripContentFilterGroup group

    -

    BaseTripContentFilterGroup

    Parameters to control the level of detail of both public and individual transport journey results.

    BaseTripContentFilter

    IncludeTrackSections

    0:1

    xs:boolean

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

    IncludeLegProjection

    0:1

    xs:boolean

    Whether the result should include the geographic projection (coordinates) of each journey leg.

    IncludeTurnDescription

    0:1

    xs:boolean

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

    IncludeAccessibility

    0:1

    xs:boolean

    Whether the result should include accessibility information.

    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

    11.29. 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)

    12.29. 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.

    11.30. 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

    LINK PROJECTION on the infrastructure network of the trip leg section together with time information.

    11.31. The complex type TrackSectionStructure

    TrackSectionStructure

    LINK PROJECTION on the infrastructure network of the TRIP LEG together with time information

    The element contains a sequence of the following elements:

    TrackStart

    0:1

    +PlaceRef

    Start place of this track.

    TrackEnd

    0:1

    +PlaceRef

    End place of this track.

    LinkProjection

    0:1

    +LinkProjection

    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.

    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. OJP/OJP_Availability.xsd - Request and response definitions for availability of tickets and services on a journey leg.

    12.1. Simple type definitions

    AvailabilityProblemTypeEnumeration

    AVAILIBILITY_NOSERIVCEFOUND | 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.

    12.2. The AvailabilityRequestGroup group

    +

    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.

    12.30. 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

    LINK PROJECTION on the infrastructure network of the trip leg section together with time information.

    12.31. The complex type TrackSectionStructure

    TrackSectionStructure

    LINK PROJECTION on the infrastructure network of the TRIP LEG together with time information

    The element contains a sequence of the following elements:

    TrackStart

    0:1

    +PlaceRef

    Start place of this track.

    TrackEnd

    0:1

    +PlaceRef

    End place of this 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.

    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

    AVAILIBILITY_NOSERIVCEFOUND | 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

    @@ -1109,7 +1123,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.

    LatestArrivalTime

    0:1

    xs:dateTime

    AvailabilityRequest

    Extension

    0:1

    xs:anyType

    12.3. The complex type BookingPTLegStructure

    +

    BookingPTLegStructure

    Journey leg by public transport.

    The element contains a sequence of the following elements:

    PickUpLocation

    1:1

    +ProvisionedCallAtPlace

    Location where passenger intends to enter the service.

    SetDownLocation

    1:1

    +ProvisionedCallAtPlace

    Location where passenger intends to leave the service.

    13.3. The complex type BookingPTLegStructure

    @@ -1120,7 +1134,7 @@

    OJP - Open API for distributed Journey

    -

    BookingPTLegStructure

    Journey leg by public transport.

    The element contains a sequence of the following elements:

    PickUpLocation

    1:1

    +ProvisionedCallAtPlace

    Location where passenger intends to enter the service.

    SetDownLocation

    1:1

    +ProvisionedCallAtPlace

    Location where passenger intends to leave the service.

    →‍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.

    RouteDescription

    0:1

    +InternationalText

    Descriptive text for a route, f.e. "Airport via City Centre"

    Via

    0:*

    +ServiceViaPoint

    Via points of the service that may help identify the vehicle to the public.

    Attribute

    0:*

    +GeneralAttribute

    Note or service attribute.

    Extension

    0:1

    xs:anyType

    12.4. The complex type BookingUserStructure

    +

    BookingUserStructure

    Passenger(s) for whom the service needs to be booked.

    The element contains a sequence of the following elements:

    Age

    0:1

    xs:nonNegativeInteger

    Age of the passenger on the day of travel.

    Extension

    0:1

    xs:anyType

    13.4. The complex type BookingUserStructure

    @@ -1149,7 +1163,7 @@

    OJP - Open API for distributed Journey

    -

    BookingUserStructure

    Passenger(s) for whom the service needs to be booked.

    The element contains a sequence of the following elements:

    Age

    0:1

    xs:nonNegativeInteger

    Age of the passenger on the day of travel.

    PassengerProfile

    WheelchairUser

    0:1

    xs:boolean

    Passenger uses a wheelchair. Default is FALSE.

    WalkingFrame

    0:1

    xs:boolean

    Passenger uses a walking frame. Default is FALSE.

    WalkingStick

    0:1

    xs:boolean

    Passenger uses a walking stick. Default is FALSE.

    DriverAssistance

    BoardingAssistance

    0:1

    xs:boolean

    Whether assistance is required for boarding. Could be offered by the driver or station staff. Default is FALSE.

    AlightingAssistance

    0:1

    xs:boolean

    Whether assistance is required for alighting. Could be offered by the driver or station staff. Default is FALSE.

    12.5. The complex type ProvisionedCallAtPlaceStructure

    +

    ProvisionedCallAtPlaceStructure

    Provisioned vehicle call at a general location.

    The element contains a sequence of the following elements:

    13.5. The complex type ProvisionedCallAtPlaceStructure

    @@ -1159,10 +1173,10 @@

    OJP - Open API for distributed Journey

    -

    ProvisionedCallAtPlaceStructure

    Provisioned vehicle call at a general location.

    The element contains a sequence of the following elements:

    DatedJourneyRef

    →‍JourneyRef

    1:1

    →‍JourneyRef

    Reference to a Journey

    →‍OperatingDayRef

    1:1

    →‍OperatingDayRef

    Reference to an Operating Day

    CallPlace

    1:1

    +PlaceRef

    More general location for a call than stop points. May be used with flexible services or "Area Dial-A-Ride".

    ServiceArrival

    0:1

    +ServiceArrival

    Arrival times of the service at this stop.

    ServiceDeparture

    0:1

    +ServiceDeparture

    Departure times of the service at this stop.

    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.

    12.6. The MinMaxTimeBandGroup group

    +

    MinMaxTimeBandGroup

    Earliest possible departure time from a start location and latest possible arrival at a different destination location.

    13.6. The MinMaxTimeBandGroup group

    -

    MinMaxTimeBandGroup

    Earliest possible departure time from a start location and latest possible arrival at a different destination location.

    MinMaxTimeBand

    EarliestDepartureTime

    0:1

    xs:dateTime

    LatestArrivalTime

    0:1

    xs:dateTime

    12.7. The PassengerProfileGroup group

    +

    PassengerProfileGroup

    Profile of the passenger's abilities.

    13.7. The PassengerProfileGroup group

    @@ -1172,7 +1186,7 @@

    OJP - Open API for distributed Journey

    -

    PassengerProfileGroup

    Profile of the passenger's abilities.

    PassengerProfile

    WheelchairUser

    0:1

    xs:boolean

    Passenger uses a wheelchair. Default is FALSE.

    WalkingFrame

    0:1

    xs:boolean

    Passenger uses a walking frame. Default is FALSE.

    WalkingStick

    0:1

    xs:boolean

    Passenger uses a walking stick. Default is FALSE.

    VisuallyImpaired

    0:1

    xs:boolean

    Passenger is visually impaired.

    HearingImpaired

    0:1

    xs:boolean

    Passenger is hearing impaired.

    ReadingImpaired

    0:1

    xs:boolean

    Passenger is reading impaired.

    12.8. The PassengerRequirementsGroup group

    +

    PassengerRequirementsGroup

    Description of passenger's accessibility requirements

    13.8. The PassengerRequirementsGroup group

    @@ -1191,73 +1205,73 @@

    OJP - Open API for distributed Journey

    -

    PassengerRequirementsGroup

    Description of passenger's accessibility requirements

    BaseTripMobilityFilter

    NoSingleStep

    0:1

    xs:boolean

    The user is not able to climb one step.

    DriverAssistance

    BoardingAssistance

    0:1

    xs:boolean

    Whether assistance is required for boarding. Could be offered by the driver or station staff. Default is FALSE.

    AlightingAssistance

    0:1

    xs:boolean

    Whether assistance is required for alighting. Could be offered by the driver or station staff. Default is FALSE.

    12.9. The DriverAssistanceGroup group

    +

    DriverAssistanceGroup

    Requirements for the driver/staff to assist the passenger when boarding/alighting.

    13.9. The DriverAssistanceGroup group

    -

    DriverAssistanceGroup

    Requirements for the driver/staff to assist the passenger when boarding/alighting.

    DriverAssistance

    BoardingAssistance

    0:1

    xs:boolean

    Whether assistance is required for boarding. Could be offered by the driver or station staff. Default is FALSE.

    AlightingAssistance

    0:1

    xs:boolean

    Whether assistance is required for alighting. Could be offered by the driver or station staff. Default is FALSE.

    12.10. The AvailabilityResponseGroup group

    +

    AvailabilityResponseGroup

    Availability response.

    13.10. The AvailabilityResponseGroup group

    -

    AvailabilityResponseGroup

    Availability response.

    AvailabilityResponse

    AvailabilityResult

    0:1

    +AvailabilityResult

    Indication of the availability of the requested service.

    Extension

    0:1

    xs:anyType

    12.11. The complex type AvailabilityResultStructure

    +

    AvailabilityResultStructure

    Availability result structure.

    The element contains a sequence of the following elements:

    Problem

    0:*

    +AvailabilityProblem

    Problems related to this AVAILABILITY result.

    13.11. The complex type AvailabilityResultStructure

    -

    AvailabilityResultStructure

    Availability result structure.

    The element contains a sequence of the following elements:

    Problem

    0:*

    +AvailabilityProblem

    Problems related to this AVAILABILITY result.

    b

    PublicTransport

    -1:1

    +BookingPTLeg

    Definition of the journey leg that should be made by public transport. Other mobility services may be added later.

    BookableTicketAndServiceInformation

    BookableTicket

    0:*

    +FareProduct

    Sequence of bookable tickets or surcharges for this part of the trip. If ticket price is zero: an already purchased/virtual ticket of this type presented to the driver would be accepted.

    BookableServiceItem

    0:*

    +BookableServiceItem

    Sequence of bookable service items for this part of the trip.

    Extension

    0:1

    xs:anyType

    12.12. The BookableTicketAndServiceInformationGroup group

    +

    BookableTicketAndServiceInformationGroup

    Lists those tickets or surcharges and service characteristics such as the transportation of wheelchairs, prams, luggage etc. or the provision of required child seats or booster seats that are offered in the trips transport company to be booked for the trip.

    Extension

    0:1

    xs:anyType

    13.12. The BookableTicketAndServiceInformationGroup group

    -

    BookableTicketAndServiceInformationGroup

    Lists those tickets or surcharges and service characteristics such as the transportation of wheelchairs, prams, luggage etc. or the provision of required child seats or booster seats that are offered in the trips transport company to be booked for the trip.

    BookableTicketAndServiceInformation

    BookableTicket

    0:*

    +FareProduct

    Sequence of bookable tickets or surcharges for this part of the trip. If ticket price is zero: an already purchased/virtual ticket of this type presented to the driver would be accepted.

    BookableServiceItem

    0:*

    +BookableServiceItem

    Sequence of bookable service items for this part of the trip.

    12.13. The complex type BookableServiceItemStructure

    BookableServiceItemStructure

    Possible service items that can be booked in the actual booking system (defined by the traffic company of charge). Only those elements with value greater 0 are bookable. The indicated capacity corresponds to the maximum number that can be booked in one booking. This number does not have to be available for the specific booking and may result in booking failure. Caution: list can vary widely from one traffic company to another.

    The element contains a sequence of the following elements:

    Type

    1:1

    BookableServiceItemType

    The type of bookable service.

    MaxBookableCapacity

    1:1

    xs:nonNegativeInteger

    Maximum number of service items that can be booked in one booking transaction. Default is 0.

    12.14. The complex type AvailabilityProblemStructure

    +

    AvailabilityProblemStructure

    Problem that may be returned in responses to AVAILABILITY requests.

    The element contains a sequence of the following elements:

    Type

    1:1

    AvailabilityProblemType

    Type of the AVAILABILITY problem.

    13.13. The complex type BookableServiceItemStructure

    BookableServiceItemStructure

    Possible service items that can be booked in the actual booking system (defined by the traffic company of charge). Only those elements with value greater 0 are bookable. The indicated capacity corresponds to the maximum number that can be booked in one booking. This number does not have to be available for the specific booking and may result in booking failure. Caution: list can vary widely from one traffic company to another.

    The element contains a sequence of the following elements:

    Type

    1:1

    BookableServiceItemType

    The type of bookable service.

    MaxBookableCapacity

    1:1

    xs:nonNegativeInteger

    Maximum number of service items that can be booked in one booking transaction. Default is 0.

    13.14. The complex type AvailabilityProblemStructure

    AvailabilityProblemStructure

    Problem that may be returned in responses to AVAILABILITY requests.

    The element contains a sequence of the following elements:

    Type

    1:1

    AvailabilityProblemType

    Type of the AVAILABILITY problem.

    ProblemDetail

    Title

    0:1

    +InternationalText

    Title of the problem.

    Details

    0:1

    +InternationalText

    Explanation of the problem.

    LogData

    0:1

    xs:string

    Additional log data.

    -

    13. OJP/OJP_Common.xsd - Supporting definitions of common structures

    13.1. Simple type definitions

    JourneyCodeType

    xs:NMTOKEN

    Identifier of a Journey

    OperatingDayCodeType

    xs:NMTOKEN

    Identifier of an Operating Day

    OwnerCodeType

    xs:NMTOKEN

    identifier of ORGANISATION with ownership as the RESPONSIBILITY ROLE

    ProductCategoryCodeType

    xs:NMTOKEN

    Type for identifier of an product category code.

    SharingModelEnumeration

    singleStationBased | multipleStationBased | nonStationBased

    Sharing service loan and return scheme.

    WeekdayTypeEnumeration

    Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday | PublicHoliday

    [a specialisation of DAY OF WEEK in TMv6] enumeration of individual the seven DAYs OF WEEK, along with public holidays

    13.2. The ProblemDetailGroup group

    +

    14. OJP/OJP_Common.xsd - Supporting definitions of common structures

    14.1. Simple type definitions

    ProblemDetailGroup

    Detailed description of the problem.

    JourneyCodeType

    xs:NMTOKEN

    Identifier of a Journey

    OperatingDayCodeType

    xs:NMTOKEN

    Identifier of an Operating Day

    OwnerCodeType

    xs:NMTOKEN

    identifier of ORGANISATION with ownership as the RESPONSIBILITY ROLE

    ProductCategoryCodeType

    xs:NMTOKEN

    Type for identifier of an product category code.

    SharingModelEnumeration

    singleStationBased | multipleStationBased | nonStationBased

    Sharing service loan and return scheme.

    WeekdayTypeEnumeration

    Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday | PublicHoliday

    [a specialisation of DAY OF WEEK in TMv6] enumeration of individual the seven DAYs OF WEEK, along with public holidays

    14.2. The ProblemDetailGroup group

    -

    ProblemDetailGroup

    Detailed description of the problem.

    ProblemDetail

    Title

    0:1

    +InternationalText

    Title of the problem.

    Details

    0:1

    +InternationalText

    Explanation of the problem.

    LogData

    0:1

    xs:string

    Additional log data.

    13.3. 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.

    13.4. The complex type LinkProjectionStructure

    LinkProjectionStructure

    An oriented correspondence from one LINK of a source layer, onto an entity in a target layer: e.g. LINK SEQUENCE.

    The element contains only one element:

    Position

    2:*

    siri:LocationStructure

    Ordered list of locations representing the geogemtry of the link.

    13.5. 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.

    13.6. 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))

    13.7. The toplevel element OperatorRef

    OperatorRef

    siri:OperatorRefStructure

    Reference to an Operator ([TMv6] company providing public transport services.)

    13.8. 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

    13.9. The complex type ProductCategoryRefStructure

    ProductCategoryRefStructure

    ProductCategoryCode

    Reference to a product category. 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, e.g. to identify boats that run with steam in Switzerland ("BAV")

    13.10. 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)

    13.11. 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 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.

    13.12. The complex type JourneyRefStructure

    JourneyRefStructure

    JourneyCode

    Reference to a Journey

    13.13. The toplevel element JourneyRef

    JourneyRef

    +JourneyRef

    Reference to a Journey

    13.14. The DatedJourneyRefGroup group

    +

    DatedJourneyRefGroup

    Reference to a DATED VEHICLE JOURNEY (Reference to a journey on a specific operating day)

    14.3. 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.4. 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.5. 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.6. 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.7. The toplevel element OperatorRef

    OperatorRef

    siri:OperatorRefStructure

    Reference to an Operator ([TMv6] company providing public transport services.)

    14.8. 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.9. The complex type ProductCategoryRefStructure

    ProductCategoryRefStructure

    ProductCategoryCode

    Reference to a product category. 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, e.g. to identify boats that run with steam in Switzerland ("BAV")

    14.10. 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.11. 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 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.12. The complex type JourneyRefStructure

    JourneyRefStructure

    JourneyCode

    Reference to a Journey

    14.13. The toplevel element JourneyRef

    JourneyRef

    +JourneyRef

    Reference to a Journey

    14.14. 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

    13.15. The TimedVehicleRefGroup group

    +

    TimedVehicleRefGroup

    Reference to a vehicle for a specific point in time.

    14.15. The TimedVehicleRefGroup group

    -

    TimedVehicleRefGroup

    Reference to a vehicle for a specific point in time.

    TimedVehicleRef

    →‍siri:VehicleRef

    1:1

    →‍siri:VehicleRef

    TimeOfOperation

    1:1

    xs:dateTime

    Time stamp when the vehicle is operating. In most use cases equal to "now".

    13.16. The complex type VehicleFilterStructure

    VehicleFilterStructure

    Filter for Vehicles

    The element contains a sequence of the following elements:

    Exclude

    0:1

    xs:boolean

    Whether to include or exclude given VehicleRefs and TRAIN NUMBERS in the list from the search. Default is exclude.

    VehicleRef

    0:*

    siri:VehicleRefStructure

    Reference to VEHICLE

    TrainNumber

    0:*

    xs:normalizedString

    TRAIN NUMBERs

    13.17. The SharingServiceUsageGroup group

    +

    SharingServiceUsageGroup

    Usage parameters of a sharing service.

    14.16. The complex type VehicleFilterStructure

    VehicleFilterStructure

    Filter for Vehicles

    The element contains a sequence of the following elements:

    Exclude

    0:1

    xs:boolean

    Whether to include or exclude given VehicleRefs and TRAIN NUMBERS in the list from the search. Default is exclude.

    VehicleRef

    0:*

    siri:VehicleRefStructure

    Reference to VEHICLE

    TrainNumber

    0:*

    xs:normalizedString

    TRAIN NUMBERs

    14.17. The SharingServiceUsageGroup group

    -

    SharingServiceUsageGroup

    Usage parameters of a sharing service.

    SharingServiceUsage

    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.

    13.18. The complex type SharingServiceStructure

    +

    SharingServiceStructure

    Service that provides shared vehicles.

    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.

    SharingModel

    0:1

    SharingModel

    Type of the sharing scheme.

    14.18. The complex type SharingServiceStructure

    -

    SharingServiceStructure

    Service that provides shared vehicles.

    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.

    SharingModel

    0:1

    SharingModel

    Type of the sharing scheme.

    SharingServiceUsage

    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 web page providing more details on service.

    13.19. The complex type OwnerRefStructure

    OwnerRefStructure

    OwnerCode

    Reference to an ORGANISATION with ownership as the RESPONSIBILITY ROLE

    13.20. The toplevel element OwnerRef

    OwnerRef

    +OwnerRef

    Reference to an ORGANISATION with ownership as the RESPONSIBILITY ROLE

    13.21. The complex type OperatingDayRefStructure

    OperatingDayRefStructure

    OperatingDayCode

    Reference to an Operating Day

    13.22. The toplevel element OperatingDayRef

    OperatingDayRef

    +OperatingDayRef

    Reference to an Operating Day

    13.23. 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.

    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.

    13.24. The OperatingDaysGroup group

    +

    OperatingDaysGroup

    Coded as bit pattern

    InfoUrl

    0:1

    +WebLink

    Link to web page providing more details on service.

    14.19. The complex type OwnerRefStructure

    OwnerRefStructure

    OwnerCode

    Reference to an ORGANISATION with ownership as the RESPONSIBILITY ROLE

    14.20. The toplevel element OwnerRef

    OwnerRef

    +OwnerRef

    Reference to an ORGANISATION with ownership as the RESPONSIBILITY ROLE

    14.21. The complex type OperatingDayRefStructure

    OperatingDayRefStructure

    OperatingDayCode

    Reference to an Operating Day

    14.22. The toplevel element OperatingDayRef

    OperatingDayRef

    +OperatingDayRef

    Reference to an Operating Day

    14.23. 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.

    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.24. 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".

    13.25. 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.

    13.26. 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:

    Text

    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.

    14.25. 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.26. 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:

    Text

    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.

    →‍siri:AllFacilitiesGroup

    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.

    -

    14. OJP/OJP_FacilitySupport.xsd - Supporting definitions for facilities containing wrappers for SIRI

    14.1. The AllFacilitiesGroup group

    +

    15. OJP/OJP_FacilitySupport.xsd - Supporting definitions for facilities containing wrappers for SIRI

    15.1. The AllFacilitiesGroup group

    AllFacilitiesGroup

    Wrapper for SIRI facilities.

    -

    AllFacilitiesGroup

    Wrapper for SIRI facilities.

    →‍siri:AllFacilitiesGroup

    14.2. The StopFacilityGroup group

    +

    StopFacilityGroup

    Wrapper for SIRI stop facilities.

    15.2. The StopFacilityGroup group

    -

    StopFacilityGroup

    Wrapper for SIRI stop facilities.

    →‍siri:StopFacilityGroup

    14.3. The ServiceFacilityGroup group

    +

    ServiceFacilityGroup

    Wrapper for SIRI service facilities.

    15.3. The ServiceFacilityGroup group

    ServiceFacilityGroup

    Wrapper for SIRI service facilities.

    →‍siri:ServiceFacilityGroup

    -

    15. OJP/OJP_ModesSupport.xsd - Supporting definitions for the classification of modes of transport

    15.1. Simple type definitions

    ContinuousModesEnumeration

    walk | demandResponsive | replacementService

    Types of cmodes that run at any time without a timetable.

    IndividualModesEnumeration

    walk | cycle | taxi | self-drive-car | others-drive-car | motorcycle | truck | scooter | ride-pool-car | car-sharing | cycle-sharing | scooter-sharing

    modes which an individual powers themselves (such as walk, cycle)

    PrivateModesEnumeration

    carPooling

    [a category of MODE in TMv6] MODEs offered by private individuals

    TransferModesEnumeration

    walk | parkAndRide | bikeAndRide | carHire | bikeHire | protectedConnection | guaranteedConnection | remainInVehicle | changeWithinVehicle | checkIn | checkOut

    MODEs dedicated to peform TRANSFERs

    15.2. The complex type IndividualTransportOptionsStructure

    IndividualTransportOptionsStructure

    Individual modes and their usage limits as stated by the passenger

    The element contains a sequence of the following elements:

    Mode

    1:1

    IndividualModes

    Mode of individual transport. When mode self-drive-car is used the connection to another mode will need a parking space for the car. Thus, this mode is a generalisation of all park and ride use cases. The mode others-drive-car, however, only needs a place to let a person be set down from a car.

    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.

    15.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:

    ContinuousModesEnumeration

    walk | demandResponsive | replacementService

    Types of cmodes that run at any time without a timetable.

    IndividualModesEnumeration

    walk | cycle | taxi | self-drive-car | others-drive-car | motorcycle | truck | scooter | ride-pool-car | car-sharing | cycle-sharing | scooter-sharing

    modes which an individual powers themselves (such as walk, cycle)

    PrivateModesEnumeration

    carPooling

    [a category of MODE in TMv6] MODEs offered by private individuals

    TransferModesEnumeration

    walk | parkAndRide | bikeAndRide | carHire | bikeHire | protectedConnection | guaranteedConnection | remainInVehicle | changeWithinVehicle | checkIn | checkOut

    MODEs dedicated to peform TRANSFERs

    16.2. The complex type IndividualTransportOptionsStructure

    IndividualTransportOptionsStructure

    Individual modes and their usage limits as stated by the passenger

    The element contains a sequence of the following elements:

    Mode

    1:1

    IndividualModes

    Mode of individual transport. When mode self-drive-car is used the connection to another mode will need a parking space for the car. Thus, this mode is a generalisation of all park and ride use cases. The mode others-drive-car, however, only needs a place to let a person be set down from a car.

    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 mode

    →‍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.

    15.4. The ModeGroup group

    +

    ModeGroup

    Elements for a Transport Mode

    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 mode

    →‍siri:PtModeChoiceGroup

    15.5. The complex type PtModeFilterStructure

    PtModeFilterStructure

    List of public transport modes ([from SIRI] mode of public transport service, corresponds to VEHICLE MODE) to exclude or include.

    The element contains a sequence of the following elements:

    Exclude

    0:1

    xs:boolean

    Whether VEHICLE 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.

    →‍siri:PtModeChoiceGroup

    15.6. The complex type PrivateModeFilterStructure

    PrivateModeFilterStructure

    List of private mobility offers to include or exclude.

    The element contains a sequence of the following elements:

    Exclude

    0:1

    xs:boolean

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

    PrivateMode

    0:*

    PrivateModes

    List of private mobility offers to include/exclude.

    -

    16. OJP/OJP_SituationSupport.xsd - Supporting definitions for situations containing wrappers for SIRI Situation Exchange service (SIRI SX)

    16.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.

    RoadSituation

    0:*

    siri:RoadSituationElementStructure

    16.2. The toplevel element SituationFullRef

    SituationFullRef

    +SituationFullRef

    Reference to situation message. Message details might be found in response context or through other communication channels.

    16.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.

    16.5. The complex type PtModeFilterStructure

    PtModeFilterStructure

    List of public transport modes ([from SIRI] mode of public transport service, corresponds to VEHICLE MODE) to exclude or include.

    The element contains a sequence of the following elements:

    Exclude

    0:1

    xs:boolean

    Whether VEHICLE 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.

    →‍siri:PtModeChoiceGroup

    16.6. The complex type PrivateModeFilterStructure

    PrivateModeFilterStructure

    List of private mobility offers to include or exclude.

    The element contains a sequence of the following elements:

    Exclude

    0:1

    xs:boolean

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

    PrivateMode

    0:*

    PrivateModes

    List of private mobility offers to include/exclude.

    +

    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.

    RoadSituation

    0:*

    siri:RoadSituationElementStructure

    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. OJP/OJP_Utility.xsd - Support definitions not specifically related to the public transport domain

    17.1. Simple type definitions

    EMailAddressType

    xs:normalizedString

    Type definition for e-mail 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

    17.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.

    17.3. The WebLinkGroup group

    +

    18. OJP/OJP_Utility.xsd - Support definitions not specifically related to the public transport domain

    18.1. Simple type definitions

    WebLinkGroup

    URL of a web resource including type of resource.

    EMailAddressType

    xs:normalizedString

    Type definition for e-mail 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.

    17.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.

    18.4. The complex type WebLinkStructure

    diff --git a/docs/schema-collection.xml b/docs/schema-collection.xml index c6829f989..8fead8ede 100644 --- a/docs/schema-collection.xml +++ b/docs/schema-collection.xml @@ -8,6 +8,7 @@ + diff --git a/examples/functions/LineRequest.xml b/examples/functions/LineRequest.xml new file mode 100644 index 000000000..1906771a2 --- /dev/null +++ b/examples/functions/LineRequest.xml @@ -0,0 +1,20 @@ + + + + + 2022-12-19T12:00:00Z + IRMA + + 2022-12-19T12:00:00Z + 4711 + + + ch:1:slnid:129312 + ch:1:Direction:H + + false + + + + + diff --git a/examples/functions/LineResponse.xml b/examples/functions/LineResponse.xml new file mode 100644 index 000000000..39802c9a5 --- /dev/null +++ b/examples/functions/LineResponse.xml @@ -0,0 +1,45 @@ + + + + + 2022-12-01T17:54:38Z + OJPCH_Prod + true + + 2022-12-01T17:54:38Z + 4711 + true + + + ch:slnid:123123 + IC8 + + + 7.48464 + 46.93150 + + + 7.48447 + 46.93141 + + + 7.48441 + 46.93138 + + + 7.48437 + 46.93134 + + + + rail + longDistanceTrain + + Intercity + + + + + + +

    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.