From 990de4d966b9a43cf62e4b8fb3c1cba5497be406 Mon Sep 17 00:00:00 2001 From: ue71603 Date: Fri, 26 Aug 2022 12:25:53 +0200 Subject: [PATCH 01/13] Added AccessibiliyFeature Type --- OJP/OJP_Trips.xsd | 31 ++++++++++++++++++++++++++++++- 1 file changed, 30 insertions(+), 1 deletion(-) diff --git a/OJP/OJP_Trips.xsd b/OJP/OJP_Trips.xsd index 03671577f..ea9a251e9 100644 --- a/OJP/OJP_Trips.xsd +++ b/OJP/OJP_Trips.xsd @@ -703,12 +703,17 @@ Allowed values for a AccessFeature. - + + + + + + @@ -722,6 +727,25 @@ + + + + Allowed values for AccessibilityFeatures. + + + + + + + + + + + + + + + @@ -743,6 +767,11 @@ Number how often the access feature occurs in this PathLink + + + Presence of accessibility features on the PathLink. + + From 4783897a329853f2775f1878aea30e20c22ee4ba Mon Sep 17 00:00:00 2001 From: Travis CI User Date: Fri, 26 Aug 2022 10:27:06 +0000 Subject: [PATCH 02/13] Travis CI update [skip ci] --- OJP/OJP_Trips.xsd | 4 ++-- docs/generated/OJP.html | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/OJP/OJP_Trips.xsd b/OJP/OJP_Trips.xsd index ea9a251e9..3eb9c1526 100644 --- a/OJP/OJP_Trips.xsd +++ b/OJP/OJP_Trips.xsd @@ -728,7 +728,7 @@ - + Allowed values for AccessibilityFeatures. @@ -771,7 +771,7 @@ Presence of accessibility features on the PathLink. - + diff --git a/docs/generated/OJP.html b/docs/generated/OJP.html index 4bbfbfe1e..a1c15cfd3 100644 --- a/docs/generated/OJP.html +++ b/docs/generated/OJP.html @@ -740,7 +740,7 @@

OJP - Open API for distributed Journey

→‍siri:ServiceFacilityGroup

JourneyTrack

0:1

+LegTrack

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

Extension

0:1

xs:anyType

-

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

15.1. Simple type definitions

AccessFeatureTypeEnumeration

lift | stairs | seriesOfStairs | escalator | ramp | footpath

Allowed values for a AccessFeature.

GuidanceAdviceEnumeration

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

various types of guidance advice given to travelle

MultiPointTypeEnumeration

anyPoint | eachOrigin | eachDestination

How the multiple origin/destination points should be considered

OptimisationMethodEnumeration

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

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

TransitionEnumeration

up | down | level | upAndDown | downAndUp

Transition types for interchanges.

TurnActionEnumeration

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

the range of alternative turns that can be described

15.2. The TripRequestGroup group

+

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

15.1. Simple type definitions

TripRequestGroup

Trip request structure.

AccessFeatureTypeEnumeration

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

Allowed values for a AccessFeature.

AccessibilityFeaturesTypeEnumeration

visualSigns | tactileGuidingStrips | tactileOrAuditorySigns | elevatorAccousticAnnouncements | elevatorTactileButtons | elevatorSuitableForCycles | entranceLevelAccess | entranceLiftInVehicle | entranceAssistedLiftOnPlatform | entranceAssistedRamp | entranceSlidingStep | entranceUnassistedWheelchairSuitable

Allowed values for AccessibilityFeatures.

GuidanceAdviceEnumeration

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

various types of guidance advice given to travelle

MultiPointTypeEnumeration

anyPoint | eachOrigin | eachDestination

How the multiple origin/destination points should be considered

OptimisationMethodEnumeration

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

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

TransitionEnumeration

up | down | level | upAndDown | downAndUp

Transition types for interchanges.

TurnActionEnumeration

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

the range of alternative turns that can be described

15.2. The TripRequestGroup group

@@ -904,7 +904,7 @@

OJP - Open API for distributed Journey

-

TripRequestGroup

Trip request structure.

TripRequest

Origin

1:*

+PlaceContext

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

Destination

1:*

+PlaceContext

Specifies the destination situation where the user is heading to.

Via

0:*

+TripVia

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

TransferDuration

Duration

1:1

xs:duration

Overall duration of this interchange.

WalkDuration

0:1

xs:duration

Walk time as part of the overall interchange duration.

BufferTime

0:1

xs:duration

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

15.24. The complex type PathLinkStructure

PathLinkStructure

[TMv6] a link within a PLACE of or between two PLACEs (that is STOP PLACEs, ACCESS SPACEs or QUAYs,BOARDING POSITIONs,, POINTs OF INTEREST etc or PATH JUNCTIONs) that represents a step in a possible route for pedestrians, cyclists or other out-of-vehicle passengers within or between a PLACE.

The element contains a sequence of the following elements:

Transition

0:1

