From 0cf758a8d9730887349b978b29f75270d10b84ad Mon Sep 17 00:00:00 2001 From: ue71603 Date: Thu, 19 Jan 2023 17:48:05 +0100 Subject: [PATCH] Squashed commit of the following: MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit commit cf663d0d9affded1d9bcf403972be0e26efc91df Author: Matthias Günter Date: Thu Jan 19 17:10:00 2023 +0100 Necessary low level elements for User Preferences (#271) * Necessary low level elements for User Preferences No UserPreference for the time being. New optimisation methods, walking and cycling profile and includeAlternativeOptions all for Trips commit 079b6c746d009ed3e446f7473f09cd41e1ceef5d Author: Malte Herlitze Date: Thu Jan 19 17:05:39 2023 +0100 added PlaceSortingGroup to PlaceParamStructure (#281) * added PlaceSortingGroup to PlaceParamStructure * Update OJP/OJP_Places.xsd * problem message for unsupported sorting method Co-authored-by: Matthias Günter Co-authored-by: github-actions <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Stephan Großberndt Co-authored-by: Stefan de Konink Co-authored-by: Malte Herlitze --- OJP/OJP_PlaceSupport.xsd | 5 ++ OJP/OJP_Places.xsd | 20 ++++++++ OJP/OJP_Trips.xsd | 100 +++++++++++++++++++++++++++++++++++++-- 3 files changed, 120 insertions(+), 5 deletions(-) diff --git a/OJP/OJP_PlaceSupport.xsd b/OJP/OJP_PlaceSupport.xsd index 409ed3b7d..52dff4f68 100644 --- a/OJP/OJP_PlaceSupport.xsd +++ b/OJP/OJP_PlaceSupport.xsd @@ -515,6 +515,11 @@ The service does not support any restrictions by localities. + + + The service does not support the sorting method. The details should provide a list of the allowed methods the service supports. + + A problem has occurred that does not have a specific problem type. diff --git a/OJP/OJP_Places.xsd b/OJP/OJP_Places.xsd index 4d4c8e364..7c176999c 100644 --- a/OJP/OJP_Places.xsd +++ b/OJP/OJP_Places.xsd @@ -79,6 +79,7 @@ + @@ -206,6 +207,25 @@ + + + + + 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. + + + + + WGS84 coordinates position. Locations closer to this GeoPosition are preferred. + + + + + Ignore locations with a lower probability. + + + + diff --git a/OJP/OJP_Trips.xsd b/OJP/OJP_Trips.xsd index 88dc7aa33..ec254b7e1 100644 --- a/OJP/OJP_Trips.xsd +++ b/OJP/OJP_Trips.xsd @@ -106,11 +106,14 @@ The maximum number of interchanges the user will accept per trip. - - - the types of algorithm that can be used for planning a journey (fastest, least walking, etc) - - + + + + + the types of algorithm that can be used for planning a journey (fastest, least walking, etc) + + + For each mode in this list a separate monomodal trip shall be found - in addition to inter-modal solutions. @@ -162,6 +165,11 @@ Whether the result should include intermediate stops (between the passenger's board and alight stops). + + + Whether altnerative options should be presented as well. Mainly important for dominated journeys or in the case of ContinuousLegs the second best route. Should be optimised for the user expectance (see. e.g https://tel.archives-ouvertes.fr/tel-01848737). However, what the alternative options are may vary widely depending on the optimisation methods and filters. + + Whether the result should include fare information. @@ -172,6 +180,54 @@ Whether the result should include operating day information - as encoded bit string and in natural language. + + + Users hiking profile. The main element to control general walking behaviour is WalkSpeed (together with accessibility constraints). Note: possible explanations in German can be found here: https://akademie.alpinewelten.com/bergwandern/klassifizierung-von-wanderwegen#:~:text=Die%20Kategorie%20Blau,Sturzes%20drastische%20Konsequenzen%20haben%20w%C3%BCrden + + + + + + Regular hiking/walking in valleys and plains and easy mountain trails e.g. yellow hiking signs in Switzerland or blue in Germany + + + + + Medium difficulty mountain trails. E.g. white-red-white hiking signs in Switzerland or red in Germany. + + + + + Difficult mountain trails. E.g. white-blue-white hiking signs in Switzerland or black in Germany. + + + + + + + + Users cycling profile (especially for sportive activities). + + + + + + fastest cycle route + + + + + greenest cycle route + + + + + family friendly and leisurely route + + + + + If true, then the response will contain only summaries of the found trips. Default is false. @@ -179,6 +235,14 @@ + + + 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 truely used to score the results. + + + + + 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. @@ -196,6 +260,32 @@ + + + If set, favour "green" modes/lines such as bike sharing and (electric) trains, avoid or restrict modes/lines known for higher CO2 emissions such as (conventional) taxi, ridehailing or coach. + + + + + High level of safety (refering to crime, hazards or prone to accidents). If used, certain modes, lines or zones/districts known for lower safety, i.e. higher risk of accidents and crime, may be avoided, others may be preferred. This may depend on the actual, local or time of day situation. E.g. bike or scooter may be considered unsafe in some cities/districts while safe in others. + + + + + Low probability of delays, cancellations etc. If used, modes known for their (un)reliability may be avoided/preferred, and extra time added for transfers. This may depend on the actual, local or time of day situation, +based on punctuality statics, traffic jam statistics or rush hours. E.g. taxis in a given city might be known to be unreliable during at 8-10 and 16-19 hours, otherwise reliable. + + + + + Scenic (or touristic) travel. Different by modes or by the surrounding. + + + + + E.g. first class or quiet compartments preferred. Journeys that are with low occupancy. + +