Movia Infotainment REST Service
Version 3
This document describes Version 3 of the Movia Infotainment REST Service. The service is available through the following endpoint:
https://wsilb.moviatrafik.dk/infotainment/v3
Formal specification and live demonstration
Formal specification is available in:
Live demonstration is available in:
Methods
/vehicle/{vehicleNumber}/{screenConfiguration}
This returns current infotainment data for the vehicle, given by its four-digit vehicleNumber and screenConfiguration used in the vehicle (1 for single screen, 2 for dual screens). The returned displayMode states what kind of display template should be used by the infotainment system (see [1]).
Optional arguments:
- includeNextStops = n : Includes arrivals for the next n stops (n > 0) instead of just the next stop.
Example response
Some elements have been shortned with ....
{
"time": "2016-12-14T14:10:05.8715564+01:00",
"displayMode": 2,
"journeyId": 1310508875453023,
"journeyRef": "20161214L0034J0109",
"lineTypeCode": "ALM",
"lineDesignation": "34",
"primaryDestination": "Vestamager",
"secondaryDestination": "Nøragersmindevej",
"zoneNumber": 2,
"messages": [],
"currentStop": null,
"nextStops": [
{
"stopPointNumber": 28652,
"stopPointName": "Flintholm St.",
"timetabledArrivalDateTime": "2016-12-14T14:13:00",
"expectedArrivalDateTime": "2016-12-14T14:13:00",
"connections": [
{
"transportModeCode": "BUS",
"lineTypeCode": "ALM",
"lineDesignation": "10",
"lineDestination": "Københavns Rådhusplads",
"expectedDepartureDateTime": "2016-12-14T14:17:20",
"isCanceled": false
},
{
"transportModeCode": "BUS",
"lineTypeCode": "ABUS",
"lineDesignation": "9A",
"lineDestination": "Operaen, Holmen",
"expectedDepartureDateTime": "2016-12-14T14:19:42",
"isCanceled": false
},
...
{
"transportModeCode": "S-TOG",
"lineDesignation": "F",
"lineDestination": "Hellerup St.",
"track": "11",
"expectedDepartureDateTime": "2016-12-14T14:14:00",
"isCanceled": false
},
{
"transportModeCode": "METRO",
"lineDesignation": "M2",
"lineDestination": "Lufthavnen",
"plannedTrack": "1",
"track": "1",
"expectedDepartureDateTime": "2016-12-14T14:14:00",
"isCanceled": false
},
{
"transportModeCode": "METRO",
"lineDesignation": "M2",
"lineDestination": "Vanløse",
"plannedTrack": "2",
"track": "2",
"expectedDepartureDateTime": "2016-12-14T14:15:00",
"isCanceled": false
},
{
"transportModeCode": "S-TOG",
"lineDesignation": "H",
"lineDestination": "Frederikssund St.",
"track": "2",
"expectedDepartureDateTime": "2016-12-14T14:16:00",
"isCanceled": true
},
...
],
"zoneNumber": 2
},
{
"stopPointNumber": 1137,
"stopPointName": "Grøndalsvej",
"timetabledArrivalDateTime": "2016-12-14T14:15:00",
"expectedArrivalDateTime": "2016-12-14T14:15:00",
"zoneNumber": 2
},
{
"stopPointNumber": 1138,
"stopPointName": "Tesdorpfsvej",
"timetabledArrivalDateTime": "2016-12-14T14:16:00",
"expectedArrivalDateTime": "2016-12-14T14:16:00",
"zoneNumber": 2
},
{
"stopPointNumber": 48332,
"stopPointName": "Dalgas Have",
"timetabledArrivalDateTime": "2016-12-14T14:16:00",
"expectedArrivalDateTime": "2016-12-14T14:16:00",
"connections": [
{
"transportModeCode": "METRO"
}
],
"zoneNumber": 2
},
{
"stopPointNumber": 1643,
"stopPointName": "Dalgas Boulevard",
"timetabledArrivalDateTime": "2016-12-14T14:18:00",
"expectedArrivalDateTime": "2016-12-14T14:18:00",
"connections": [
{
"transportModeCode": "BUS",
"lineTypeCode": "ALM",
"lineDesignation": "31"
}
],
"zoneNumber": 2
},
{
"stopPointNumber": 1644,
"stopPointName": "Eversvej",
"timetabledArrivalDateTime": "2016-12-14T14:19:00",
"expectedArrivalDateTime": "2016-12-14T14:19:00",
"connections": [
{
"transportModeCode": "BUS",
"lineTypeCode": "ALM",
"lineDesignation": "31"
}
],
"zoneNumber": 2
}
],
"discreteJourneyProgress": 6,
"finalStop": {
"stopPointNumber": 29615,
"stopPointName": "Nøragersmindevej",
"timetabledArrivalDateTime": "2016-12-14T15:18:00",
"expectedArrivalDateTime": "2016-12-14T15:18:00",
"zoneNumber": 4
}
}Messages and Voice Announcements
Each infotainment response also include possible set of messages and voice announcements for use in passenger information, e.g. service deviations, emergency messages etc. The attribute messages has the structure illustrated below:
{
...
"messages": [
{
"deviationMessageRef": "6010000140191088",
"deviationRef": "6010000139159059",
"publishFromDateTime": "2016-10-05T16:03:31.147+02:00",
"publishUptoDateTime": "2016-10-20T10:30:00+02:00",
"repeatIntervalMinutes": 3,
"headerText": "En test af tale 3",
"summeryText": null,
"audioUri": "http://voice.moviatrafik.dk/OCS_VOICE_MESSAGES/49d41c5c-9b08-4a53-8e00-b2ae59d833d7.mp3"
}
],
...
}The deviationRef dos not change for the same deviation, however the deviationMessageRef might change if a message content (text or voice) is updated. Only messages that are valid in respect to publishFromDateTime and publishUptoDateTime are included in the response. This validity attributes are thus only included for cache purposes etc.
The attribute repeatIntervalMinutes indicates the repeat interval (in minutes). A value of 0 means the message should only be annouced once each journey. Each message include a headerText and an optional summeryText and audioUrl, the latter refers to a mp3 file with the voice content. If the voice message is updated a new deviationMessageRef and audioUri will be genarated.
/journey
This returns current journey progress data for the vehicle, given by its four-digit vehicleNumber.
Example response
Some elements have been shortned with ....
{
"time": "2017-01-11T12:02:03.0056552+01:00",
"journey": {
"ref": "20170111L0201J0026",
"id": 1310508917293822,
"lineTypeCode": "ABUS",
"lineDesignation": "201A"
},
"discreteJourneyProgress": 5,
"stops": [
{
"stopPoint": {
"ref": "9025200000009931",
"id": 9931,
"name": "Svogerslev, Søbredden",
"zoneNumber": 8,
"isHub": false
},
"isCanceled": false
},
{
"stopPoint": {
"ref": "9025200000009932",
"id": 9932,
"name": "Søtoften",
"zoneNumber": 8,
"isHub": false
},
"isCanceled": false
},
...
{
"stopPoint": {
"ref": "9025200000007677",
"id": 7677,
"name": "Låddenhøj",
"zoneNumber": 8,
"isHub": false
},
"isCanceled": false
},
{
"stopPoint": {
"ref": "9025200000004286",
"id": 4286,
"name": "Katedralskolen",
"zoneNumber": 8,
"isHub": false
},
"isCanceled": false,
"connections": [
{
"transportModeCode": "BUS",
"lineTypeCode": "RNET",
"lineDesignation": "230R"
}
]
},
...
{
"stopPoint": {
"ref": "9025200000004359",
"id": 4359,
"name": "Trekroner St.",
"zoneNumber": 8,
"isHub": false
},
"isCanceled": false,
"connections": [
{
"transportModeCode": "BUS",
"lineTypeCode": "ALM",
"lineDesignation": "209"
},
{
"transportModeCode": "BUS",
"lineTypeCode": "ALM",
"lineDesignation": "220"
},
{
"transportModeCode": "TOG"
}
]
}
]
}References
[1]: Marketing og Trafikinformation, Drift, Operatører og Kunder, Timing Report, Trafikselskabet Movia (PDF)