Transition

Whether path is up down or level .

AccessFeatureType

0:1

AccessFeatureType

Type of physical feature of PATH LINK.

Count

0:1

xs:positiveInteger

Number how often the access feature occurs in this PathLink

15.25. The MultiPointTripRequestGroup group

+

MultiPointTripRequestGroup

Multi-point trip request structure.

15.24. The complex type PathLinkStructure

PathLinkStructure

[TMv6] a link within a PLACE of or between two PLACEs (that is STOP PLACEs, ACCESS SPACEs or QUAYs,BOARDING POSITIONs,, POINTs OF INTEREST etc or PATH JUNCTIONs) that represents a step in a possible route for pedestrians, cyclists or other out-of-vehicle passengers within or between a PLACE.

The element contains a sequence of the following elements:

Transition

0:1

Transition

Whether path is up down or level .

AccessFeatureType

0:1

AccessFeatureType

Type of physical feature of PATH LINK.

Count

0:1

xs:positiveInteger

Number how often the access feature occurs in this PathLink

AccessibilityFeatures

0:*

AccessibilityFeaturesType

Presence of accessibility features on the PathLink.

15.25. The MultiPointTripRequestGroup group

From 0d3529ddb5129d5cfdd0e25463e387d27ac17a72 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Matthias=20G=C3=BCnter?= Date: Thu, 1 Sep 2022 13:45:45 +0200 Subject: [PATCH 03/13] fixed Accoustic -> Acoustic --- OJP/OJP_Trips.xsd | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/OJP/OJP_Trips.xsd b/OJP/OJP_Trips.xsd index 3eb9c1526..df3a17c76 100644 --- a/OJP/OJP_Trips.xsd +++ b/OJP/OJP_Trips.xsd @@ -736,7 +736,7 @@ - + From 180bbb66c94c7415c1aef57c257e70ae87a06585 Mon Sep 17 00:00:00 2001 From: Travis CI User Date: Thu, 1 Sep 2022 11:46:54 +0000 Subject: [PATCH 04/13] Travis CI update [skip ci] --- docs/generated/OJP.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/generated/OJP.html b/docs/generated/OJP.html index a1c15cfd3..1a54ec811 100644 --- a/docs/generated/OJP.html +++ b/docs/generated/OJP.html @@ -740,7 +740,7 @@

OJP - Open API for distributed Journey

MultiPointTripRequestGroup

Multi-point trip request structure.

MultiPointTripRequest

Origin

1:*

+PlaceContext

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

Destination

1:*

+PlaceContext

Specifies the destination situation where the user is heading to.

Via

0:*

+TripVia

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

→‍siri:ServiceFacilityGroup

JourneyTrack

0:1

+LegTrack

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

Extension

0:1

xs:anyType

-

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

15.1. Simple type definitions

AccessFeatureTypeEnumeration

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

Allowed values for a AccessFeature.

AccessibilityFeaturesTypeEnumeration

visualSigns | tactileGuidingStrips | tactileOrAuditorySigns | elevatorAccousticAnnouncements | elevatorTactileButtons | elevatorSuitableForCycles | entranceLevelAccess | entranceLiftInVehicle | entranceAssistedLiftOnPlatform | entranceAssistedRamp | entranceSlidingStep | entranceUnassistedWheelchairSuitable

Allowed values for AccessibilityFeatures.

GuidanceAdviceEnumeration

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

various types of guidance advice given to travelle

MultiPointTypeEnumeration

anyPoint | eachOrigin | eachDestination

How the multiple origin/destination points should be considered

OptimisationMethodEnumeration

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

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

TransitionEnumeration

up | down | level | upAndDown | downAndUp

Transition types for interchanges.

TurnActionEnumeration

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

the range of alternative turns that can be described

15.2. The TripRequestGroup group

+

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

15.1. Simple type definitions

TripRequestGroup

Trip request structure.

AccessFeatureTypeEnumeration

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

Allowed values for a AccessFeature.

AccessibilityFeaturesTypeEnumeration

visualSigns | tactileGuidingStrips | tactileOrAuditorySigns | elevatorAcousticAnnouncements | elevatorTactileButtons | elevatorSuitableForCycles | entranceLevelAccess | entranceLiftInVehicle | entranceAssistedLiftOnPlatform | entranceAssistedRamp | entranceSlidingStep | entranceUnassistedWheelchairSuitable

Allowed values for AccessibilityFeatures.

GuidanceAdviceEnumeration

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

various types of guidance advice given to travelle

MultiPointTypeEnumeration

anyPoint | eachOrigin | eachDestination

How the multiple origin/destination points should be considered

OptimisationMethodEnumeration

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

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

TransitionEnumeration

up | down | level | upAndDown | downAndUp

Transition types for interchanges.

TurnActionEnumeration

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

the range of alternative turns that can be described

15.2. The TripRequestGroup group

