Service schedules of public transport operators

For each public transport operator, all its scheduled services can be requested, regardless of the dates on which they are offered. This returns a collection of public transport lines that includes the following data for each line:

• DataOwnerCode - the standard letter code to identify the operator
• OperatorID - (optionally) the numerical value of the operator
• Per line the following data:
  • LinePlanningNumber (identification of the line in the schedule)
  • Public Line Number (as communicated to travelers)
  • Possible directions
  • Possible modalities:
    • Transport type (bus, tram, train, ...)
    • Product formula (Sprinter, Q-liner, Belbus, ...)

 

Scheduled services per line

In a request for a specific service line, the line is identified by a combination of:

• DataOwnerCode of the operator that performs the service.
• LinePlanningNumber

For each line, the following data is returned:

• DataOwnerCode
• OperatorID
• LinePlanningNumber
• Public Line Number
• A description of the line
• Color codes of the line in timetable displays
• Possible directions
• Possible modalities:
  • Transport type (bus, tram, train, ...)
  • Product formula (Sprinter, Q-liner, Belbus, ...)
• The days on which the service is offered
• All possible routes and for each route:
  • The direction
  • The geographical route by road or railway track
  • The sequence of stop places that are passed. For each stop place:
    • Identifications of the stop place
    • Name and place of the stop
    • Accessibility for physically impaired persons
    • The geographical coordinates of the stop (in WGS84 or RDM projections)
• Notices of operators about planned and unplanned changes or disruptions

 

Data for each scheduled service (journey)

One or more services can be specified in a request by a combination of:

• DataOwnerCode of the operator that offers the service
• LinePlanningNumber
• Direction (optional)
• Date on which the service is offered

In general, a number of services are returned for a line on the specified date. The response will include the line data that is described above and for each service:

• JourneyNumber (identification of the trip of the vehicle)
• Direction
• Status (planned, on time, early, delayed, ...)
• Start and end time of the service
• Planned and changed destination
• Accessibility of the vehicle for physically impaired persons
• Notice messages of the operator about the journey or line, e.g. planned suspensions of the service or contact data for service requests
• The route by road or railway track
• The current position of the vehicle (when available)
• The sequence of stops and per stop:
  • Identifications of the stop
  • Name and place of the stop
  • Accessibility of the stop for physically impaired persons
  • The geographical coordinates of the stop (in WGS84 or RDM projections)
  • Notice messages of the operator about the stop (e.g. a temporary relocation of the stop)
  • Planned arrival and departure times
  • Expected arrival and departure time (when deviant for the timetable)
  • Planned destination (this may change at a stop)
  • Changed destination (e.g. when disruptions occur)
  • Occupancy-indications when boarding. This is coded as:
    0 - Unknown
    1 - Empty
    2 - Quiet
    3 - Average
    4 - Crowded
    5 - Full
  • Planned departure platform
  • Changed departure platform
  • Status (planned, delayed, early, canceled, ...)
  • Boarding and alight possibilities

When information of only one service (journey of a vehicle) is needed, this can be requested by supplying one of two additional parameters in the request:

1. The identification of the service (JourneyNmber). This item can be obtained from other APIs, like the Vertrektijden API that includes this item in the set of departure data.
   OR
2. A combination of the identification of a stop place and a departure time. These items can be obtained from other APIs, where the Dienstregeling API can used to collect more detailed information about a selected service, e.g. to display the upcoming stops, the route of the service or its progression.

 

Language and projections

Every request may contain a language preference (Dutch or English). Translatable words will follow this preference. Names of stop places, operators and municipalities are not translated to preserve recognition of names during the journey. The request may also specify the projection of the coordinates that are included in the response. This can be WGS84 (latitude/longitude) or RDM (RijksDriehoekMeting, X/Y).