Jhon Toledo (Ontology Engienering Group - Universidad Politécnica de Madrid)
Miguel Angel García (Ontology Engienering Group - Universidad Politécnica de Madrid
Oscar Corcho (Ontology Engineering Group - Universidad Politécnica de Madrid)
Module of the OSDM Ontology focused on Online API. This ontology provides support to the OSDM model. Visit https://github.com/oeg-upm/mobility/ and https://w3id.org/mobility/osdm/core/0.1
Creative Commons Attribution 4.0 International (CC BY 4.0)
OSDM - Distribution Model
Module of the OSDM Ontology focused on online API. This ontology provides support to the OSDM model. https://github.com/oeg-upm/mobility/tree/main/OSDM and https://w3id.org/mobility/osdm/core/0.1
This is the initial version of the module on OSDM online API(V1.2), after considering the specification and examples of OSDM.
Relaciona un recurso, como por ejemplo un concepto, con un esquema de conceptos o taxonomía en el que se incluye.
Relates a resource (for example a concept) to a concept scheme in which it is included.
This property sets the relationship between Offer and admission
admissions
This property sets the relationship between Offer and ancillarie
ancillaries
This property sets the relationship Booking and Offer.
bookedOffers
The codes that can be used to represent the given station on the system.
codes
This property describes the relation of the sales or after-sales conditions.
conditions
This property sets the relationship Booking and Price.
confirmedPrice
A location where the vehicle arrives. This property sets the relationship between Trip and Stop.
destination
Information needed at booking step.
details
Indicates the trip direction
direction
exchangeOperations
This property sets the relationship between Offer and fare
fares
This property sets the relationship Condition and Price.
feePrice
This property sets the relationship between Offer and fee
fees
fulfillmentType
This property sets the relationship Booking and Fulfillment.
fulfillments
gender
This property sets the relationship between Passenger and IdentidicationDocument.
identificationDocument
This property sets the relationship Stop and Location .
location
This property sets the relationship Fulfillment and OfferParts.
offerParts
This property sets the relationship between Offer and OfferSummary.
offerSummary
This property sets the relationship between TripOffer and Offer.
offers
location where the vehicle departs. This property sets the relationship between Trip and Stop.
origin
This property sets the relationship between TripOffer and Passenger.
passengers
Represent costs for services or products.
price
provisionalPrice
A trip that is realized with the same transport
realizedBy
refundOffers
This property sets the relationship between Offer and reservation
reservations
A list of segments. A segment represents a property that sets the relationship between Trip and Segment.
segments
This property sets the relationship Segment and Stop.
stops
transportMode
This property sets the relationship between Offer and Trip
trip
Email address.
email
phoneNumber
telephone
The first name of a person.
firstName
The last name of a person.
lastName
This property sets the accommodation. example: seat, couchette
accommodation
Accommodation details. Example: SEAT, COUCHETTE, BERTH or VEHICLE
accommodationDetails
Accuracy of the provided coordinates to be used when comparing coordinates
accuracy
Property that the after sales can be treated independently per person.
afterSalesCondition
Amount in cents.
amount
This property shows the list of all throughticket tags that were effectively used in building or booking the offer
appliedThroughTicketTags
Date and time in the time zone of the station
arrivalDateTime
The info about the arrival-track of the stop. Format depends on operator.
arrivalTrack
carrierConstraintText
City
city
cityOfBirth
Place where the document is issued
cityOfIssue
cityOfResidence
The product code expressed in the provider system (could be a mapping from an even lower-level provider).
code
This property is mostly used to harmonize choice and representation across multiple carriers."FIRST", "SECOND"
comfortClass
Base64 encoded binary of the actual fulfillment document.
content
Ticket Control Number.
controlNumber
property according to ISO 3166 2A codes
contryOfResidence
This property use ISO 3166 2A codes to define the country
country
Property according to ISO 3166 2A codes
countryOfBirth
countryOfIssue
This property indicates which segments are covered by the specific offer
coveredSegmentIndexes
Currency (local currency might be required additionally due to local legislation for two carriers in one country). ISO 4217 currency codes
currency
date of birth of the passenger
dateOfBirth
date of issue
dateOfIssue
departureDateTime
The info about the departure-track of the stop. Format depends on operator.
departureTrack
Expiration time of the download link, the document will not be available at the given URI after this time.
downloadExpiry
Total duration over all segment's (format see https://www.w3.org/TR/xmlschema11-2/#duration)
duration of the segment in ISO 8601 Durations
duration
Physical format of the document provided in the content field in Mime-Type format, e.g. application/pdf, image/jpeg, etc. Must be filled if the "content" field is present.
format
example : "BOOKING_RECEIPT", "TICKET", "BOARDING_PASS", "INFORMATION", "VOUCHER"
fulfillmentDocumentType
sequence number of the segment in the ordering of all segments of the trip
index
Indicates whether the fee belongs to the allocator
isAllocatorFee
Whether admission required reservation
isReservationRequired
isReturnProduct
Indicates whether the offerId can be used in more than one booking.
isReusable
isTrainBound
Geographic coordinate that specifies the north-south position of a point on the earths surface.
latitude
limitOfValidity
Line number in case the vehicle does not have a number
lineNumber
Code unique with in the country only
localCode
Geographic coordinate that specifies the east-west position of a point on the earths surface.
longitude
property from Fulfillment types. RCT2, RCCST and UIC-PDF are official UIC standards.
medium
ICAO transliteration identical as written in the document
name
Property according ISO 3166 2A codes
nationality
postal code
postalCode
The product code expressed in the provider system
productCode
The booking reference of the booking
provider booking reference
The unique booking reference in the provider system. Usually refers to an order number or PNR.
reference
This property describes the Boolean expression indicating the data that must be set in the data model in order to proceed to the next step of the process.
requestedInformation
Identifying sets of compatible offers when booking a return trip involving return-specific fares. All returnTags must be present in the counterpart offer to allow combination If no tag is provided, there is no return constraint on this specific offer.
returnTags
Scale of the amount - the number of positions after the comma.
scale
Service brands identify a type of train. In future version it will be represented with SKOS.
serviceBrand
Class of service.This property sets the quality level, finer grained than the comfort class. "BEST", "HIGH", "STANDARD", "BASIC"
serviceClass
serviceConstraintText
Booking status. Example. PREBOOKED, CONFIRMED, FULFILLED, CANCELLED, REFUNDED, EXCHANGE_ONGOING, ERROR
status
The street name and house number (if applicable)
street
Geo coordinate system indication. default: WGS84 standard system
system
ticket-time limit
ticketTimeLimit
This property sets the client reference that could be received in a search with trips in input.
tripKey
This property describes sets of compatible offers when trying to combine multiple offers covering one single trip. At least one (not all) tripTags must be in common to allow combination If no tag is provided, there is no trip constraint on this specific offer.
tripTags
Defines the minimum validity period of the trip booked, meaning the period during which it will be possible to travel.
validFrom
Defines the validity period of the trip booked, meaning the period during which it will be possible to travel
validUntil
Vehicle number
vehicleNumber
Concept
An abstract idea or notion; a unit of thought.
A concept scheme may be defined to include concepts from different sources.
Thesauri, classification schemes, subject heading lists, taxonomies, 'folksonomies', and other types of controlled vocabulary are all examples of concept schemes. Concept schemes are also embedded in glossaries and terminologies.
Concept Scheme
A set of concepts, optionally including statements about semantic relationships between those concepts.
Used to encode an address using the standard street address attributes.
Address
Admission offer parts represent a travel right, or the entitlement to travel onboard a train between the given origin and destination, following the given route.It does not include a seat reservation.
Represent a travel right, or the entitlement to travel onboard a train between the given origin and destination, following the given route, without a seat reservation
Admission
An extra service like meal or WIFI
Ancillaries are used to represent non-transport products associated with the transportation request submitted. It could be onboard services such as a WIFI connection or a meal, or services associated with one of the stops, or origin/destination, like a parking spot or lounge access.
Ancillarie
The booking represents the local booking for the offers that have been selected. It contains a set of sub-resources, most of which were encountered in the offer stage.
Booking
Describes sales and after sales conditions applicable to the product. For a product to be refundable or exchangeable, at least one refund or exchange (respectively) condition must be present.
Condition
Connection point connecting two fare regimes. Providing the UIC code for the station is mandatory.
ConnectionPoint
An exchange operations represent an ongoing exchange.
ExchangeOperations
TODO: check if it's the same with fare of Transmodel
Fees are used to represent additional costs for services or products. Offer parts of type “fee” can be applied to the booking process (e.g. a service fee), the trip (e.g. a reservation fee which is applied to all reservations in trains running in the same direction, namely outward or inward travel) or other offer parts.
Fee
fulfillment representing an offer part
Fulfillment
Class for document fulfillment.
FulfillmentDocument
Used to provide any geo-encoded location, regardless of environment, using longitude and latitude coordinates.
GeoCoordinate
Travel document data to be exchanged for border control.
IdentidicationDocument
Representing a specific location in a trip: departure, origin, intermediate stop or other. A location uniquely identifies a place in space. A location can be of type station, point-of-interest, address or geo-coordinate.
Location
Representing bookable elements that covers exactly one a specific trip
Offer
Representing bookable elements that covers exactly one a specific trip (or the requested section of a trip in case of allocator request to an nTM Provider)
OfferParts
The offer summary indicates the major service class, level or flexibility.
OfferSummary
POI (for point of Interest) represents a location that is not a train station but still relevant to the description of the trip. It could be a public transport stop, an exhibition, an event hall, a shopping mall etc.
POI
A passenger is the person travailing on a vehicle.
Passenger
Passenger details providing personal information only information required in the booking.
Passenger Details
Product
Refund offers represent a provisional refund request that is made on all or a subset of the fulfillments contained in a booking.
RefundOffers
Reservation includes the reference to the in the initial offer. The offer needs to be updated with the selected places before the confirmation which creates the reservation details including the reserved places.
Reservation offer parts represent a seat (or other accommodation) reservation on the transportation. In contrast with admissions, a reservation is in essence bound to a specific train, although it normally does not include the entitlement to board the train. Travellers therefore typically need an a associated admission offer part or other entitlement (such as a pass) in order to actually travel.
Reservation
A segment represents a subsection of a trip that is realized with the same transport vehicle. A segment has an origin, a destination and duration.
Segment
Details of a station. In some countries stations have multiple names depending on the countries local languages.
StationDetail
Represents a location or station. Either a departure, arrival or intermediate stop along a segment of a trip.
Stop
Trips represent the concrete realization of a trip going from departure station to destination station. A trip is composed of one or more segments.
Trip
Grouping all the offers relating to one same trip. Indeed, in most cases the Allocator provider will propose several offers of different comfort and flexibility levels.
TripOffer
A vehicle is defined by a number or line and a service brand.
Vehicle
This code list provides the gender.
sex
direction type
Type of fulfillment of a Offer : ETICKET, CIT_PAPER, PASS_CHIP or PASS_REFERENCE.
fulfillment type
Locations are resources representing a specific location in a trip: departure, origin, intermediate stop or other. They can be of different types: -Station - Address -POI -GeoCoordinate -ConnectionPoint
location type
Station Codes
transport-mode-type
An unambiguous reference to the resource within a given context.
identifier
downloadLink