From b6f7ccde3194d10b1447a199ada65cdab0c210ed Mon Sep 17 00:00:00 2001 From: trurlurl <82838870+trurlurl@users.noreply.github.com> Date: Thu, 20 Oct 2022 09:01:05 +0200 Subject: [PATCH 05/13] Update OJP_Trips.xsd All enums, as discussed in the meeting. --- OJP/OJP_Trips.xsd | 51 +++++++++++++++++++++++++++++++++++++---------- 1 file changed, 41 insertions(+), 10 deletions(-) diff --git a/OJP/OJP_Trips.xsd b/OJP/OJP_Trips.xsd index df3a17c76..a808835a7 100644 --- a/OJP/OJP_Trips.xsd +++ b/OJP/OJP_Trips.xsd @@ -712,6 +712,7 @@ + @@ -733,18 +734,48 @@ Allowed values for AccessibilityFeatures. - + + For mobility impairments... + + + + + + + + + + + + + + + + + For sensory impairments... + + - - - - - - - - - + + + + + + + + + + Assistance... + + + + + + To pay attention to... + + + From 2fb0590d4509d5ca2418458519571ac246f3771a Mon Sep 17 00:00:00 2001 From: trurlurl <82838870+trurlurl@users.noreply.github.com> Date: Thu, 20 Oct 2022 09:24:03 +0200 Subject: [PATCH 06/13] Update OJP_Trips.xsd Comments --- OJP/OJP_Trips.xsd | 16 ++++------------ 1 file changed, 4 insertions(+), 12 deletions(-) diff --git a/OJP/OJP_Trips.xsd b/OJP/OJP_Trips.xsd index a808835a7..b2ed7e433 100644 --- a/OJP/OJP_Trips.xsd +++ b/OJP/OJP_Trips.xsd @@ -734,9 +734,7 @@ Allowed values for AccessibilityFeatures. - - For mobility impairments... - + @@ -751,9 +749,7 @@ - - For sensory impairments... - + @@ -765,15 +761,11 @@ - - Assistance... - + - - To pay attention to... - + From 3a46153b7b94677b57b087c1fd077985bced6509 Mon Sep 17 00:00:00 2001 From: Travis CI User Date: Thu, 20 Oct 2022 07:25:20 +0000 Subject: [PATCH 07/13] Travis CI update [skip ci] --- docs/generated/OJP.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/generated/OJP.html b/docs/generated/OJP.html index 1a54ec811..f3dfe6962 100644 --- a/docs/generated/OJP.html +++ b/docs/generated/OJP.html @@ -740,7 +740,7 @@

OJP - Open API for distributed Journey

TripRequestGroup

Trip request structure.

TripRequest

Origin

1:*

+PlaceContext

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

Destination

1:*

+PlaceContext

Specifies the destination situation where the user is heading to.

Via

0:*

+TripVia

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

→‍siri:ServiceFacilityGroup

JourneyTrack

0:1

+LegTrack

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

Extension

0:1

xs:anyType

-

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

15.1. Simple type definitions

AccessFeatureTypeEnumeration

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

Allowed values for a AccessFeature.

AccessibilityFeaturesTypeEnumeration

visualSigns | tactileGuidingStrips | tactileOrAuditorySigns | elevatorAcousticAnnouncements | elevatorTactileButtons | elevatorSuitableForCycles | entranceLevelAccess | entranceLiftInVehicle | entranceAssistedLiftOnPlatform | entranceAssistedRamp | entranceSlidingStep | entranceUnassistedWheelchairSuitable

Allowed values for AccessibilityFeatures.

GuidanceAdviceEnumeration

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

various types of guidance advice given to travelle

MultiPointTypeEnumeration

anyPoint | eachOrigin | eachDestination

How the multiple origin/destination points should be considered

OptimisationMethodEnumeration

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

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

TransitionEnumeration

up | down | level | upAndDown | downAndUp

Transition types for interchanges.

TurnActionEnumeration

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

the range of alternative turns that can be described

15.2. The TripRequestGroup group

+

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

15.1. Simple type definitions

TripRequestGroup

Trip request structure.

AccessFeatureTypeEnumeration

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

Allowed values for a AccessFeature.

AccessibilityFeaturesTypeEnumeration

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

Allowed values for AccessibilityFeatures.

GuidanceAdviceEnumeration

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

various types of guidance advice given to travelle

MultiPointTypeEnumeration

anyPoint | eachOrigin | eachDestination

How the multiple origin/destination points should be considered

OptimisationMethodEnumeration

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

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

TransitionEnumeration

up | down | level | upAndDown | downAndUp

Transition types for interchanges.

TurnActionEnumeration

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

the range of alternative turns that can be described

15.2. The TripRequestGroup group

