diff --git a/OJP/OJP_PlaceSupport.xsd b/OJP/OJP_PlaceSupport.xsd index a42640476..5544dbef5 100644 --- a/OJP/OJP_PlaceSupport.xsd +++ b/OJP/OJP_PlaceSupport.xsd @@ -510,6 +510,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/docs/generated/index.html b/docs/generated/index.html index b4353ac37..39cb56ca0 100644 --- a/docs/generated/index.html +++ b/docs/generated/index.html @@ -63,7 +63,7 @@

OJP - Open API for distributed Journey 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
  • +
  • 7. OJP/OJP_Places.xsd - Request and response definitions for place information
  • 8. OJP/OJP_PlaceSupport.xsd - Supporting definitions for place information
  • 9. OJP/OJP_StopEvents.xsd - Request and response definitions for arrivals and departures of public transport services at stops
  • 10. OJP/OJP_TripInfo.xsd - Request and response definitions for information on a single trip
  • @@ -416,7 +416,11 @@

    OJP - Open API for distributed Journey

    NumberOfResults

    0:1

    xs:positiveInteger

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

    ContinueAt

    0:1

    xs:nonNegativeInteger

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

    IncludePtModes

    0:1

    xs:boolean

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

    -

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

    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

    @@ -434,10 +438,14 @@

    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

    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.

    OperatorFilter

    0:1

    +OperatorFilter

    Filter for places that are operated by certain organisations.

    TopographicPlaceRef

    0:*

    +TopographicPlaceRef

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

    PointOfInterestFilter

    0:1

    +PointOfInterestFilter

    Filter to narrow down POI searches.

    7.13. The ExchangePointsRequestGroup group

    +

    ExchangePointsRequestGroup

    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

    7.14. The complex type ExchangePointsParamStructure

    +

    ExchangePointsParamStructure

    The element contains a sequence of the following elements:

    7.15. The complex type ExchangePointsParamStructure

    @@ -449,7 +457,7 @@

    OJP - Open API for distributed Journey

    -

    ExchangePointsParamStructure

    The element contains a sequence of the following elements:

    ExchangePointsDataFilter

    Type

    0:*

    PlaceType

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

    Usage

    0:1

    PlaceUsage

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

    PtModes

    0:1

    +PtModeFilter

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

    ExchangePointsPolicy

    Language

    0:*

    xs:language

    Preferred language in which to return text values.

    NumberOfResults

    0:1

    xs:positiveInteger

    ContinueAt

    0:1

    xs:nonNegativeInteger

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

    7.15. The ExchangePointsDataFilterGroup group

    +

    ExchangePointsDataFilterGroup

    7.16. The ExchangePointsDataFilterGroup group

    @@ -457,16 +465,16 @@

    OJP - Open API for distributed Journey

    -

    ExchangePointsDataFilterGroup

    ExchangePointsDataFilter

    Type

    0:*

    PlaceType

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

    Usage

    0:1

    PlaceUsage

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

    PtModes

    0:1

    +PtModeFilter

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

    TopographicPlaceRef

    0:*

    +TopographicPlaceRef

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

    DestinationSystem

    0:1

    siri:ParticipantRefStructure

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

    AdjacentSystem

    0:*

    siri:ParticipantRefStructure

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

    7.16. The ExchangePointsPolicyGroup group

    +

    ExchangePointsPolicyGroup

    7.17. The ExchangePointsPolicyGroup group

    -

    ExchangePointsPolicyGroup

    ExchangePointsPolicy

    Language

    0:*

    xs:language

    Preferred language in which to return text values.

    NumberOfResults

    0:1

    xs:positiveInteger

    ContinueAt

    0:1

    xs:nonNegativeInteger

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

    7.17. The ExchangePointsResponseGroup group

    +

    ExchangePointsResponseGroup

    7.18. The ExchangePointsResponseGroup group

    -

    ExchangePointsResponseGroup

    ExchangePointsResponse

    ExchangePointResponseContext

    0:1

    +ResponseContext

    Context to hold trip response objects that occur frequently.

    ContinueAt

    0:1

    xs:nonNegativeInteger

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

    Place

    0:*

    +ExchangePointsResult

    7.18. The complex type ExchangePointsResultStructure

    ExchangePointsResultStructure

    The element contains a sequence of the following elements:

    Problem

    0:*

    +ExchangePointProblem

    Problems related to this EXCHANGE POINTS result.

    Place

    1:1

    +Place

    Place object that describes this exchange point.

    TravelDurationEstimate

    0:1

    xs:duration

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

    WaitDuration

    0:1

    xs:duration

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

    BorderPoint

    0:1

    xs:boolean

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

    Mode

    0:*

    +Mode

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

    -

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

    8.1. Simple type definitions

    AddressCodeType

    xs:normalizedString

    Identifier of an Address

    ExchangePointsProblemTypeEnumeration

    EXCHANGEPOINTS_NORESULTS | EXCHANGEPOINTS_UNKNOWNDESTINATIONSYSTEM | EXCHANGEPOINTS_UNKNOWNADJACENTSYSTEM | EXCHANGEPOINTS_OTHER

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

    LocationProblemTypeEnumeration

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

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

    PointOfInterestCodeType

    xs:normalizedString

    Identifier of a Point of Interest

    StopPlaceCodeType

    xs:normalizedString

    Identifier of a Stop Place

    TopographicPlaceCodeType

    xs:normalizedString

    Identifier of a TopographicPlace

    8.2. The StopPointGroup group

    +

    StopPointGroup

    A stop point with id and name

    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.

    +

    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

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