diff --git a/docs/generated/index.html b/docs/generated/index.html index 34f72a818..53cdd6d9e 100644 --- a/docs/generated/index.html +++ b/docs/generated/index.html @@ -58,17 +58,17 @@

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
  • -
  • 3. OJP/OJP_RequestSupport.xsd - Supporting definitions for OJP service requests and their 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_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
  • +
  • 5. OJP/OJP_FareSupport.xsd - Supporting definitions for fare information on passenger trips
  • +
  • 6. OJP/OJP_Lines.xsd - Request and response definitions for information on lines
  • +
  • 7. OJP/OJP_Location.xsd - Request and response definitions for location information
  • +
  • 8. OJP/OJP_PlaceSupport.xsd - Supporting definitions for location 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
  • +
  • 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
  • @@ -99,30 +99,30 @@

    OJP - Open API for distributed Journey

    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

    2.5. The toplevel element OJPLocationInformationRequest

    OJPLocationInformationRequest

    +OJPLocationInformationRequest (↔ siri:AbstractFunctionalServiceRequest)

    2.6. The complex type OJPLocationInformationRequestStructure

    - - + + - + -

    OJPLocationInformationRequestStructure

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

    The element contains a sequence of the following elements:

    Then, the element contains one of the following elements:

    LocationInformationRequest

    a

    InitialInput

    -1:1

    +InitialLocationInput

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

    b

    PlaceRef

    -1:1

    +PlaceRef

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

    Restrictions

    0:1

    +PlaceParam

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

    →‍siri:Extensions

    0:1

    →‍siri:Extensions

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

    2.7. The toplevel element OJPLocationInformationDelivery

    OJPLocationInformationDelivery

    +OJPLocationInformationDelivery (↔ siri:AbstractFunctionalServiceDelivery)

    2.8. The complex type OJPLocationInformationDeliveryStructure

    - + - - + + - - + +

    OJPLocationInformationDeliveryStructure

    siri:AbstractServiceDeliveryStructure

    The element contains a sequence of the following elements:

    →‍OJPPlaceInformationRequest

    0:1

    →‍OJPPlaceInformationRequest

    The element contains a sequence of the following elements:

    →‍OJPLocationInformationRequest

    0:1

    →‍OJPLocationInformationRequest

    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.

    LocationInformationResponse

    LocationInformationResponseContext

    0:1

    +ResponseContext

    Context to hold response objects that occur frequently.

    ContinueAt

    0:1

    xs:nonNegativeInteger

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

    PlaceResult

    0:*

    +PlaceResult

    →‍siri:Extensions

    0:1

    →‍siri:Extensions

    PlaceResult

    0:*

    +PlaceResult

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

    →‍siri:Extensions

    0:1

    →‍siri:Extensions

    2.9. The toplevel element OJPExchangePointsRequest

    OJPExchangePointsRequest

    +OJPExchangePointsRequest (↔ siri:AbstractFunctionalServiceRequest)

    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

    ExchangePointsRequest

    PlaceRef

    0:1

    +PlaceRef

    Location/Place for which exchange points to other "neighbour" systems are to be searched. This location/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. location/place types (stops, addresses, POIs) or specific location/place attributes

    →‍siri:Extensions

    0:1

    →‍siri:Extensions

    2.11. The toplevel element OJPExchangePointsDelivery

    OJPExchangePointsDelivery

    +OJPExchangePointsDelivery (↔ siri:AbstractFunctionalServiceDelivery)

    2.12. The complex type OJPExchangePointsDeliveryStructure

    @@ -132,15 +132,15 @@

    OJP - Open API for distributed Journey

    - + - +

    OJPExchangePointsDeliveryStructure

    siri:AbstractServiceDeliveryStructure

    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.

    ExchangePointsResponse

    ExchangePointsResponseContext

    0:1

    +ResponseContext

    Context to hold trip response objects that occur frequently.

    ContinueAt

    0:1

    xs:nonNegativeInteger

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

    Place

    0:*

    +ExchangePointsResult

    ExchangePointsResult

    0:*

    +ExchangePointsResult

    The exchange points found by the service.

    →‍siri:Extensions

    0:1

    →‍siri:Extensions

    2.13. The toplevel element OJPStopEventRequest

    OJPStopEventRequest

    +OJPStopEventRequest (↔ siri:AbstractFunctionalServiceRequest)

    2.14. The complex type OJPStopEventRequestStructure

    - + @@ -162,7 +162,7 @@

    OJP - Open API for distributed Journey

    - + @@ -253,8 +253,8 @@

    OJP - Open API for distributed Journey

    - - + + @@ -266,7 +266,8 @@

    OJP - Open API for distributed Journey

    - + + @@ -291,40 +292,14 @@

    OJP - Open API for distributed Journey

    -

    OJPStopEventRequestStructure

    +AbstractOJPServiceRequest

    The element contains a sequence of the following elements:

    StopEventRequest

    Place

    1:1

    +PlaceContext

    Place for which to obtain stop event information.

    StopEventRequest

    Location

    1:1

    +PlaceContext

    LOCATION / PLACE for which to obtain stop event information.

    Params

    0:1

    +StopEventParam

    Request parameter

    →‍siri:Extensions

    0:1

    →‍siri:Extensions

    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

    TimedVehicleRef

    b

    →‍siri:VehicleRef

    1:1

    →‍siri:VehicleRef

    Reference to vehicle.

    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.

    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

    MinMaxTimeBand

    EarliestDepartureTime

    0:1

    xs:dateTime

    Earliest possible departure time from start location.

    LatestArrivalTime

    0:1

    xs:dateTime

    Latest possible arrival time at destination location.

    AvailabilityRequest

    Extension

    0:1

    xs:anyType

    →‍siri:Extensions

    0:1

    →‍siri:Extensions

    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.

    AvailabilityResponse

    AvailabilityResponseContext

    0:1

    +ResponseContext

    Context to hold availability response objects that occur frequently.

    AvailabilityResult

    0:1

    +AvailabilityResult

    Indication of the availability of the requested service.

    Extension

    0:1

    xs:anyType

    →‍siri:Extensions

    0:1

    →‍siri:Extensions

    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.

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

    Operators_RelStructure

    Structure providing a collection of operators.

    The element contains only one element:

    Operator

    1:*

    siri:AffectedOperatorStructure

    Operator of the service.

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

    Operators

    0:1

    +Operators_Rel

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

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

    3.6. The complex type PlacesStructure

    PlacesStructure

    Structure providing a collection of places.

    The element contains only one element:

    Place

    1:*

    +Place

    3.7. The complex type Operators_RelStructure

    Operators_RelStructure

    Structure providing a collection of operators.

    The element contains only one element:

    Operator

    1:*

    siri:AffectedOperatorStructure

    Operator of the service.

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

    Operators

    0:1

    +Operators_Rel

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

    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.9. The complex type OJPGenericProblemStructure

    @@ -332,17 +307,17 @@

    OJP - Open API for distributed Journey

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

    4.1. The FareRequestGroup group

    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.

    -

    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.

    4.2. The complex type StopFareRequestStructure

    StopFareRequestStructure

    Sub-request: stop-related fare information.

    The element contains a sequence of the following elements:

    →‍siri:StopPointRef

    1:1

    →‍siri:StopPointRef

    Date

    0:1

    xs:date

    Date for which to retrieve Fare information.

    4.3. The complex type StaticFareRequestStructure

    StaticFareRequestStructure

    General Fare information. May depend on date.

    The element contains a sequence of the following elements:

    Date

    0:1

    xs:date

    Date for which to retrieve Fare information.

    →‍FareProductRef

    0:*

    →‍FareProductRef

    Reference to a FareProduct.

    4.4. The complex type TripFareRequestStructure

    TripFareRequestStructure

    Structure of a Single Trip Fare Request.

    The element contains only one element:

    Trip

    1:1

    +Trip

    A complete trip from origin to destination

    4.5. The complex type MultiTripFareRequestStructure

    MultiTripFareRequestStructure

    Structure of a Multi Trip Fare Request.

    The element contains only one element:

    Trip

    1:*

    +Trip

    Multiple complete trips from multiple origins and multiple destination

    4.6. The FareResponseGroup group

    +

    FareResponseGroup

    4.2. The complex type StopFareRequestStructure

    StopFareRequestStructure

    Sub-request: stop-related fare information.

    The element contains a sequence of the following elements:

    →‍siri:StopPointRef

    1:1

    →‍siri:StopPointRef

    Reference to the stop point.

    Date

    0:1

    xs:date

    Date for which to retrieve Fare information.

    4.3. The complex type StaticFareRequestStructure

    StaticFareRequestStructure

    General Fare information. May depend on date.

    The element contains a sequence of the following elements:

    Date

    0:1

    xs:date

    Date for which to retrieve Fare information.

    →‍FareProductRef

    0:*

    →‍FareProductRef

    Reference to a FareProduct.

    4.4. The complex type TripFareRequestStructure

    TripFareRequestStructure

    Structure of a Single Trip Fare Request.

    The element contains a sequence of the following elements:

    TripContext

    0:1

    +ResponseContext

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

    Trip

    1:1

    +Trip

    A complete trip from origin to destination

    4.5. The complex type MultiTripFareRequestStructure

    MultiTripFareRequestStructure

    Structure of a Multi Trip Fare Request.

    The element contains a sequence of the following elements:

    TripContext

    0:1

    +ResponseContext

    Context to hold trip related objects that occur frequently.

    Trip

    1:*

    +Trip

    Multiple complete trips from multiple origins and multiple destination

    4.6. The FareResponseGroup group

    -

    FareResponseGroup

    FareResponse

    FareResponseContext

    0:1

    +ResponseContext

    Context to hold trip response objects that occur frequently.

    FareResult

    0:*

    +FareResult

    Fare result choice element.

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

    +

    4.7. The complex type FareResultStructure

    FareResultStructure

    Wrapper element for Fare results.

    The element contains a sequence of the following elements:

    Id

    1:1

    ObjectId

    ID of this result.

    Problem

    0:*

    +FareProblem

    Problems related to this FARE result.

    FareEstimated

    0:1

    xs:boolean

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

    Then, the element contains one of the following elements:

    a

    MultiTripFareResult

    -1:*

    +MultiTripFareResult

    Fare and FareProducts for multiple trips.

    b

    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.

    FromLegIdRef

    0:1

    xs:NMTOKEN

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

    ToTripIdRef

    1:1

    xs:NMTOKEN

    Identifies the "valid to" trip.

    ToLegIdRef

    0:1

    xs:NMTOKEN

    Identifies the "valid to" LEG. 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

    BookingAccessEnumeration

    public | authorisedPublic | staff | other

    Allowed values for Booking Access.

    BookingMethodEnumeration

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

    Allowed values for Flexible Booking method.

    BookingProcessEnumeration

    xs:normalizedString

    Allowed values for Booking Process UIC 7037 Code list.

    ContactTypeEnumeration

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

    Allowed values for CONTACT role.

    EmailAddressType

    xs:normalizedString

    Email address type a@b.

    EntitlementProductCodeType

    xs:NMTOKEN

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

    FareAuthorityCodeType

    xs:NMTOKEN

    Identifier of a Fare Authority.

    FareProblemTypeEnumeration

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

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

    FareProductIdType

    xs:NMTOKEN

    Identifier of a FareProduct

    GroupBookingEnumeration

    xs:normalizedString

    Allowed values for Group Booking.

    PassengerCategoryEnumeration

    Adult | Child | Senior | Youth | Disabled

    [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

    PhoneType

    xs:normalizedString

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

    PurchaseMomentEnumeration

    xs:normalizedString

    Allowed values for Purchase Moment.

    PurchaseWhenEnumeration

    xs:normalizedString

    Allowed values for Purchase when.

    TariffZoneCodeType

    xs:NMTOKEN

    Identifier of a fare zone.

    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 ContactDetailsStructure

    ContactDetailsStructure

    Type for contact details.

    The element contains a sequence of the following elements:

    ContactPerson

    0:1

    +InternationalText

    Name of contact person.

    Email

    0:1

    EmailAddress

    The email address of the contact.

    Phone

    0:1

    Phone

    Contact telephone number.

    Fax

    0:1

    Phone

    Contact fax number.

    Url

    0:1

    +WebLink

    The web site address of the contact.

    FurtherDetails

    0:1

    +InternationalText

    Further details about contact process.

    5.11. The complex type BookingMethodListOfEnumerations

    BookingMethodListOfEnumerations

    List of values for Flexible Booking values.

    The element contains only one element:

    BookingMethod

    1:*

    BookingMethod

    5.12. The complex type PurchaseMomentListOfEnumerations

    PurchaseMomentListOfEnumerations

    List of Purchase Moment values.

    The element contains only one element:

    PurchaeMoment

    1:*

    PurchaseMoment

    5.13. The complex type BookingProcessListOfEnumerations

    BookingProcessListOfEnumerations

    List of Booking Process values.

    The element contains only one element:

    BookingProcess

    1:*

    BookingProcess

    5.14. The complex type GroupBookingListOfEnumerations

    GroupBookingListOfEnumerations

    List of Group Booking values.

    The element contains only one element:

    GroupBooking

    1:*

    GroupBooking

    5.15. The complex type BookingArrangementsStructure

    BookingArrangementsStructure

    Type for BOOKING ARRANGEMENTs modified from NeTEx.

    5.16. The BookingArrangementsGroup group

    +

    BookingArrangementsGroup

    Elements for BOOKING ARRANGEMENTs.

    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 ContactDetailsStructure

    ContactDetailsStructure

    Type for contact details.

    The element contains a sequence of the following elements:

    ContactPerson

    0:1

    +InternationalText

    Name of contact person.

    Email

    0:1

    EmailAddress

    The email address of the contact.

    Phone

    0:1

    Phone

    Contact telephone number.

    Fax

    0:1

    Phone

    Contact fax number.

    Url

    0:1

    +WebLink

    The web site address of the contact.

    FurtherDetails

    0:1

    +InternationalText

    Further details about contact process.

    5.11. The complex type BookingMethodListOfEnumerations

    BookingMethodListOfEnumerations

    List of values for Flexible Booking values.

    The element contains only one element:

    BookingMethod

    1:*

    BookingMethod

    Flexible booking methods.

    5.12. The complex type PurchaseMomentListOfEnumerations

    PurchaseMomentListOfEnumerations

    List of Purchase Moment values.

    The element contains only one element:

    PurchaseMoment

    1:*

    PurchaseMoment

    Possibilities when to pay.

    5.13. The complex type BookingProcessListOfEnumerations

    BookingProcessListOfEnumerations

    List of Booking Process values.

    The element contains only one element:

    BookingProcess

    1:*

    BookingProcess

    Ways how to book (UIC 7037 codes).

    5.14. The complex type GroupBookingListOfEnumerations

    GroupBookingListOfEnumerations

    Possibilites and restrictions for group booking.

    The element contains only one element:

    GroupBooking

    1:*

    GroupBooking

    Group booking policies.

    5.15. The complex type BookingArrangementsStructure

    BookingArrangementsStructure

    Type for BOOKING ARRANGEMENTs modified from NeTEx.

    5.16. The BookingArrangementsGroup group

    @@ -373,7 +348,7 @@

    OJP - Open API for distributed Journey

    - +

    BookingArrangementsGroup

    Elements for BOOKING ARRANGEMENTs.

    BookingArrangements

    BookingContact

    0:1

    +ContactDetails

    Contact for Booking.

    BookingMethods

    0:1

    +BookingMethodListOf

    Allowed Ways of Making a BOOKING.

    BookingAccess

    0:1

    BookingAccess

    Who can make a booking. Default is public.

    FareProductBooking

    InfoUrl

    0:*

    +WebLink

    URL to information for this FareProduct

    SaleUrl

    0:*

    +WebLink

    URL to buy the FareProduct online.

    BookingArrangements

    0:*

    +BookingArrangementsContainer

    BookingArrangements

    0:*

    +BookingArrangementsContainer

    Multiple sets of multiple booking arrangements for different legs of a journey.

    Extension

    0:1

    xs:anyType

    5.23. The FareProductPriceGroup group

    @@ -390,14 +365,14 @@

    OJP - Open API for distributed Journey

    FareProductPriceGroup

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

    FareProductPrice

    Price

    0:1

    xs:decimal

    FareProduct price as decimal number.

    NetPrice

    0:1

    xs:decimal

    Net FareProduct price as decimal number for accounting purposes.

    5.25. The FareProductBookingGroup group

    - -

    FareProductBookingGroup

    [aggregation of DISTRIBUTION CHANNEL and BOOKING ARRANGEMENT in TM and NeTEx] Group of information elements related to information to support the process of booking a FARE PRODUCT.

    FareProductBooking

    InfoUrl

    0:*

    +WebLink

    URL to information for this FareProduct

    SaleUrl

    0:*

    +WebLink

    URL to buy the FareProduct online.

    BookingArrangements

    0:*

    +BookingArrangementsContainer

    5.26. The TripLegRangeGroup group

    - - -

    TripLegRangeGroup

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

    TripLegRange

    FromTripLegIdRef

    1:1

    xs:NMTOKEN

    Identifies the "valid from" trip leg.

    ToTripLegIdRef

    1:1

    xs:NMTOKEN

    Identifies the "valid to" trip leg.

    5.27. The complex type TripFareResultStructure

    - - -

    TripFareResultStructure

    Structure of a Single Trip Fare Request result

    The element contains a sequence of the following elements:

    Problem

    0:*

    +FareProblem

    Result-specific error messages.

    TripLegRange

    FromTripLegIdRef

    1:1

    xs:NMTOKEN

    Identifies the "valid from" trip leg.

    ToTripLegIdRef

    1:1

    xs:NMTOKEN

    Identifies the "valid to" trip leg.

    PassedZones

    0:1

    +TariffZoneListInArea

    The sequence of passed fare zones.

    FareProduct

    0:*

    +FareProduct

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

    StaticInfoUrl

    0:*

    +WebLink

    URL to static information page on the web.

    5.28. The complex type FarePassengerStructure

    FarePassengerStructure

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

    The element contains a sequence of the following elements:

    Then, the element contains one of the following elements:

    a

    Age

    -1:1

    xs:nonNegativeInteger

    Age of the passenger on the day of travel.

    b

    PassengerCategory

    -1:1

    PassengerCategory

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

    EntitlementProducts

    0:1

    +EntitlementProductList

    A list of ENTITLEMENT PRODUCTs.

    Then, the element contains one of the following elements:

    a

    SalesPackageElementRef

    -1:*

    +FareProductRef

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

    b

    ZonesAlreadyPaid

    -1:1

    +TariffZoneRefList

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

    5.29. The FareDataFilterGroup group

    + +

    FareDataFilterGroup

    Data filter group for Fare request.

    BookingArrangements

    0:*

    +BookingArrangementsContainer

    Multiple sets of multiple booking arrangements for different legs of a journey.

    5.26. The LegRangeGroup group

    + + +

    LegRangeGroup

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

    LegRange

    FromLegIdRef

    1:1

    xs:NMTOKEN

    Identifies the "valid from" LEG.

    ToLegIdRef

    1:1

    xs:NMTOKEN

    Identifies the "valid to" LEG.

    5.27. The complex type TripFareResultStructure

    + + +

    TripFareResultStructure

    Structure of a Single Trip Fare Request result

    The element contains a sequence of the following elements:

    Problem

    0:*

    +FareProblem

    Result-specific error messages.

    LegRange

    FromLegIdRef

    1:1

    xs:NMTOKEN

    Identifies the "valid from" LEG.

    ToLegIdRef

    1:1

    xs:NMTOKEN

    Identifies the "valid to" LEG.

    PassedZones

    0:1

    +TariffZoneListInArea

    The sequence of passed fare zones.

    FareProduct

    0:*

    +FareProduct

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

    StaticInfoUrl

    0:*

    +WebLink

    URL to static information page on the web.

    5.28. The complex type FarePassengerStructure

    FarePassengerStructure

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

    The element contains a sequence of the following elements:

    Then, the element contains one of the following elements:

    a

    Age

    -1:1

    xs:nonNegativeInteger

    Age of the passenger on the day of travel.

    b

    PassengerCategory

    -1:1

    PassengerCategory

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

    EntitlementProducts

    0:1

    +EntitlementProductList

    A list of ENTITLEMENT PRODUCTs.

    Then, the element contains one of the following elements:

    a

    SalesPackageElementRef

    -1:*

    +FareProductRef

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

    b

    ZonesAlreadyPaid

    -1:1

    +TariffZoneRefList

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

    5.29. The FareDataFilterGroup group

    @@ -410,23 +385,28 @@

    OJP - Open API for distributed Journey

    FareDataFilterGroup

    Data filter group for Fare request.

    FareDataFilter

    FareAuthorityFilter

    0:*

    +FareAuthorityRef

    Fare authority for which to retrieve Fare information.

    PassengerCategory

    0:*

    PassengerCategory

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

    TravelClass

    0:1

    TypeOfFareClass

    Travel class for which to retrieve FareProducts. Refers to TYPE OF FARE CLASS (e.g. first class).

    Details

    0:1

    +InternationalText

    Explanation of the problem.

    LogData

    0:1

    xs:string

    Additional log data.

    -

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

    6.1. The LineInformationResponseGroup group

    +

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

    6.1. Simple type definitions

    LineInformationResponseGroup

    Line Information response group.

    LineInformationProblemTypeEnumeration

    LINEINFORMATION_LINEUNKNOWN | LINEINFORMATION_OTHER

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

    6.2. The LineInformationResponseGroup group

    -

    LineInformationResponseGroup

    Line Information response group.

    LineInformationResponse

    LineResult

    0:*

    +LineResult

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

    6.3. The complex type LineResultStructure

    LineResultStructure

    The element contains a sequence of the following elements:

    Problem

    0:*

    +LineInformationProblem

    Problems related to this Line result.

    LineRef

    1:1

    siri:LineRefStructure

    Reference to the LINE.

    →‍siri:PublishedLineName

    0:1

    →‍siri:PublishedLineName

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

    DirectionRef

    0:1

    siri:DirectionRefStructure

    DIRECTION of LINE.

    RouteGeometry

    0:*

    +LinearShape

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

    Mode

    0:*

    +Mode

    List of transport modes that are supported by this line.

    6.4. The complex type LineInformationProblemStructure

    + + + +

    LineInformationProblemStructure

    Problem that may be returned in responses to LINE information requests.

    The element contains a sequence of the following elements:

    Type

    1:1

    LineInformationProblemType

    Type of the LINE information 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. OJP/OJP_Location.xsd - Request and response definitions for location information

    7.1. Simple type definitions

    PlaceTypeEnumeration

    stop | address | poi | coord | location | topographicPlace

    PlaceUsageEnumeration

    origin | via | destination

    7.2. The LocationInformationRequestGroup group

    + -

    LocationInformationRequestGroup

    The element contains one of the following elements:

    LocationInformationRequest

    a

    InitialInput

    -1:1

    +InitialLocationInput

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

    b

    PlaceRef

    -1:1

    +PlaceRef

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

    Restrictions

    0:1

    +PlaceParam

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

    7.3. The PlaceInformationResponseGroup group

    - +

    PlaceInformationResponseGroup

    PlaceInformationResponse

    PlaceInformationResponseContext

    0:1

    +ResponseContext

    Context to hold response objects that occur frequently.

    7.3. The LocationInformationResponseGroup group

    + - -

    LocationInformationResponseGroup

    LocationInformationResponse

    LocationInformationResponseContext

    0:1

    +ResponseContext

    Context to hold response objects that occur frequently.

    ContinueAt

    0:1

    xs:nonNegativeInteger

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

    PlaceResult

    0:*

    +PlaceResult

    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.

    AllowedSystem

    0:*

    siri:ParticipantRefStructure

    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

    - - - - - + +

    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.

    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.

    PlaceResult

    0:*

    +PlaceResult

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

    7.4. The complex type InitialLocationInputStructure

    InitialLocationInputStructure

    The element contains a sequence of the following elements:

    Name

    0:1

    xs:string

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

    GeoPosition

    0:1

    siri:LocationStructure

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

    GeoRestriction

    0:1

    +GeoRestrictions

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

    AllowedSystem

    0:*

    siri:ParticipantRefStructure

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

    7.5. The complex type PlaceParamStructure

    + + + + + + @@ -437,8 +417,8 @@

    OJP - Open API for distributed Journey

    -

    PlaceParamStructure

    The element contains a sequence of the following elements:

    PlaceDataFilter

    Type

    0:*

    PlaceType

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

    Usage

    0:1

    PlaceUsage

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

    PtModes

    0:1

    +PtModeFilter

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

    OperatorFilter

    0:1

    +OperatorFilter

    Filter for locations/places that are operated by certain organisations.

    TopographicPlaceRef

    0:*

    +TopographicPlaceRef

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

    PointOfInterestFilter

    0:1

    +PointOfInterestFilter

    Filter to narrow down POI searches.

    Extension

    0:1

    xs:anyType

    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.

    PlaceSorting

    SortingMethod

    0:1

    xs:string

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

    GeoPosition

    0:1

    siri:LocationStructure

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

    MinimalProbability

    0:1

    xs:float

    Ignore locations with a lower probability.

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

    7.6. The complex type GeoRestrictionsStructure

    GeoRestrictionsStructure

    The element contains one of the following elements:

    a

    Area

    -1:1

    +GeoArea

    Area defined by a polyline.

    b

    Circle

    -1:1

    +GeoCircle

    Area defined by a circle.

    c

    Rectangle

    -1:1

    +GeoRectangle

    Area defined by a rectangle.

    7.7. The complex type GeoCircleStructure

    GeoCircleStructure

    The element contains a sequence of the following elements:

    Center

    1:1

    siri:LocationStructure

    Centre position of the circle.

    Radius

    1:1

    siri:DistanceType

    Radius in metres.

    7.8. The complex type GeoRectangleStructure

    GeoRectangleStructure

    The element contains a sequence of the following elements:

    UpperLeft

    1:1

    siri:LocationStructure

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

    LowerRight

    1:1

    siri:LocationStructure

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

    7.9. The complex type GeoAreaStructure

    GeoAreaStructure

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

    The element contains only one element:

    PolylinePoint

    3:*

    siri:LocationStructure

    Vertices of a polyline defining an area.

    7.10. The complex type PlaceResultStructure

    @@ -450,61 +430,62 @@

    OJP - Open API for distributed Journey

    PlaceResultStructure

    The element contains a sequence of the following elements:

    Problem

    0:*

    +LocationProblem

    Problems related to this LOCATION result.

    Place

    1:1

    +Place

    The Place / Location object.

    Complete

    1:1

    xs:boolean

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

    Probability

    0:1

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

    IncludePtModes

    0:1

    xs:boolean

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

    IncludeOperators

    0:1

    xs:boolean

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

    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.

    PlaceDataFilter

    Type

    0:*

    PlaceType

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

    Usage

    0:1

    PlaceUsage

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

    PtModes

    0:1

    +PtModeFilter

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

    OperatorFilter

    0:1

    +OperatorFilter

    Filter for locations/places that are operated by certain organisations.

    TopographicPlaceRef

    0:*

    +TopographicPlaceRef

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

    PointOfInterestFilter

    0:1

    +PointOfInterestFilter

    Filter to narrow down POI searches.

    Extension

    0:1

    xs:anyType

    7.13. The PlaceSortingGroup group

    PlaceSortingGroup

    PlaceSorting

    SortingMethod

    0:1

    xs:string

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

    GeoPosition

    0:1

    siri:LocationStructure

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

    MinimalProbability

    0:1

    xs:float

    Ignore locations with a lower probability.

    7.14. The ExchangePointsRequestGroup group

    - - + +

    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

    ExchangePointsRequest

    PlaceRef

    0:1

    +PlaceRef

    Location/Place for which exchange points to other "neighbour" systems are to be searched. This location/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. location/place types (stops, addresses, POIs) or specific location/place attributes

    7.15. The complex type ExchangePointsParamStructure

    - - - - - + + + + + - +

    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.

    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.

    ExchangePointsDataFilter

    Type

    0:*

    PlaceType

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

    Usage

    0:1

    PlaceUsage

    Defines, whether the location/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 location/place objects. Applies only to stops.

    OperatorFilter

    0:1

    +OperatorFilter

    Filter for locations/places that are operated by certain organisations.

    TopographicPlaceRef

    0:*

    +TopographicPlaceRef

    If at least one is set, only location/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.

    ExchangePointsPolicy

    Language

    0:*

    xs:language

    Preferred language in which to return text values.

    NumberOfResults

    0:1

    xs:positiveInteger

    NumberOfResults

    0:1

    xs:positiveInteger

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

    ContinueAt

    0:1

    xs:nonNegativeInteger

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

    7.16. The ExchangePointsDataFilterGroup group

    - - - - - + + + + +

    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.

    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.

    ExchangePointsDataFilter

    Type

    0:*

    PlaceType

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

    Usage

    0:1

    PlaceUsage

    Defines, whether the location/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 location/place objects. Applies only to stops.

    OperatorFilter

    0:1

    +OperatorFilter

    Filter for locations/places that are operated by certain organisations.

    TopographicPlaceRef

    0:*

    +TopographicPlaceRef

    If at least one is set, only location/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.

    7.17. The ExchangePointsPolicyGroup group

    - +

    ExchangePointsPolicyGroup

    ExchangePointsPolicy

    Language

    0:*

    xs:language

    Preferred language in which to return text values.

    NumberOfResults

    0:1

    xs:positiveInteger

    NumberOfResults

    0:1

    xs:positiveInteger

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

    ContinueAt

    0:1

    xs:nonNegativeInteger

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

    7.18. The ExchangePointsResponseGroup group

    - + - -

    ExchangePointsResponseGroup

    ExchangePointsResponse

    ExchangePointResponseContext

    0:1

    +ResponseContext

    Context to hold trip response objects that occur frequently.

    ExchangePointsResponse

    ExchangePointsResponseContext

    0:1

    +ResponseContext

    Context to hold trip response objects that occur frequently.

    ContinueAt

    0:1

    xs:nonNegativeInteger

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

    Place

    0:*

    +ExchangePointsResult

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

    Priority

    0:1

    Percent

    The priority of the exchange point. 100 is the maximum.

    -

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

    ExchangePointsResult

    0:*

    +ExchangePointsResult

    The exchange points found by the service.

    7.19. The complex type ExchangePointsResultStructure

    ExchangePointsResultStructure

    The element contains a sequence of the following elements:

    Problem

    0:*

    +ExchangePointsProblem

    Problems related to this EXCHANGE POINTS result.

    Place

    1:1

    +Place

    Place object that describes this exchange point.

    TravelDurationEstimate

    0:1

    xs:duration

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

    WaitDuration

    0:1

    xs:duration

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

    BorderPoint

    0:1

    xs:boolean

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

    Mode

    0:*

    +Mode

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

    Priority

    0:1

    Percent

    The priority of the exchange point. 100 is the maximum.

    +

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

    8.1. Simple type definitions

    AddressCodeType

    xs:normalizedString

    Identifier of an Address

    ExchangePointsProblemTypeEnumeration

    EXCHANGEPOINTS_NORESULTS | EXCHANGEPOINTS_UNKNOWNDESTINATIONSYSTEM | EXCHANGEPOINTS_UNKNOWNADJACENTSYSTEM | EXCHANGEPOINTS_OTHER

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

    LocationProblemTypeEnumeration

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

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

    PointOfInterestCodeType

    xs:normalizedString

    Identifier of a Point of Interest

    StopPlaceCodeType

    xs:normalizedString

    Identifier of a Stop Place

    TopographicPlaceCodeType

    xs:normalizedString

    Identifier of a TopographicPlace

    8.2. The StopPointGroup group

    +

    StopPointGroup

    A stop point with id and name

    StopPoint

    →‍siri:StopPointRef

    1:1

    →‍siri:StopPointRef

    Reference to a stop point.

    StopPointName

    1:1

    +InternationalText

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

    NameSuffix

    0:1

    +InternationalText

    Additional description of the stop point that may be appended to the name if enough space is available. 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.

    8.3. The complex type StopPointStructure

    - + - + @@ -516,7 +497,7 @@

    OJP - Open API for distributed Journey

    - + @@ -524,27 +505,27 @@

    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

    StopPoint

    →‍siri:StopPointRef

    1:1

    →‍siri:StopPointRef

    Reference to a stop point.

    StopPointName

    1:1

    +InternationalText

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

    NameSuffix

    0:1

    +InternationalText

    Additional description of the stop point that may be appended to the name if enough space is available. 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.

    PrivateCode

    0:*

    +PrivateCode

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

    ParentRef

    0:1

    +StopPlaceRef

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

    →‍TopographicPlaceRef

    0:1

    →‍TopographicPlaceRef

    If at least one is set, only 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

    PrivateCode

    0:*

    +PrivateCode

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

    ParentRef

    0:1

    +StopPlaceRef

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

    →‍TopographicPlaceRef

    0:1

    →‍TopographicPlaceRef

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

    StopAttributes

    WheelchairAccessible

    0:1

    xs:boolean

    Whether this stop is accessible for wheelchair users.

    Lighting

    0:1

    xs:boolean

    Whether this stop is lit.

    Covered

    0:1

    xs:boolean

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

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

    PrivateCode

    0:*

    +PrivateCode

    Code of this stop place 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

    PrivateCode

    0:*

    +PrivateCode

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

    →‍TopographicPlaceRef

    0:1

    →‍TopographicPlaceRef

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

    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.

    StopAttributes

    WheelchairAccessible

    0:1

    xs:boolean

    Whether this stop is accessible for wheelchair users.

    Lighting

    0:1

    xs:boolean

    Whether this stop is lit.

    Covered

    0:1

    xs:boolean

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

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

    ReferredSystem

    0:1

    siri:ParticipantRefStructure

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

    Area

    0:1

    +Area

    Area covered by the locality described as a polygon.

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

    +

    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.

    ReferredSystem

    0:1

    siri:ParticipantRefStructure

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

    Area

    0:1

    +Area

    Area covered by the locality described as a polygon.

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

    POIAdditionalInformation

    0:1

    +PointOfInterestAdditionalInformation

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

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

    PointOfInterestAdditionalInformationStructure

    Generic structure for additional information on POIs.

    The element contains only one element:

    POIAdditionalInformation

    1:*

    +CategoryKeyValue

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

    8.17. The complex type CategoryKeyValueType

    CategoryKeyValueType

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

    The element contains a sequence of the following elements:

    Category

    0:1

    xs:string

    Key

    1:1

    xs:string

    Value

    1:1

    xs:string

    8.18. 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.19. 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.20. The complex type AddressRefStructure

    AddressRefStructure

    AddressCode

    Reference to an Address

    8.21. The toplevel element AddressRef

    AddressRef

    +AddressRef

    Reference to an Address

    8.22. The AddressDetailGroup group

    - + -

    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.

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

    →‍TopographicPlaceRef

    0:1

    →‍TopographicPlaceRef

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

    Street

    0:1

    xs:string

    Street name of the address.

    HouseNumber

    0:1

    xs:string

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

    CrossRoad

    0:1

    xs:string

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

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

    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.

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

    →‍TopographicPlaceRef

    0:1

    →‍TopographicPlaceRef

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

    Street

    0:1

    xs:string

    Street name of the address.

    HouseNumber

    0:1

    xs:string

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

    CrossRoad

    0:1

    xs:string

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

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

    SituationFullRefs

    0:1

    +SituationRefList

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

    Attribute

    0:*

    +GeneralAttribute

    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.

    8.24. The complex type PlaceStructure

    PlaceStructure

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

    The element contains a sequence of the following elements:

    Then, the element contains one of the following elements:

    a

    Address

    -1:1

    +Address

    Model of an address

    b

    PointOfInterest

    -1:1

    +PointOfInterest

    Model of a POI

    c

    StopPlace

    -1:1

    +StopPlace

    Model of a stop place

    d

    StopPoint

    -1:1

    +StopPoint

    Model of a stop point

    e

    TopographicPlace

    -1:1

    +TopographicPlace

    TopographicPlace. Region, village, or city.

    Name

    1:1

    +InternationalText

    Public name of the place.

    GeoPosition

    1:1

    siri:LocationStructure

    Position using WGS84/EPSG:4326 coordinates.

    SituationFullRefs

    0:1

    +SituationRefList

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

    Attribute

    0:*

    +GeneralAttribute

    Attribute associated with this place.

    Extension

    0:1

    xs:anyType

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

    Reference to a stop point.

    b

    →‍StopPlaceRef

    -1:1

    →‍StopPlaceRef

    Reference to a Stop Place

    c

    →‍TopographicPlaceRef

    -1:1

    →‍TopographicPlaceRef

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

    d

    →‍PointOfInterestRef

    -1:1

    →‍PointOfInterestRef

    Reference to a Point of Interest

    e

    →‍AddressRef

    -1:1

    →‍AddressRef

    Reference to an Address

    f

    GeoPosition

    -1:1

    siri:LocationStructure

    WGS84 coordinates position.

    Name

    1:1

    +InternationalText

    Public name of the place.

    AllowedSystemId

    0:*

    xs:normalizedString

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

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

    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.

    8.27. The complex type ExchangePointsProblemStructure

    @@ -559,7 +540,7 @@

    OJP - Open API for distributed Journey

    ExchangePointsProblemStructure

    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.

    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.

    StopEventRequest

    Location

    1:1

    +PlaceContext

    LOCATION / PLACE for which to obtain stop event information.

    Params

    0:1

    +StopEventParam

    Request parameter

    9.3. The complex type StopEventParamStructure

    @@ -612,10 +593,10 @@

    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.

    9.7. The StopEventResponseGroup group

    -

    StopEventResponseGroup

    Response structure for departure and arrival events at stops

    StopEventResponse

    StopEventResponseContext

    0:1

    +ResponseContext

    Container for data that is referenced multiple times.

    StopEventResult

    0:*

    +StopEventResult

    Enclosing element for stop event data.

    9.8. The complex type StopEventResultStructure

    StopEventResultStructure

    Wrapper element for a single stop event result.

    The element contains a sequence of the following elements:

    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.

    9.8. The complex type StopEventResultStructure

    StopEventResultStructure

    Wrapper element for a single stop event result.

    The element contains a sequence of the following elements:

    Id

    1:1

    ObjectId

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

    SituationFullRefs

    0:1

    +SituationRefList

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

    Extension

    0:1

    xs:anyType

    9.10. The complex type CallAtNearStopStructure

    CallAtNearStopStructure

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

    The element contains a sequence of the following elements:

    CallAtStop

    1:1

    +CallAtStop

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

    WalkDistance

    0:1

    siri:DistanceType

    Distance from request 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.

    SituationFullRefs

    0:1

    +SituationRefList

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

    Extension

    0:1

    xs:anyType

    9.10. The complex type CallAtNearStopStructure

    CallAtNearStopStructure

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

    The element contains a sequence of the following elements:

    CallAtStop

    1:1

    +CallAtStop

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

    WalkDistance

    0:1

    siri:DistanceType

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

    WalkDuration

    0:1

    xs:duration

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

    9.11. The complex type StopEventProblemStructure

    @@ -625,7 +606,7 @@

    OJP - Open API for distributed Journey

    - + @@ -696,20 +677,22 @@

    OJP - Open API for distributed Journey

    - + - + + + + - - - - + - + - + + + @@ -762,7 +745,7 @@

    OJP - Open API for distributed Journey

    -

    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.

    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

    TimedVehicleRef

    b

    →‍siri:VehicleRef

    1:1

    →‍siri:VehicleRef

    Reference to vehicle.

    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.

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

    BaseTripPolicy

    b

    NumberOfResults

    -0:1

    xs:positiveInteger

    The number of trip results that the user wants to see at least.

    UseRealtimeData

    0:1

    UseRealtimeData

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

    ImmediateTripStart

    0:1

    xs:boolean

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

    ImmediateTripStart

    0:1

    xs:boolean

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

    TransferLimit

    0:1

    xs:nonNegativeInteger

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

    Then, the element contains one of the following elements:

    a

    OptimisationMethod

    -1:1

    OptimisationMethod

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

    b

    OptimisationMethods

    -0:1

    +OptimisationMethodList

    The types of algorithm that should be used in the calculation of the trip.

    ConsiderElevationData

    0:1

    xs:boolean

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

    TripPolicy

    TransferLimit

    0:1

    xs:nonNegativeInteger

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

    Then, the element contains one of the following elements:

    a

    OptimisationMethod

    -1:1

    OptimisationMethod

    b

    OptimisationMethods

    -0:1

    +OptimisationMethodList

    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)

    TripPolicy

    ItModesToCover

    0:*

    IndividualModes

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

    BaseTripContentFilter

    IncludeTrackSections

    0:1

    xs:boolean

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

    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.

    IncludeAccessFeatures

    0:1

    xs:boolean

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

    IncludeAccessFeaturesStatus

    0:1

    xs:boolean

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

    IncludeAccessibilityDetails

    0:*

    AccessibilityDetailsProfile

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

    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

    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

    11.4. The TripDataFilterGroup group

    +

    TripDataFilterGroup

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

    FareParam

    0:1

    +FareParam

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

    Extension

    0:1

    xs:anyType

    11.4. The TripDataFilterGroup group

    @@ -774,14 +757,14 @@

    OJP - Open API for distributed Journey

    - + - + + + + - - - - +

    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.

    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.

    BaseTripPolicy

    b

    NumberOfResults

    -0:1

    xs:positiveInteger

    The number of trip results that the user wants to see at least.

    UseRealtimeData

    0:1

    UseRealtimeData

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

    ImmediateTripStart

    0:1

    xs:boolean

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

    ImmediateTripStart

    0:1

    xs:boolean

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

    TransferLimit

    0:1

    xs:nonNegativeInteger

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

    The element contains one of the following elements:

    a

    OptimisationMethod

    -1:1

    OptimisationMethod

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

    b

    OptimisationMethods

    -0:1

    +OptimisationMethodList

    The types of algorithm that should be used in the calculation of the trip.

    ConsiderElevationData

    0:1

    xs:boolean

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

    TripPolicy

    TransferLimit

    0:1

    xs:nonNegativeInteger

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

    The element contains one of the following elements:

    a

    OptimisationMethod

    -1:1

    OptimisationMethod

    b

    OptimisationMethods

    -0:1

    +OptimisationMethodList

    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)

    TripPolicy

    ItModesToCover

    0:*

    IndividualModes

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

    11.6. The TripMobilityFilterGroup group

    @@ -797,10 +780,12 @@

    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.

    AdditionalTransferTime

    0:1

    xs:duration

    Additional time added to all transfers (also to transfers between individual to public transport).

    11.7. The TripContentFilterGroup group

    - + - + + + @@ -853,13 +838,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.

    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.

    IncludeAccessFeatures

    0:1

    xs:boolean

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

    IncludeAccessFeaturesStatus

    0:1

    xs:boolean

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

    IncludeAccessibilityDetails

    0:*

    AccessibilityDetailsProfile

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

    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

    TripSummaryOnly

    0:1

    xs:boolean

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

    11.8. The complex type OptimisationMethodList

    OptimisationMethodList

    List of OptimisationMethods. The order of precedence - if used at all - is high to low. In single criteria optimisers the optimisation methods may be used in parallel and not truly used to score the results.

    The element contains only one element:

    OptimisationMethod

    1:*

    OptimisationMethod

    11.9. 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.10. 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.11. 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.12. The TripResponseGroup group

    +

    TripResponseGroup

    Trip response structure.

    11.8. The complex type OptimisationMethodList

    OptimisationMethodList

    List of OptimisationMethods. The order of precedence - if used at all - is high to low. In single criteria optimisers the optimisation methods may be used in parallel and not truly used to score the results.

    The element contains only one element:

    OptimisationMethod

    1:*

    OptimisationMethod

    11.9. The complex type NotViaStructure

    NotViaStructure

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

    The element contains only one element:

    Then, the element contains one of the following elements:

    a

    →‍siri:StopPointRef

    -1:1

    →‍siri:StopPointRef

    Reference to a not-via stop point.

    b

    →‍StopPlaceRef

    -1:1

    →‍StopPlaceRef

    Reference to a not-via stop place.

    11.10. The complex type NoChangeAtStructure

    NoChangeAtStructure

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

    The element contains only one element:

    Then, the element contains one of the following elements:

    a

    →‍siri:StopPointRef

    -1:1

    →‍siri:StopPointRef

    Reference to a no-change stop point.

    b

    →‍StopPlaceRef

    -1:1

    →‍StopPlaceRef

    Reference to a no-change stop place.

    11.11. The complex type TariffzoneFilterStructure

    TariffzoneFilterStructure

    The element contains a sequence of the following elements:

    Exclude

    0:1

    xs:boolean

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

    TariffZones

    1:1

    +TariffZoneListInArea

    List of fare zones to include or exclude.

    11.12. The TripResponseGroup group

    -

    TripResponseGroup

    Trip response structure.

    TripResponse

    TripResponseContext

    0:1

    +ResponseContext

    Context to hold trip response objects that occur frequently.

    TripResult

    0:*

    +TripResult

    The trip results found by the server.

    11.13. 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.14. 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.13. The complex type TripResultStructure

    TripResultStructure

    Structure for a single trip result and associated problems.

    The element contains a sequence of the following elements:

    Id

    1:1

    ObjectId

    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

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

    IsAlternativeOption

    0:1

    xs:boolean

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

    11.14. The complex type TripSummaryStructure

    -

    TripSummaryStructure

    Structure for trip overview information.

    The element contains a sequence of the following elements:

    TripId

    1:1

    ObjectId

    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.

    PTLegs

    0:1

    xs:nonNegativeInteger

    Number of public transport 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".

    Feasibility

    0:*

    Feasibility

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

    SituationFullRefs

    0:1

    +SituationRefList

    A list of references to SITUATIONs.

    Extension

    0:1

    xs:anyType

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

    Feasibility

    0:*

    Feasibility

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

    SituationFullRefs

    0:1

    +SituationRefList

    A list of references to SITUATIONs.

    Extension

    0:1

    xs:anyType

    11.15. The complex type TripStructure

    @@ -868,13 +853,13 @@

    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 LEGs

    The element contains a sequence of the following elements:

    Id

    1:1

    ObjectId

    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.

    Leg

    1:*

    +Leg

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

    Deviation

    0:1

    xs:boolean

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

    Delayed

    0:1

    xs:boolean

    Whether this trip is delayed. Default is false.

    Infeasible

    0:1

    xs:boolean

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

    Feasibility

    0:*

    Feasibility

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

    SituationFullRefs

    0:1

    +SituationRefList

    A list of references to SITUATIONs.

    Extension

    0:1

    xs:anyType

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

    Feasibility

    0:*

    Feasibility

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

    SituationFullRefs

    0:1

    +SituationRefList

    A list of references to SITUATIONs.

    Extension

    0:1

    xs:anyType

    11.16. The complex type LegStructure

    -

    LegStructure

    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:

    Id

    1:1

    ObjectId

    Id of this leg. Unique within trip result.

    ParticipantRef

    0:1

    siri:ParticipantRefStructure

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

    Then, the element contains one of the following elements:

    a

    ContinuousLeg

    -1:1

    +ContinuousLeg

    Leg by a continuously available service or mode of transport.

    b

    TimedLeg

    -1:1

    +TimedLeg

    Timetabled Leg.

    c

    TransferLeg

    -1:1

    +TransferLeg

    Leg to connect between different services or modes of transport (interchanges).

    Sustainability

    EmissionCO2

    0:1

    The element contains a sequence of the following elements:

    KilogramPerPersonKm

    1:1

    Kilogram by person and by kilometer of CO2 emission.

    ConfidenceLevel

    0:1

    Percentage

    Confidence level of the emission value in percent.

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

    11.17. The complex type TimedLegStructure

    @@ -900,7 +885,7 @@

    OJP - Open API for distributed Journey

    TimedLegStructure

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

    ConfidenceLevel

    0:1

    Percentage

    Confidence level of the emission value in percent.

    Extension

    0:1

    xs:anyType

    11.20. The complex type LegBoardStructure

    - + @@ -913,7 +898,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

    StopPoint

    →‍siri:StopPointRef

    1:1

    →‍siri:StopPointRef

    Reference to a stop point.

    StopPointName

    1:1

    +InternationalText

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

    NameSuffix

    0:1

    +InternationalText

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

    PlannedQuay

    0:1

    +InternationalText

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

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

    - + @@ -926,7 +911,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

    StopPoint

    →‍siri:StopPointRef

    1:1

    →‍siri:StopPointRef

    Reference to a stop point.

    StopPointName

    1:1

    +InternationalText

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

    NameSuffix

    0:1

    +InternationalText

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

    PlannedQuay

    0:1

    +InternationalText

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

    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.22. The complex type LegIntermediateStructure

    - + @@ -974,19 +959,22 @@

    OJP - Open API for distributed Journey

    - + - + + + + - - - + - + - + + + @@ -1039,26 +1027,27 @@

    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

    StopPoint

    →‍siri:StopPointRef

    1:1

    →‍siri:StopPointRef

    Reference to a stop point.

    StopPointName

    1:1

    +InternationalText

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

    NameSuffix

    0:1

    +InternationalText

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

    PlannedQuay

    0:1

    +InternationalText

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

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

    BaseTripPolicy

    b

    NumberOfResults

    -0:1

    xs:positiveInteger

    The number of trip results that the user wants to see at least.

    UseRealtimeData

    0:1

    UseRealtimeData

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

    ImmediateTripStart

    0:1

    xs:boolean

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

    ImmediateTripStart

    0:1

    xs:boolean

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

    TransferLimit

    0:1

    xs:nonNegativeInteger

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

    Then, the element contains one of the following elements:

    a

    OptimisationMethod

    -1:1

    OptimisationMethod

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

    b

    OptimisationMethods

    -0:1

    +OptimisationMethodList

    The types of algorithm that should be used in the calculation of the trip.

    ConsiderElevationData

    0:1

    xs:boolean

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

    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.

    MultiPointTripPolicy

    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.

    BaseTripContentFilter

    IncludeTrackSections

    0:1

    xs:boolean

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

    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.

    IncludeAccessFeatures

    0:1

    xs:boolean

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

    IncludeAccessFeaturesStatus

    0:1

    xs:boolean

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

    IncludeAccessibilityDetails

    0:*

    AccessibilityDetailsProfile

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

    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

    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

    11.31. The MultiPointTripPolicyGroup group

    +

    MultiPointTripPolicyGroup

    Policies that control the multi-point trip search behaviour.

    FareParam

    0:1

    +FareParam

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

    Extension

    0:1

    xs:anyType

    11.31. The MultiPointTripPolicyGroup group

    - + - + + + + - - - +

    MultiPointTripPolicyGroup

    Policies that control the multipoint 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).

    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.

    BaseTripPolicy

    b

    NumberOfResults

    -0:1

    xs:positiveInteger

    The number of trip results that the user wants to see at least.

    UseRealtimeData

    0:1

    UseRealtimeData

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

    ImmediateTripStart

    0:1

    xs:boolean

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

    ImmediateTripStart

    0:1

    xs:boolean

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

    TransferLimit

    0:1

    xs:nonNegativeInteger

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

    The element contains one of the following elements:

    a

    OptimisationMethod

    -1:1

    OptimisationMethod

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

    b

    OptimisationMethods

    -0:1

    +OptimisationMethodList

    The types of algorithm that should be used in the calculation of the trip.

    ConsiderElevationData

    0:1

    xs:boolean

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

    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.

    MultiPointTripPolicy

    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.

    11.32. The MultiPointTripResponseGroup group

    -

    MultiPointTripResponseGroup

    Multi-point trip response structure.

    MultiPointTripResponse

    MultiPointType

    0:1

    MultiPointType

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

    MultiPointTripResponseContext

    0:1

    +ResponseContext

    Context to hold trip response objects that occur frequently.

    MultiPointTripResult

    0:*

    +MultiPointTripResult

    The trip results found by the server.

    11.33. The complex type MultiPointTripResultStructure

    +

    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.33. The complex type MultiPointTripResultStructure

    -

    MultiPointTripResultStructure

    Structure for a multipoint trip result and associated problems

    The element contains a sequence of the following elements:

    Id

    1:1

    ObjectId

    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

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

    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

    11.34. The MultiPointWaitTimeGroup group

    +

    MultiPointWaitTimeGroup

    Group for wait times at origin/destination.

    TripFare

    0:*

    +TripFareResult

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

    11.34. The MultiPointWaitTimeGroup group

    MultiPointWaitTimeGroup

    Group for wait times at origin/destination.

    MultiPointWaitTime

    OriginWaitTime

    0:1

    xs:duration

    Additional wait time at origin of this trip.

    DestinationWaitTime

    0:1

    xs:duration

    Additional wait time at destination of this trip.

    11.35. The TripStatusGroup group

    @@ -1073,14 +1062,16 @@

    OJP - Open API for distributed Journey

    TripStatusGroup

    Parameters which describe the current status of a TRIP

    TripResponseContext

    0:1

    +ResponseContext

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

    11.37. The TripRefinementDataFilterGroup group

    -

    TripRefinementDataFilterGroup

    Request data filters for Refinement

    TripRefinementDataFilter

    OperatorFilter

    0:1

    +OperatorFilter

    Transport operators to include/exclude.

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

    0:*

    xs:NMTOKEN

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

    11.38. The complex type TripRefineParamStructure

    - + - + - + + + @@ -1142,8 +1133,8 @@

    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

    0:*

    xs:NMTOKEN

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

    SystemId

    0:1

    xs:normalizedString

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

    UseRealtimeData

    0:1

    UseRealtimeData

    Usage of real-time data in refinement. Default is "full".

    TripRefinementDataFilter

    OperatorFilter

    0:1

    +OperatorFilter

    Transport operators to include/exclude.

    KeepLegs

    0:1

    xs:boolean

    Shall the legs be kept or can neighbours be recalculated in one go and changed.

    RefitLegs

    0:1

    xs:boolean

    With refit, the leg is/legs are recalculated from the end point of the adjascent legs. If necessary new foot paths are added.

    CheckAvailability

    0:1

    xs:boolean

    Checks the availability of relevant legs depending on the mode/submode. Operators or system references must be set to do this (uses OJPAvailabilityRequest indirectly)

    SystemId

    0:1

    xs:normalizedString

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

    UseRealtimeData

    0:1

    UseRealtimeData

    Usage of real-time data in refinement. Default is "full".

    BaseTripContentFilter

    IncludeTrackSections

    0:1

    xs:boolean

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

    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.

    IncludeAccessFeatures

    0:1

    xs:boolean

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

    IncludeAccessFeaturesStatus

    0:1

    xs:boolean

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

    IncludeAccessibilityDetails

    0:*

    AccessibilityDetailsProfile

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

    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

    Details

    0:1

    +InternationalText

    Explanation of the problem.

    LogData

    0:1

    xs:string

    Additional log data.

    -

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

    12.1. Simple type definitions

    ReservationNeededEnumeration

    none | service | stop

    Possible types of reservation needed for services.

    UseRealtimeDataEnumeration

    full | explanatory | none

    VehicleProgressEnumeration

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

    Vehicle progress relative to timetable service pattern.

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

    StopPoint

    →‍siri:StopPointRef

    1:1

    →‍siri:StopPointRef

    AccessibilityDetailsProfileEnumeration

    visualImpairment | auditoryImpairment | mobilityImpairment | bicycle | general

    Allowed values for AccessibilityDetails.

    ReservationNeededEnumeration

    none | service | stop

    Possible types of reservation needed for services.

    UseRealtimeDataEnumeration

    full | explanatory | none

    VehicleProgressEnumeration

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

    Vehicle progress relative to timetable service pattern.

    12.2. The complex type ServiceViaPointStructure

    + @@ -1183,8 +1174,8 @@

    OJP - Open API for distributed Journey

    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

    Reference to a stop point.

    StopPointName

    1:1

    +InternationalText

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

    NameSuffix

    0:1

    +InternationalText

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

    PlannedQuay

    0:1

    +InternationalText

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

    12.9. The RouteDescriptionGroup group

    RouteDescriptionGroup

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

    RouteDescription

    RouteDescriptionText

    1:1

    +InternationalText

    12.10. The DatedJourneyGroup group

    - - + + @@ -1207,8 +1198,8 @@

    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

    DatedJourney

    →‍OperatingDayRef

    1:1

    →‍OperatingDayRef

    Reference to an Operating Day.

    →‍siri:VehicleRef

    0:1

    →‍siri:VehicleRef

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

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

    OrganisationRef

    0:1

    siri:OperatorRefStructure

    InfoUrl

    0:1

    +WebLink

    Link to web page providing more details on service.

    12.12. The complex type DatedJourneyStructure

    - - + + @@ -1241,7 +1232,7 @@

    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

    DatedJourney

    a

    →‍OperatingDayRef

    1:1

    →‍OperatingDayRef

    Reference to an Operating Day.

    a

    →‍siri:VehicleRef

    0:1

    →‍siri:VehicleRef

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

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

    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.

    SituationFullRefs

    0:1

    +SituationRefList

    A list of references to SITUATIONs.

    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.

    BookingArrangements

    0:1

    +BookingArrangementsContainer

    Container with information on booking possibilities for this service.

    ReservationNeeded

    0:1

    ReservationNeeded

    Indicates whether this service needs some kind of reservation or booking to run.

    SituationFullRefs

    0:1

    +SituationRefList

    A list of references to SITUATIONs.

    Extension

    0:1

    xs:anyType

    12.13. The complex type TripLocationStructure

    TripLocationStructure

    A trip location represents the current logical position of a journey service. It can be used similarly to a place e.g. for starting a new trip requests from within this service. A trip location does not(!) describe the relative position of a traveller within a vehicle, e.g. the seat.

    The element contains a sequence of the following elements:

    →‍OperatingDayRef

    1:1

    →‍OperatingDayRef

    Reference to an Operating Day

    →‍JourneyRef

    1:1

    →‍JourneyRef

    Reference to a Journey

    →‍siri:LineIdentityGroup

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

    12.15. The ServiceTimeGroup group

    @@ -1272,7 +1263,7 @@

    OJP - Open API for distributed Journey

    ServiceTimeGroup

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

    EstimatedTimeHigh

    0:1

    xs:dateTime

    Estimated upper limit for time.

    12.19. The complex type CallAtStopStructure

    - + @@ -1297,8 +1288,8 @@

    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

    StopPoint

    →‍siri:StopPointRef

    1:1

    →‍siri:StopPointRef

    Reference to a stop point.

    StopPointName

    1:1

    +InternationalText

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

    NameSuffix

    0:1

    +InternationalText

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

    PlannedQuay

    0:1

    +InternationalText

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

    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.

    12.22. The complex type ContinuousServiceStructure

    - - + + @@ -1315,22 +1306,25 @@

    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

    DatedJourney

    a

    →‍OperatingDayRef

    1:1

    →‍OperatingDayRef

    Reference to an Operating Day.

    a

    →‍siri:VehicleRef

    0:1

    →‍siri:VehicleRef

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

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

    a

    Attribute

    0:*

    +GeneralAttribute

    Note or service attribute.

    b

    SharingService

    -0:1

    +SharingService

    b

    SharingService

    -0:1

    +SharingService

    Shared mobility offer.

    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.

    SituationFullRefs

    0:1

    +SituationRefList

    A list of references to SITUATIONs.

    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

    BookingArrangements

    0:1

    +BookingArrangementsContainer

    Container with information on booking possibilities for this service.

    SituationFullRefs

    0:1

    +SituationRefList

    A list of references to SITUATIONs.

    Extension

    0:1

    xs:anyType

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

    TripLocation

    -1:1

    +TripLocation

    Location within a (moving) vehicle.

    Then, the element contains one of the following elements:

    a

    DepArrTime

    -0:1

    xs:dateTime

    Time when departure/arrival from/to location is required.

    b

    TimeAllowance

    -0:1

    xs:duration

    Extra time needed before reaching/after leaving this location.

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

    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.

    BaseTripPolicy

    b

    NumberOfResults

    -0:1

    xs:positiveInteger

    The number of trip results that the user wants to see at least.

    UseRealtimeData

    0:1

    UseRealtimeData

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

    ImmediateTripStart

    0:1

    xs:boolean

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

    ImmediateTripStart

    0:1

    xs:boolean

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

    TransferLimit

    0:1

    xs:nonNegativeInteger

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

    The element contains one of the following elements:

    a

    OptimisationMethod

    -1:1

    OptimisationMethod

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

    b

    OptimisationMethods

    -0:1

    +OptimisationMethodList

    The types of algorithm that should be used in the calculation of the trip.

    ConsiderElevationData

    0:1

    xs:boolean

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

    12.27. The BaseTripMobilityFilterGroup group

    @@ -1339,23 +1333,25 @@

    OJP - Open API for distributed Journey

    BaseTripMobilityFilterGroup

    Base mobility options to be applied for both public and individual transport.

    BaseTripMobilityFilter

    NoSingleStep

    0:1

    xs:boolean

    The user is not able to climb one step.

    NoStairs

    0:1

    xs:boolean

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

    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.

    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.

    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.

    IncludeAccessFeatures

    0:1

    xs:boolean

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

    IncludeAccessFeaturesStatus

    0:1

    xs:boolean

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

    IncludeAccessibilityDetails

    0:*

    AccessibilityDetailsProfile

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

    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

    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.

    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

    +

    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 leg section together with time information.

    12.31. The complex type TrackSectionStructure

    TrackSectionStructure

    LINK PROJECTION on the infrastructure network of the 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

    AVAILABILITY_NOSERVICEFOUND | AVAILABILITY_LOCATIONUNSERVED | AVAILABILITY_LOCATIONUNKNOWN | AVAILABILITY_OUTSIDERULES | AVAILABILITY_SERVICEDISRUPTED | AVAILABILITY_UNAVAILABLE | AVAILABILITY_OTHER

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

    BookableServiceItemTypeEnumeration

    wheelchair | motorisedWheelchair | foldableWheelchair | walkingFrame | pram | heavyLuggage | childSeatTakenAlong | childSeatSupplied | babyCarrierTakenAlong | babyCarrierSupplied | seatBoosterSupplied | bicycle | guideDog | dog | boardingAssistance | alightingAssistance | onboardAssistance | unassistedMinorAssistance

    Types of bookable service items.

    13.2. The AvailabilityRequestGroup group

    - - + +

    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

    MinMaxTimeBand

    EarliestDepartureTime

    0:1

    xs:dateTime

    Earliest possible departure time from start location.

    LatestArrivalTime

    0:1

    xs:dateTime

    Latest possible arrival time at destination location.

    AvailabilityRequest

    Extension

    0:1

    xs:anyType

    13.3. The complex type BookingPTLegStructure

    @@ -1409,8 +1405,8 @@

    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.

    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.

    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

    MinMaxTimeBand

    EarliestDepartureTime

    0:1

    xs:dateTime

    Earliest possible departure time from start location.

    LatestArrivalTime

    0:1

    xs:dateTime

    Latest possible arrival time at destination location.

    13.7. The PassengerProfileGroup group

    @@ -1444,7 +1440,8 @@

    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.

    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.

    13.10. The AvailabilityResponseGroup group

    - + +

    AvailabilityResponseGroup

    Availability response.

    AvailabilityResponse

    AvailabilityResult

    0:1

    +AvailabilityResult

    Indication of the availability of the requested service.

    AvailabilityResponse

    AvailabilityResponseContext

    0:1

    +ResponseContext

    Context to hold availability response objects that occur frequently.

    AvailabilityResult

    0:1

    +AvailabilityResult

    Indication of the availability of the requested service.

    Extension

    0:1

    xs:anyType

    13.11. The complex type AvailabilityResultStructure

    @@ -1459,7 +1456,7 @@

    OJP - Open API for distributed Journey

    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.

    Details

    0:1

    +InternationalText

    Explanation of the problem.

    LogData

    0:1

    xs:string

    Additional log data.

    -

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

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

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

    ObjectIdType

    xs:normalizedString

    Type for identifier of a NeTEx Object.

    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

    @@ -1467,7 +1464,7 @@

    OJP - Open API for distributed Journey

    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.

    DatedJourneyRef

    →‍JourneyRef

    1:1

    →‍JourneyRef

    Reference to a Journey

    →‍OperatingDayRef

    1:1

    →‍OperatingDayRef

    Reference to an Operating Day

    14.16. The TimedVehicleRefGroup group

    - +

    TimedVehicleRefGroup

    Reference to a vehicle for a specific point in time.

    TimedVehicleRef

    →‍siri:VehicleRef

    1:1

    →‍siri:VehicleRef

    TimedVehicleRef

    →‍siri:VehicleRef

    1:1

    →‍siri:VehicleRef

    Reference to vehicle.

    TimeOfOperation

    1:1

    xs:dateTime

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

    14.17. 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.18. The SharingServiceUsageGroup group

    @@ -1498,14 +1495,14 @@

    OJP - Open API for distributed Journey

    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.

    15.3. The ServiceFacilityGroup group

    ServiceFacilityGroup

    Wrapper for SIRI service facilities.

    →‍siri:ServiceFacilityGroup

    -

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

    16.1. Simple type definitions

    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

    +

    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 | park-ride-car

    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.

    16.4. The ModeGroup group

    ModeGroup

    Elements for a Transport Mode

    Mode

    PtMode

    1:1

    siri:VehicleModesOfTransportEnumeration

    Categorisation of mode

    →‍siri:PtModeChoiceGroup

    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

    +

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

    17.1. The complex type SituationsStructure

    SituationFullRefStructure

    siri:SituationFullRefStructure

    Reference structure for situation message. Situation details might be found in response context or through other communication channels.

    SituationsStructure

    Wrapper type for SIRI PtSituationsElementStructure

    The element contains a sequence of the following elements:

    PtSituation

    0:*

    siri:PtSituationElementStructure

    SIRI situation details in public transport, see CEN/TS 15531-5.

    RoadSituation

    0:*

    siri:RoadSituationElementStructure

    SIRI situation details in individual transport, see CEN/TS 15531-5.

    17.2. The toplevel element SituationFullRef

    SituationFullRef

    +SituationFullRef

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

    17.3. The complex type SituationFullRefStructure

    SituationFullRefStructure

    siri:SituationFullRefStructure

    Reference structure for situation message. Situation details might be found in response context or through other communication channels.

    17.4. The complex type SituationRefList

    SituationRefList

    List of references to SITUATIONs.

    The element contains only one element:

    →‍SituationFullRef

    1:*

    →‍SituationFullRef

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

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

    18.1. Simple type definitions

    EMailAddressType

    xs:normalizedString

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

    diff --git a/examples/functions/triprefine/RefinementRequest.xml b/examples/functions/triprefine/RefinementRequest.xml index 813f78416..024ad9208 100644 --- a/examples/functions/triprefine/RefinementRequest.xml +++ b/examples/functions/triprefine/RefinementRequest.xml @@ -12,7 +12,7 @@ 3SBB:ojp:prodfull - true + truetruetruedifficult @@ -147,7 +147,7 @@ 47.042666496 8.306332108 - + Taxiplatz Luzern @@ -178,7 +178,7 @@ - + @@ -187,24 +187,24 @@ - - - 8530813 - - Zürich Kreuzplatz - - 23026261:27 - - - Zürich - - - 8.55408 - 47.36488 - - + + + 8530813 + + Zürich Kreuzplatz + + 23026261:27 + + + Zürich + + + 8.55408 + 47.36488 + + - + diff --git a/examples/functions/triprefine/RefinementResponse.xml b/examples/functions/triprefine/RefinementResponse.xml index c77e36f9b..6fdc7951e 100644 --- a/examples/functions/triprefine/RefinementResponse.xml +++ b/examples/functions/triprefine/RefinementResponse.xml @@ -20,7 +20,8 @@ 2020-09-30T12:21:00Z0125484 - + + 1 @@ -32,11 +33,13 @@ 4 - 5 - + 5 + + 2020-09-30T10:03:00Z - 2020-09-30T10:06:00Z + 2020-09-30T10:06:00Z + 1 @@ -109,7 +112,8 @@ - 2 + 2 + walk @@ -130,14 +134,15 @@ PT3M - + + 3 47.042666496 8.306332108 - + Taxiplatz Luzern @@ -145,10 +150,12 @@ 47.06 - 8.31 + 8.31 + - New destination + New destination + @@ -164,11 +171,12 @@ - PT11M + PT11M + - + - +

    WebLinkGroup

    URL of a web resource including type of resource.