From f0f842178bd903d1c6a3dfe3f41d4e3fc8da1690 Mon Sep 17 00:00:00 2001 From: Travis CI User Date: Wed, 26 Oct 2022 13:42:39 +0000 Subject: [PATCH 08/13] Travis CI update [skip ci] --- docs/generated/OJP.html | 73 +++++++++++++++++++++-------------------- 1 file changed, 37 insertions(+), 36 deletions(-) diff --git a/docs/generated/OJP.html b/docs/generated/OJP.html index dff0ef4f0..81f35c5dc 100644 --- a/docs/generated/OJP.html +++ b/docs/generated/OJP.html @@ -805,14 +805,14 @@

OJP - Open API for distributed Journey

-

TripRequestGroup

Trip request structure.

TripRequest

Origin

1:*

+PlaceContext

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

Destination

1:*

+PlaceContext

Specifies the destination situation where the user is heading to.

Via

0:*

+TripVia

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

OperatingDaysDescription

0:1

+InternationalText

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

→‍siri:ServiceFacilityGroup

JourneyTrack

0:1

+LegTrack

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

Extension

0:1

xs:anyType

-

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

15.1. Simple type definitions

AccessFeatureTypeEnumeration

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

Allowed values for a AccessFeature.

AccessibilityFeaturesTypeEnumeration

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

Allowed values for AccessibilityFeatures.

GuidanceAdviceEnumeration

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

various types of guidance advice given to travelle

MultiPointTypeEnumeration

anyPoint | eachOrigin | eachDestination

How the multiple origin/destination points should be considered

OptimisationMethodEnumeration

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

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

TransitionEnumeration

up | down | level | upAndDown | downAndUp

Transition types for interchanges.

TurnActionEnumeration

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

the range of alternative turns that can be described

15.2. The TripRequestGroup group

- - - - - - +

TripRequestGroup

Trip request structure.

TripRequest

Origin

1:*

+PlaceContext

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

Destination

1:*

+PlaceContext

Specifies the destination situation where the user is heading to.

Via

0:*

+TripVia

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

NotVia

0:*

+NotVia

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

NoChangeAt

0:*

+NoChangeAt

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

Params

0:1

+TripParam

Options to control the search behaviour and response contents.

JourneyTrack

0:1

+LegTrack

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

Extension

0:1

xs:anyType

+

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

15.1. Simple type definitions

AccessFeatureTypeEnumeration

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

Allowed values for a AccessFeature.

AccessibilityFeaturesTypeEnumeration

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

Allowed values for AccessibilityFeatures.

GuidanceAdviceEnumeration

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

various types of guidance advice given to travelle

MultiPointTypeEnumeration

anyPoint | eachOrigin | eachDestination

How the multiple origin/destination points should be considered

OptimisationMethodEnumeration

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

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

TransitionEnumeration

up | down | level | upAndDown | downAndUp

Transition types for interchanges.

TurnActionEnumeration

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

the range of alternative turns that can be described

15.2. The TripRequestGroup group

+ + + + + +

TripRequestGroup

Trip request structure.

TripRequest

Origin

1:*

+PlaceContext

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

Destination

1:*

+PlaceContext

Specifies the destination situation where the user is heading to.

Via

0:*

+TripVia

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

NotVia

0:*

+NotVia

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

NoChangeAt

0:*

+NoChangeAt

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

Params

0:1

+TripParam

Options to control the search behaviour and response contents.

15.3. The complex type TripParamStructure

@@ -956,34 +956,35 @@

OJP - Open API for distributed Journey

TripParamStructure

Trip request parameter structure.

The element contains a sequence of the following elements:

TripDataFilter

PtModeFilter

0:1

+PtModeFilter

Modes to be considered in trip calculation.

LineFilter

0:1

+LineDirectionFilter

Lines/Directions to include/exclude.

NoBoardingAtStop

0:1

xs:boolean

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

NoAlightingAtStop

0:1

xs:boolean

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

15.20. The complex type LegIntermediateStructure

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

LegIntermediateStructure

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

The element contains a sequence of the following elements:

StopPoint

→‍siri:StopPointRef

1:1

→‍siri:StopPointRef

StopPointName

1:1

+InternationalText

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

NameSuffix

0:1

+InternationalText

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

PlannedQuay

0:1

+InternationalText

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

EstimatedQuay

0:1

+InternationalText

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

ServiceArrival

1:1

+ServiceArrival

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

ServiceDeparture

1:1

+ServiceDeparture

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

MeetsViaRequest

0:1

xs:boolean

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

StopCallStatus

Order

0:1

xs:positiveInteger

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

RequestStop

0:1

xs:boolean

The vehicle journey calls at this stop only on demand.

UnplannedStop

0:1

xs:boolean

This stop has not been planned by the planning department.

NotServicedStop

0:1

xs:boolean

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

NoBoardingAtStop

0:1

xs:boolean

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

NoAlightingAtStop

0:1

xs:boolean

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

15.21. The complex type PathGuidanceStructure

PathGuidanceStructure

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

The element contains only one element:

PathGuidanceSection

1:*

+PathGuidanceSection

one or more path guidance sections that build the trip Leg

15.22. The complex type PathGuidanceSectionStructure

