diff --git a/OJP/OJP_JourneySupport.xsd b/OJP/OJP_JourneySupport.xsd index 1214aebb..4063bc44 100644 --- a/OJP/OJP_JourneySupport.xsd +++ b/OJP/OJP_JourneySupport.xsd @@ -644,7 +644,7 @@ - The number of trip results that the user wants to see at least (TRIP REQUEST POLICY.maximumNumberofJourneys). Be aware that some implementations will deliver one of the TripResults before the indicated departure time. This means one always must check the results against the parameters before using them. + The number of trip results that the user wants to see at least. Be aware that some implementations will deliver one of the TripResults before the indicated departure time. This means that you can't assume that you get the exact number of results that you asked for in the request from the server. diff --git a/OJP/OJP_Trips.xsd b/OJP/OJP_Trips.xsd index 90c350e1..c5961f3f 100644 --- a/OJP/OJP_Trips.xsd +++ b/OJP/OJP_Trips.xsd @@ -1380,44 +1380,41 @@ Can only be used when both participants recognise the same schedule version. If - + - 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. + Defines how the router should handle requests with multiple origins and destinations. As it is important for the strategy of the distributed trip planning the MultiPointType should be set. If the type is not supported a TRIP_MULTIPOINT_TYPE_NOT_SUPPORTED warning or error must be returned. Default is anyPoint. - How the multiple origin/destination points should be considered. - Note: Unfortunately, this element was not sufficiently defined in the past, which led to different implementations. - Note: MultiPointType trumps the number of results. If the algorithm thinks it is necessary to provide more results, it should. - + Defines how the router should handle requests with multiple origins and destinations. MultiPointType is more important than NumberOfResults in the sense that if 10 results are needed to fulfill the MultiPointType, then it is 10, even when NumberOfResults was set to 1. - If a solution for any one of multiple origin/destination points is sufficient. Some implementations will return only one origin-destination pair even for multiple results with this setting. Others will provide multiple. + Returning results for a single origin and destination (hopefully the best ones). As this element was not sufficiently defined in the past, some implementations may behave differently. - A distinct solution for each of the origin points must be found. + At least a distinct solution for each of the origin points must be delivered. - A distinct solution for each of the destination points must be found. + At least a distinct solution for each of the destination points must be delivered. - At least a result for each Origin-Destination pair must be presented. + At least one result for each origin/destination pair must be delivered. - Clarifies that some (probably the "best") origin-destination pairs should be returned. + Clarifies that some (probably the "best") origin-destination pairs should be returned. How many are to be used is not defined. @@ -1430,7 +1427,7 @@ Can only be used when both participants recognise the same schedule version. If Multi-point trip response structure. - + 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.