PathGuidanceSectionStructure

[an extended definition of a NAVIGATION PATH in TMv6 to include the textual navigation instructions] description of a piece of a TRIP. May include geographic information, turn instructions and accessibility information

The element contains a sequence of the following elements:

TrackSection

0:1

+TrackSection

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

TurnDescription

0:1

+InternationalText

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

GuidanceAdvice

0:1

GuidanceAdvice

various types of guidance advice given to travelle.

TurnAction

0:1

TurnAction

the range of alternative turns that can be described.

DirectionHint

0:1

+InternationalText

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

Bearing

0:1

siri:AbsoluteBearingType

Absolute bearing after the described manoeuvre.

PathLink

0:1

+PathLink

Description of the type of accessibility on this navigation section.

SituationFullRef

0:*

+SituationFullRef

15.23. The TransferDurationGroup group

- - - -

TransferDurationGroup

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

TransferDuration

Duration

1:1

xs:duration

Overall duration of this interchange.

WalkDuration

0:1

xs:duration

Walk time as part of the overall interchange duration.

BufferTime

0:1

xs:duration

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

15.24. The complex type PathLinkStructure

PathLinkStructure

[TMv6] a link within a PLACE of or between two PLACEs (that is STOP PLACEs, ACCESS SPACEs or QUAYs,BOARDING POSITIONs,, POINTs OF INTEREST etc or PATH JUNCTIONs) that represents a step in a possible route for pedestrians, cyclists or other out-of-vehicle passengers within or between a PLACE.

The element contains a sequence of the following elements:

Transition

0:1

Transition

Whether path is up down or level .

AccessFeatureType

0:1

AccessFeatureType

Type of physical feature of PATH LINK.

Count

0:1

xs:positiveInteger

Number how often the access feature occurs in this PathLink

AccessibilityFeatures

0:*

AccessibilityFeaturesType

Presence of accessibility features on the PathLink.

15.25. The MultiPointTripRequestGroup group

- - - - - - -

MultiPointTripRequestGroup

Multi-point trip request structure.

MultiPointTripRequest

Origin

1:*

+PlaceContext

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

Destination

1:*

+PlaceContext

Specifies the destination situation where the user is heading to.

Via

0:*

+TripVia

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

NotVia

0:*

+NotVia

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

NoChangeAt

0:*

+NoChangeAt

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

Params

0:1

+MultiPointTripParam

Options to control the search behaviour and response contents.

15.26. The complex type MultiPointTripParamStructure

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

MultiPointTripParamStructure

Multi-point trip request parameter structure.

The element contains a sequence of the following elements:

TripDataFilter

PtModeFilter

0:1

+PtModeFilter

Modes to be considered in trip calculation.

LineFilter

0:1

+LineDirectionFilter

Lines/Directions to include/exclude.

OperatorFilter

0:1

+OperatorFilter

Transport operators to include/exclude.

PrivateModeFilter

0:1

+PrivateModeFilter

Private mobility options to include/exclude.

StopPoint

→‍siri:StopPointRef

1:1

→‍siri:StopPointRef

StopPointName

1:1

+InternationalText

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

NameSuffix

0:1

+InternationalText

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

PlannedQuay

0:1

+InternationalText

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

EstimatedQuay

0:1

+InternationalText

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

ServiceArrival

1:1

+ServiceArrival

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

ServiceDeparture

1:1

+ServiceDeparture

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

MeetsViaRequest

0:1

xs:boolean

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

StopCallStatus

Order

0:1

xs:positiveInteger

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

RequestStop

0:1

xs:boolean

The vehicle journey calls at this stop only on demand.

UnplannedStop

0:1

xs:boolean

This stop has not been planned by the planning department.

NotServicedStop

0:1

xs:boolean

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

NoBoardingAtStop

0:1

xs:boolean

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

NoAlightingAtStop

0:1

xs:boolean

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

15.21. The complex type PathGuidanceStructure

PathGuidanceStructure

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

The element contains only one element:

PathGuidanceSection

1:*

+PathGuidanceSection

one or more path guidance sections that build the trip Leg

15.22. The complex type PathGuidanceSectionStructure

PathGuidanceSectionStructure

[an extended definition of a NAVIGATION PATH in TMv6 to include the textual navigation instructions] description of a piece of a TRIP. May include geographic information, turn instructions and accessibility information

The element contains a sequence of the following elements:

TrackSection

0:1

+TrackSection

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

TurnDescription

0:1

+InternationalText

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

GuidanceAdvice

0:1

GuidanceAdvice

various types of guidance advice given to travelle.

TurnAction

0:1

TurnAction

the range of alternative turns that can be described.

DirectionHint

0:1

+InternationalText

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

Bearing

0:1

siri:AbsoluteBearingType

Absolute bearing after the described manoeuvre.

PathLink

0:1

+PathLink

Description of the type of accessibility on this navigation section.

SituationFullRef

0:*

+SituationFullRef

15.23. The TransferDurationGroup group

+ + + +

TransferDurationGroup

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

TransferDuration

Duration

1:1

xs:duration

Overall duration of this interchange.

WalkDuration

0:1

xs:duration

Walk time as part of the overall interchange duration.

BufferTime

0:1

xs:duration

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

15.24. The complex type PathLinkStructure

PathLinkStructure

[TMv6] a link within a PLACE of or between two PLACEs (that is STOP PLACEs, ACCESS SPACEs or QUAYs,BOARDING POSITIONs,, POINTs OF INTEREST etc or PATH JUNCTIONs) that represents a step in a possible route for pedestrians, cyclists or other out-of-vehicle passengers within or between a PLACE.

The element contains a sequence of the following elements:

Transition

0:1

Transition

Whether path is up down or level .

AccessFeatureType

0:1

AccessFeatureType

Type of physical feature of PATH LINK.

Count

0:1

xs:positiveInteger

Number how often the access feature occurs in this PathLink

AccessibilityFeatures

0:*

AccessibilityFeaturesType

Presence of accessibility features on the PathLink.

15.25. The complex type PathLinkEndStructure

PathLinkEndStructure

Designations of a floor/level.

The element contains a sequence of the following elements:

LevelPublicCode

0:1

xs:normalizedString

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

LevelName

0:1

+InternationalText

Official name of the level.

Id

0:1

xs:normalizedString

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

15.26. The MultiPointTripRequestGroup group

+ + + + + + +

MultiPointTripRequestGroup

Multi-point trip request structure.

MultiPointTripRequest

Origin

1:*

+PlaceContext

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

Destination

1:*

+PlaceContext

Specifies the destination situation where the user is heading to.

Via

0:*

+TripVia

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

NotVia

0:*

+NotVia

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

NoChangeAt

0:*

+NoChangeAt

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

Params

0:1

+MultiPointTripParam

Options to control the search behaviour and response contents.

15.27. The complex type MultiPointTripParamStructure

+ + + + + From 9f44d8e53ba14c8a89e13bbde084b8eebf2915ed Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Matthias=20G=C3=BCnter?= Date: Thu, 27 Oct 2022 15:06:22 +0200 Subject: [PATCH 09/13] adding From and To to PathLinkStructure again --- OJP/OJP_Trips.xsd | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/OJP/OJP_Trips.xsd b/OJP/OJP_Trips.xsd index bb20647b1..dcd63b963 100644 --- a/OJP/OJP_Trips.xsd +++ b/OJP/OJP_Trips.xsd @@ -805,6 +805,16 @@ Presence of accessibility features on the PathLink. + + + Designations of level and place where this PathLink starts. + + + + + Designations of level and place where this PathLink ends. + + From 399f2d2738eb0aa85eb10cf233ad75bc056e0427 Mon Sep 17 00:00:00 2001 From: Travis CI User Date: Thu, 27 Oct 2022 13:07:33 +0000 Subject: [PATCH 10/13] Travis CI update [skip ci] --- docs/generated/OJP.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/generated/OJP.html b/docs/generated/OJP.html index 81f35c5dc..368dd6a1f 100644 --- a/docs/generated/OJP.html +++ b/docs/generated/OJP.html @@ -972,7 +972,7 @@

OJP - Open API for distributed Journey

-

MultiPointTripParamStructure

Multi-point trip request parameter structure.

The element contains a sequence of the following elements:

TripDataFilter

PtModeFilter

0:1

+PtModeFilter

Modes to be considered in trip calculation.

LineFilter

0:1

+LineDirectionFilter

Lines/Directions to include/exclude.

OperatorFilter

0:1

+OperatorFilter

Transport operators to include/exclude.

PrivateModeFilter

0:1

+PrivateModeFilter

Private mobility options to include/exclude.

VehicleFilter

0:1

+VehicleFilter

Filter for VEHICLE and TRAIN NUMBERs.

BaseTripMobilityFilter

NoSingleStep

0:1

xs:boolean

The user is not able to climb one step.

TransferDuration

Duration

1:1

xs:duration

Overall duration of this interchange.

WalkDuration

0:1

xs:duration

Walk time as part of the overall interchange duration.

BufferTime

0:1

xs:duration

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

15.24. The complex type PathLinkStructure

PathLinkStructure

[TMv6] a link within a PLACE of or between two PLACEs (that is STOP PLACEs, ACCESS SPACEs or QUAYs,BOARDING POSITIONs,, POINTs OF INTEREST etc or PATH JUNCTIONs) that represents a step in a possible route for pedestrians, cyclists or other out-of-vehicle passengers within or between a PLACE.

The element contains a sequence of the following elements:

Transition

0:1

Transition

Whether path is up down or level .

AccessFeatureType

0:1

AccessFeatureType

Type of physical feature of PATH LINK.

Count

0:1

xs:positiveInteger

Number how often the access feature occurs in this PathLink

AccessibilityFeatures

0:*

AccessibilityFeaturesType

Presence of accessibility features on the PathLink.

15.25. The complex type PathLinkEndStructure

PathLinkEndStructure

Designations of a floor/level.

The element contains a sequence of the following elements:

LevelPublicCode

0:1

xs:normalizedString

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

LevelName

0:1

+InternationalText

Official name of the level.

Id

0:1

xs:normalizedString

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

15.26. The MultiPointTripRequestGroup group

+

MultiPointTripRequestGroup

Multi-point trip request structure.

15.24. The complex type PathLinkStructure

PathLinkStructure

[TMv6] a link within a PLACE of or between two PLACEs (that is STOP PLACEs, ACCESS SPACEs or QUAYs,BOARDING POSITIONs,, POINTs OF INTEREST etc or PATH JUNCTIONs) that represents a step in a possible route for pedestrians, cyclists or other out-of-vehicle passengers within or between a PLACE.

The element contains a sequence of the following elements:

Transition

0:1

Transition

Whether path is up down or level .

AccessFeatureType

0:1

AccessFeatureType

Type of physical feature of PATH LINK.

Count

0:1

xs:positiveInteger

Number how often the access feature occurs in this PathLink

AccessibilityFeatures

0:*

AccessibilityFeaturesType

Presence of accessibility features on the PathLink.

From

0:1

+PathLinkEnd

Designations of level and place where this PathLink starts.

To

0:1

+PathLinkEnd

Designations of level and place where this PathLink ends.

15.25. The complex type PathLinkEndStructure

PathLinkEndStructure

Designations of a floor/level.

The element contains a sequence of the following elements:

LevelPublicCode

0:1

xs:normalizedString

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

LevelName

0:1

+InternationalText

Official name of the level.

Id

0:1

xs:normalizedString

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

15.26. The MultiPointTripRequestGroup group

From 7cd9948b8cc88964a47d8ef696157f61627ebfa3 Mon Sep 17 00:00:00 2001 From: trurlurl <82838870+trurlurl@users.noreply.github.com> Date: Tue, 8 Nov 2022 12:48:47 +0100 Subject: [PATCH 11/13] Renamed element and type --- OJP/OJP_Trips.xsd | 24 ++++++++++++++++-------- 1 file changed, 16 insertions(+), 8 deletions(-) diff --git a/OJP/OJP_Trips.xsd b/OJP/OJP_Trips.xsd index dcd63b963..2b100ebea 100644 --- a/OJP/OJP_Trips.xsd +++ b/OJP/OJP_Trips.xsd @@ -739,12 +739,14 @@ - + - Allowed values for AccessibilityFeatures. + Allowed values for AccessibilityFeature. - + + For mobility impairments... + @@ -759,7 +761,9 @@ - + + For sensory impairments... + @@ -771,11 +775,15 @@ - + + Assistance... + - + + To pay attention to... + @@ -800,9 +808,9 @@ Number how often the access feature occurs in this PathLink - + - Presence of accessibility features on the PathLink. + Presence of an accessibility feature on the PathLink. From b26fce87e4cca6d4ff6b5ade74e959633ac66538 Mon Sep 17 00:00:00 2001 From: ue71603 Date: Sun, 20 Nov 2022 01:11:08 +0100 Subject: [PATCH 12/13] fixing validity --- OJP/OJP_Trips.xsd | 14 +------------- 1 file changed, 1 insertion(+), 13 deletions(-) diff --git a/OJP/OJP_Trips.xsd b/OJP/OJP_Trips.xsd index 2b100ebea..1be315e9d 100644 --- a/OJP/OJP_Trips.xsd +++ b/OJP/OJP_Trips.xsd @@ -741,12 +741,9 @@ - Allowed values for AccessibilityFeature. + Allowed values for AccessibilityFeature (for mobility and sensory impairments, assistance and important elements to pay attention to). - - For mobility impairments... - @@ -761,9 +758,6 @@ - - For sensory impairments... - @@ -775,15 +769,9 @@ - - Assistance... - - - To pay attention to... - From c86d8c7785f66e7e67ed3f766964a111fd8017ec Mon Sep 17 00:00:00 2001 From: Travis CI User Date: Sun, 20 Nov 2022 00:12:32 +0000 Subject: [PATCH 13/13] Travis CI update [skip ci] --- docs/generated/OJP.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/generated/OJP.html b/docs/generated/OJP.html index 368dd6a1f..b60bcb97a 100644 --- a/docs/generated/OJP.html +++ b/docs/generated/OJP.html @@ -806,7 +806,7 @@

OJP - Open API for distributed Journey

MultiPointTripRequestGroup

Multi-point trip request structure.

MultiPointTripRequest

Origin

1:*

+PlaceContext

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

Destination

1:*

+PlaceContext

Specifies the destination situation where the user is heading to.

Via

0:*

+TripVia

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

→‍siri:ServiceFacilityGroup

JourneyTrack

0:1

+LegTrack

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

Extension

0:1

xs:anyType

-

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

15.1. Simple type definitions

AccessFeatureTypeEnumeration

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

Allowed values for a AccessFeature.

AccessibilityFeaturesTypeEnumeration

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

Allowed values for AccessibilityFeatures.

GuidanceAdviceEnumeration

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

various types of guidance advice given to travelle

MultiPointTypeEnumeration

anyPoint | eachOrigin | eachDestination

How the multiple origin/destination points should be considered

OptimisationMethodEnumeration

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

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

TransitionEnumeration

up | down | level | upAndDown | downAndUp

Transition types for interchanges.

TurnActionEnumeration

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

the range of alternative turns that can be described

15.2. The TripRequestGroup group

+

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

15.1. Simple type definitions

TripRequestGroup

Trip request structure.

AccessFeatureTypeEnumeration

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

Allowed values for a AccessFeature.

AccessibilityFeatureTypesEnumeration

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

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

GuidanceAdviceEnumeration

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

various types of guidance advice given to travelle

MultiPointTypeEnumeration

anyPoint | eachOrigin | eachDestination

How the multiple origin/destination points should be considered

OptimisationMethodEnumeration

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

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

TransitionEnumeration

up | down | level | upAndDown | downAndUp

Transition types for interchanges.

TurnActionEnumeration

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

the range of alternative turns that can be described

15.2. The TripRequestGroup group

@@ -972,7 +972,7 @@

OJP - Open API for distributed Journey

-

TripRequestGroup

Trip request structure.

TripRequest

Origin

1:*

+PlaceContext

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

Destination

1:*

+PlaceContext

Specifies the destination situation where the user is heading to.

Via

0:*

+TripVia

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

TransferDuration

Duration

1:1

xs:duration

Overall duration of this interchange.

WalkDuration

0:1

xs:duration

Walk time as part of the overall interchange duration.

BufferTime

0:1

xs:duration

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

15.24. The complex type PathLinkStructure

PathLinkStructure

[TMv6] a link within a PLACE of or between two PLACEs (that is STOP PLACEs, ACCESS SPACEs or QUAYs,BOARDING POSITIONs,, POINTs OF INTEREST etc or PATH JUNCTIONs) that represents a step in a possible route for pedestrians, cyclists or other out-of-vehicle passengers within or between a PLACE.

The element contains a sequence of the following elements:

Transition

0:1

Transition

Whether path is up down or level .

AccessFeatureType

0:1

AccessFeatureType

Type of physical feature of PATH LINK.

Count

0:1

xs:positiveInteger

Number how often the access feature occurs in this PathLink

AccessibilityFeatures

0:*

AccessibilityFeaturesType

Presence of accessibility features on the PathLink.

From

0:1

+PathLinkEnd

Designations of level and place where this PathLink starts.

To

0:1

+PathLinkEnd

Designations of level and place where this PathLink ends.

15.25. The complex type PathLinkEndStructure

PathLinkEndStructure

Designations of a floor/level.

The element contains a sequence of the following elements:

LevelPublicCode

0:1

xs:normalizedString

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

LevelName

0:1

+InternationalText

Official name of the level.

Id

0:1

xs:normalizedString

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

15.26. The MultiPointTripRequestGroup group

+

MultiPointTripRequestGroup

Multi-point trip request structure.

15.24. The complex type PathLinkStructure

PathLinkStructure

[TMv6] a link within a PLACE of or between two PLACEs (that is STOP PLACEs, ACCESS SPACEs or QUAYs,BOARDING POSITIONs,, POINTs OF INTEREST etc or PATH JUNCTIONs) that represents a step in a possible route for pedestrians, cyclists or other out-of-vehicle passengers within or between a PLACE.

The element contains a sequence of the following elements:

Transition

0:1

Transition

Whether path is up down or level .

AccessFeatureType

0:1

AccessFeatureType

Type of physical feature of PATH LINK.

Count

0:1

xs:positiveInteger

Number how often the access feature occurs in this PathLink

AccessibilityFeature

0:*

AccessibilityFeatureTypes

Presence of an accessibility feature on the PathLink.

From

0:1

+PathLinkEnd

Designations of level and place where this PathLink starts.

To

0:1

+PathLinkEnd

Designations of level and place where this PathLink ends.

15.25. The complex type PathLinkEndStructure

PathLinkEndStructure

Designations of a floor/level.

The element contains a sequence of the following elements:

LevelPublicCode

0:1

xs:normalizedString

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

LevelName

0:1

+InternationalText

Official name of the level.

Id

0:1

xs:normalizedString

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

15.26. The MultiPointTripRequestGroup group

MultiPointTripRequestGroup

Multi-point trip request structure.

MultiPointTripRequest

Origin

1:*

+PlaceContext

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

Destination

1:*

+PlaceContext

Specifies the destination situation where the user is heading to.

Via

0:*

+TripVia

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