nrewebservices.ldbws

Session

class nrewebservices.ldbws.Session(wsdl=None, api_key=None, timeout=5)[source]

This class provides the interface to the LDBWS web service session.

Note

There are some (unknown) internal rules on the LDBWS server which limit the number of services returned in a response, sometimes to less than the number requested by the time_window and/or rows parameters to a request. Unfortunately there is nothing that can be done about this, so you just have to work with it.

__init__(wsdl=None, api_key=None, timeout=5)[source]

You should normally instantiate this class only once per application, as it fetches and parses the WSDL from the server on instantiation, normally taking a few seconds to complete.

Parameters:
  • wsdl (str) – the URL of the web service WSDL. Be sure to pass the ?ver=2016-02-16 on the end of the URL to get the version this library currently supports. If this parameter is not provided, the code expects to find an environment variable called NRE_LDBWS_WSDL containing it instead.
  • api_key (str) – your LDBWS API key. If this is not provided, the code expects to find an environment variable called NRE_LDBWS_API_KEY containing it instead.
  • timeout (int) – the number of seconds the after which the underlying SOAP client should timeout unfinished requests.
Raises:
  • ValueError – if neither of the wsdl parameter or the NRE_LDBWS_WSDL environment variable are provided.
  • ValueError – if neither of the api_key parameter or the NRE_LDBWS_API_KEY environment variable are provided.
get_fastest_departures(crs, destinations, time_offset=None, time_window=None)[source]

Get the fastest public departures (within the supplied time window and offset) from the station indicated by crs to the stations indicated by destinations. The difference between this method and get_next_departures is that for each destination, the train which arrives first at the destination out of the next departures from this station is returned, rather than the one which departs from this station first.

Parameters:
  • crs (str) – the CRS code of the station for which this board is being fetched.
  • destinations ([str]) – a list of CRS codes representing the stations for which the next departure from crs will be fetched. This parameter must contain at least 1, but no more than 25 station CRS codes.
  • time_offset (int, from -120 to 120) – An offset in minutes against the current time which determines the starting point of the time window for which services are returned. If set to None, the value of 0 will be used.
  • time_window (int, from -120 to 120) – How far into the future from the value passed as time_offset should services be fetched. If the value passed is negative, the time window starts before the value of time_offset and ends at time_offset. If None is passed, the default value is 120.
Returns:

a NextDeparturesBoard object containing the station details and the fastest departures to each of the requested destinations.

Return type:

NextDeparturesBoard

Raises:

ValueError – if destinations is not a list of between 1 and 25 values.

Note

Each time this his method is called, it makes 1 request to the LDBWS server.

get_fastest_departures_with_details(crs, destinations, time_offset=None, time_window=None)[source]

Get the fastest public departures (within the supplied time window and offset) from the station indicated by crs to the stations indicated by destinations. The difference between this method and get_next_departures_with_details is that for each destination, the train which arrives first at the destination out of the next departures from this station is returned, rather than the one which departs from this station first.

This method is identical in arguments and result to get_fastest_departures, except that the returned result is of type NextDeparturesBoardWithDetails, which includes the calling points on the services, allowing access to them without an additional call to get_service_details for each service.

Parameters:
  • crs (str) – the CRS code of the station for which this board is being fetched.
  • destinations ([str]) – a list of CRS codes representing the stations for which the next departure from crs will be fetched. This parameter must contain at least 1, but no more than 25 station CRS codes.
  • time_offset (int, from -120 to 120) – An offset in minutes against the current time which determines the starting point of the time window for which services are returned. If set to None, the value of 0 will be used.
  • time_window (int, from -120 to 120) – How far into the future from the value passed as time_offset should services be fetched. If the value passed is negative, the time window starts before the value of time_offset and ends at time_offset. If None is passed, the default value is 120.
Returns:

a NextDeparturesBoardWithDetails object containing the station details and the fastest departures to each of the requested destinations.

Return type:

NextDeparturesBoardWithDetails

Raises:

ValueError – if destinations is not a list of between 1 and 25 values.

Note

Each time this his method is called, it makes 1 request to the LDBWS server.

get_next_departures(crs, destinations, time_offset=None, time_window=None)[source]

Get the next public departures (within the supplied time window and offset) from the station indicated by crs to the stations indicated by destinations.

Parameters:
  • crs (str) – the CRS code of the station for which this board is being fetched.
  • destinations ([str]) – a list of CRS codes representing the stations for which the next departure from crs will be fetched. This parameter must contain at least 1, but no more than 25 station CRS codes.
  • time_offset (int, from -120 to 120) – An offset in minutes against the current time which determines the starting point of the time window for which services are returned. If set to None, the value of 0 will be used.
  • time_window (int, from -120 to 120) – How far into the future from the value passed as time_offset should services be fetched. If the value passed is negative, the time window starts before the value of time_offset and ends at time_offset. If None is passed, the default value is 120.
Returns:

a NextDeparturesBoard object containing the station details and the next departures to each of the requested destinations.

Return type:

NextDeparturesBoard

Raises:

ValueError – if destinations is not a list of between 1 and 25 values.

Note

Each time this his method is called, it makes 1 request to the LDBWS server.

get_next_departures_with_details(crs, destinations, time_offset=None, time_window=None)[source]

Get the next public departures (within the supplied time window and offset) from the station indicated by crs to the stations indicated by destinations.

This method is identical in arguments and result to get_next_departures, except that the returned result is of type NextDeparturesBoardWithDetails, which includes the calling points on the services, allowing access to them without an additional call to get_service_details for each service.

Parameters:
  • crs (str) – the CRS code of the station for which this board is being fetched.
  • destinations ([str]) – a list of CRS codes representing the stations for which the next departure from crs will be fetched. This parameter must contain at least 1, but no more than 25 station CRS codes.
  • time_offset (int, from -120 to 120) – An offset in minutes against the current time which determines the starting point of the time window for which services are returned. If set to None, the value of 0 will be used.
  • time_window (int, from -120 to 120) – How far into the future from the value passed as time_offset should services be fetched. If the value passed is negative, the time window starts before the value of time_offset and ends at time_offset. If None is passed, the default value is 120.
Returns:

a NextDeparturesBoardWithDetails object containing the station details and the next departures to each of the requested destinations.

Return type:

NextDeparturesBoardWithDetails

Raises:

ValueError – if destinations is not a list of between 1 and 25 values.

Note

Each time this his method is called, it makes 1 request to the LDBWS server.

get_service_details(service_id)[source]

Get the full details of a service from a board.

Parameters:service_id (str) – the service_id of the relevant ServiceItem on the board.
Returns:a ServiceDetails object containing the details of the requested service.
Return type:ServiceDetails

Note

Each time this his method is called, it makes 1 request to the LDBWS server.

get_station_board(crs, rows=10, include_departures=True, include_arrivals=False, from_filter_crs=None, to_filter_crs=None, time_offset=None, time_window=None)[source]

Get a list of public services at a station as would populate a departure/arrival board.

Parameters:
  • crs (str) – the CRS code of the station for which this board is being fetched.
  • rows (int, from 1 to 150) – the maximum number of services to include in the returned board.
  • include_departures (boolean) – whether the returned services should include departures from this station. At least one of include_departures or include_arrivals must be set to true.
  • include_arrivals (boolean) – whether the returned services should include arrivals at this station. At least one of include_departures or include_arrivals must be set to true.
  • from_filter_crs (str) – the CRS code of a station at which all services returned must have called previously. Only one of from_filter_crs and to_filter_crs can be set for a given request.
  • to_filter_crs (str) – the CRS code of a station at which all services returned must subsequently call. Only one of from_filter_crs and to_filter_crs can be set for a given request.
  • time_offset (int, from -120 to 120) – An offset in minutes against the current time which determines the starting point of the time window for which services are returned. If set to None, the value of 0 will be used.
  • time_window (int, from -120 to 120) – How far into the future from the value passed as time_offset should services be fetched. If the value passed is negative, the time window starts before the value of time_offset and ends at time_offset. If None is passed, the default value is 120.
Returns:

a StationBoard object containing the station details and the requested services.

Return type:

StationBoard

Raises:

ValueError – if neither include_departures or include_arrivals are set to True.

Note

Each time this his method is called, it makes 1 request to the LDBWS server.

get_station_board_with_details(crs, rows=10, include_departures=True, include_arrivals=False, from_filter_crs=None, to_filter_crs=None, time_offset=None, time_window=None)[source]

Get a list of public services at a station as would populate a departure/arrival board. This method is identical in arguments and result to get_station_board, except that the returned result is of type StationBoardWithDetails, which includes the calling points on the services, allowing access to them without an additional call to get_service_details for each service.

Parameters:
  • crs (str) – the CRS code of the station for which this board is being fetched.
  • rows (int, from 1 to 150) – the maximum number of services to include in the returned board.
  • include_departures (boolean) – whether the returned services should include departures from this station. At least one of include_departures or include_arrivals must be set to true.
  • include_arrivals (boolean) – whether the returned services should include arrivals at this station. At least one of include_departures or include_arrivals must be set to true.
  • from_filter_crs (str) – the CRS code of a station at which all services returned must have called previously. Only one of from_filter_crs and to_filter_crs can be set for a given request.
  • to_filter_crs (str) – the CRS code of a station at which all services returned must subsequently call. Only one of from_filter_crs and to_filter_crs can be set for a given request.
  • time_offset (int, from -120 to 120) – An offset in minutes against the current time which determines the starting point of the time window for which services are returned. If set to None, the value of 0 will be used.
  • time_window (int, from -120 to 120) – How far into the future from the value passed as time_offset should services be fetched. If the value passed is negative, the time window starts before the value of time_offset and ends at time_offset. If None is passed, the default value is 120.
Returns:

a StationBoardWithDetails object containing the station details and the requested services, along with their calling points.

Return type:

StationBoardWithDetails

Raises:

ValueError – if neither include_departures or include_arrivals are set to True.

Note

Each time this his method is called, it makes 1 request to the LDBWS server.

BoardBase

class nrewebservices.ldbws.responses.BoardBase(soap_response)[source]

Bases: nrewebservices.common.soap.SoapResponseObject

This class acts as the base class containing the common attributes for the various classes that encapsulate API responses in the form of a list of services at a station. You do not normally need to instantiate this class directly.

generated_at

datetime – the time at which the board was generated on the LDBWS server.

location_name

str – the name of the location the board is for.

crs

str – the CRS code of the location the board is for.

filter_location_name

str – if a filter was provided in the request, the name of the location at which the board services were filtered.

filter_crs

str – if a filter was provided in the request, the CRS code of the location at which the board services were filtered.

filter_type

str – if a filter was provided in the request, this can contain either “from”, indicating that the filtered services must have previously called at the filter location or “to”, indicating that the filtered services must subsequently call at the filter location.

platforms_available

boolean – if true, this indicates that platform information is available at this station and can be provided in the user interface. If false, this means that platform information is not currently available at this station and should be suppressed in the user interface.

services_available

boolean – if true, this indicates that services are currently available in the returned board. If false, this means that services will not be returned in the provided board. An example of when this might be set false is when a station has been closed due to an incident, but trains are still passing through non-stopping. Normally the nrcc_messages will contain a message explaining the reason for this when it occurs.

nrcc_messages

list[str] – a list of textual messages that should be displayed with the services on the board. These typically contain service information at times when there are problems or disruption. They may sometimes contain HTML style <A> an <P> tags.

StationBoard

class nrewebservices.ldbws.responses.StationBoard(soap_response, *args, **kwargs)[source]

Bases: nrewebservices.ldbws.responses.BoardBase

This class represents the arrivals/departures board of a station, provided in response to a get_station_board request. You do not normally need to instantiate this class directly.

train_services

list[ServiceItem] – the list of train services that appear on the requested board. This list is provided in the order in which it should be displayed.

bus_services

list[ServiceItem] – the list of bus services that appear on the requested board. This list is provided in the order in which it should be displayed.

ferry_services

list[ServiceItem] – the list of ferry services that appear on the requested board. This list is provided in the order in which it should be displayed.

Note

If you are showing a single combined list of train, bus and ferry services, the sort order that is typically used is to sort the services based on scheduled time (arrival/departure as appropriate) with the lowest first. Be careful when showing services across midnight.

StationBoardWithDetails

class nrewebservices.ldbws.responses.StationBoardWithDetails(soap_response, *args, **kwargs)[source]

Bases: nrewebservices.ldbws.responses.BoardBase

This class represents the arrivals/departures board of a station, provided in response to a get_station_board_with_details request. The difference from StationBoard is that this lists of services are of type ServiceItemWithCallingPoints, which includes the service calling points, which would otherwise have to be requested with individual calls to get_service_details. You do not normally need to instantiate this class directly.

train_services

list[ServiceItemWithCallingPoints] – the list of train services that appear on the requested board. This list is provided in the order in which it should be displayed.

bus_services

list[ServiceItemWithCallingPoints] – the list of bus services that appear on the requested board. This list is provided in the order in which it should be displayed.

ferry_services

list[ServiceItemWithCallingPoints] – the list of ferry services that appear on the requested board. This list is provided in the order in which it should be displayed.

Note

If you are showing a single combined list of train, bus and ferry services, the sort order that is typically used is to sort the services based on scheduled time (arrival/departure as appropriate) with the lowest first. Be careful when showing services across midnight.

NextDeparturesBoard

class nrewebservices.ldbws.responses.NextDeparturesBoard(soap_response, *args, **kwargs)[source]

Bases: nrewebservices.ldbws.responses.BoardBase

This class represents the board containing the next departures to the requested destinations. You do not normally need to instantiate this class directly.

next_departures

list[NextDeparturesItem] – a list of objects containing one of the requested locations and the next services that depart to that location.

NextDeparturesBoardWithDetails

class nrewebservices.ldbws.responses.NextDeparturesBoardWithDetails(soap_response, *args, **kwargs)[source]

Bases: nrewebservices.ldbws.responses.BoardBase

This class represents the board containing the next departures to the requested destinations. The difference from NextDeparturesBoard is that the services returned within the NextDepartureItem`s of this board are of type `NexteDepartureItemWithCallingPoints, which includes the service calling points, which otherwise would have to be requested with individual calls to get_service_details. You do not normally need to instantiate this class directly.

next_departures

list[NextDeparturesItemWithCallingPoints] – a list of objects containing one of the requested locations and the next services that depart to that location.

ServiceItemBase

class nrewebservices.ldbws.responses.ServiceItemBase(soap_response)[source]

Bases: nrewebservices.common.soap.SoapResponseObject

This class acts as the base class containing the common attributes for the various classes that encapsulate individual services as shown on the various boards. You do not normally need to instantiate this class directly.

origins

list[ServiceLocation] – a list of the origins of this service. Services may have multiple origins when they are formed of two separate trains that have been joined en-route. This attribute is only populated for boards where arrivals are included.

destinations

list[ServiceLocation] – a list of the destinations of this service. Services may have multiple destinations when they split at a subsequent station into two trains to different destinations. This attribute is only populated for boards where departures are included.

current_origins

list[ServiceLocation] – a list of the currently valid origins of the service. This attribute is only populated when the scheduled origin(s) have been cancelled and the board requsted includes arrivals.

current_destinations

list[ServiceLocation] – a list of the currently valid destinations of the service. This attribute is only populated when the scheduled destination(s) have been cancelled and the board requested includes departures.

sta

str – the scheduled arrival time of the service at this location. The value of the field is as outlined in the LDBWS Times Section. This field is only populated when the board requested includes arrivals and there is an arrival event scheduled at this location.

eta

str – the estimated arrival time of the service at this location. The value of the field is as outlined in the LDBWS Times Section. This field is only populated when the board requested includes arrivals and there is an arrival event scheduled at this location.

std

str – the scheduled departure time of the service at this location. The value of the field is as outlined in the LDBWS Times Section. This field is only populated when the board requested includes departures and there is a departure event scheduled at this location.

etd

str – the estimated departure time of the service at this location. The value of the field is as outlined in the LDBWS Times Section. This field is only populated when the board requested includes departures and there is a departure event scheduled at this location.

platform

str – the platform that this service will use at this location. This will only be present where it is available from station CIS systems and where platforms_available is set to True on the parent board.

operator

str – the name of the Train Operating Company that operates this service.

operator_code

str – the two-letter code identifying the Train Operating Company that operates this service. Please see the Open Rail Data Wiki Toc Codes Page for the full list.

circular_route

boolean – when True, this service is operating on a circular route and will call at this station again later on its journey. This should be clearly communicated in user interfaces to ensure users can effectively identify the right train to take from the different options that exist in this case.

cancelled

boolean – when True, indicates that this service has been cancelled at this location.

filter_location_cancelled

boolean – when True, indicates that the service has had its stop at the requested filter location cancelled and now will not stop there.

service_type

str – the type of transport this service consists of. Can be train, bus or ferry.

length

str – the train length (in number of units). If this is set to 0 then the length of the train is unknown.

detach_front

boolean – if True then the service detaches units from the front at this location.

reverse_formation

boolean – if True then the service is operating in reverse formation (i.e. the order of the train carriages is the reverse of what it normally is).

cancel_reason

str – if this service is canelled, the reason for this cancellation.

delay_reason

str – if this service is delayed, the reason for this delay.

service_id

str – the unique identifier of this service relative to the station of the board at which this service exists. This ID can be used to lookup the service details with get_service_details. However, this ID is not useful for using with any other API, and will expire and stop working within a few hours of the service being deactivated.

adhoc_alerts

str – a list of adhoc alerts to show for this service at this location.

rsid

str – the Retail Service ID of the service, if known by the Darwin system.

origin

str – the origin (or origins) of this service as a single string which is suitable for display directly to users.

destination

str – the destination (or destinations) of this service as a single string which is suitable for display directly to users.

ServiceItem

class nrewebservices.ldbws.responses.ServiceItem(soap_response, *args, **kwargs)[source]

Bases: nrewebservices.ldbws.responses.ServiceItemBase

This class represents a single service that appears on an arrival/departure board. You do not normally need to instantiate this class directly.

ServiceItemWithCallingPoints

class nrewebservices.ldbws.responses.ServiceItemWithCallingPoints(soap_response, *args, **kwargs)[source]

Bases: nrewebservices.ldbws.responses.ServiceItemBase

This class represents a single service that appears on an arrival/departure board where details were requested. The main difference from a regular ServiceItem is that it is prepopulated with the previous and subsequent calling points of the service without requiring an additional request to get_service_details to retrieve these. You do not normally need to instantiate this class directly.

previous_calling_points

[CallingPointList] – a list of CallingPointList objects on this service before the location at which the board was requested. If there is more than one CallingPointList, the first list represents the through service, and the subsequent lists represent associated services, with the location of the join being the fina station on each of the subsequent lists. This is property is only populated when requesting an arrivals or arrivals/departures board.

subsequent_calling_points

[CallingPoint] – a list of CallingPointList objects on this service before the location at which the board was requested. If there is more than one CallingPointList, the first list represents the through service, and the subsequent lists represent associated services, with the location of the join being the final station on each of the subsequent lists. This property is only populated when requesting a departures or arrivals/departures board.

ServiceLocation

class nrewebservices.ldbws.responses.ServiceLocation(soap_response, *args, **kwargs)[source]

Bases: nrewebservices.common.soap.SoapResponseObject

This class represents a single location (station) at which a service either begins or ends. You do not normally need to instantiate this class directly.

location_name

str – the name of the location.

crs

str – the CRS code of the location. A CRS code of ??? indicates that the location has no CRS code that is known to the Darwin system.

via

str – when the service is taking an ambiguous route, a string of text describing the station or stations it travels via in order to disambiguate. This is typically displayed after the destination on departure boards. It is only present for destinations.

future_change_to

str – if the service is to change to a different mode in future, that mode is indicated here (either bus/train/ferry).

association_is_cancelled

boolean – True if the associated service has been cancelled that took this service to this origin or destination, meaning this location will no longer be reached by the running service.

CallingPoint

class nrewebservices.ldbws.responses.CallingPoint(soap_response, *args, **kwargs)[source]

Bases: nrewebservices.common.soap.SoapResponseObject

This class represents a single calling point along a service (i.e. a the details of a stop made at a station by the service). You do not normally need to instantiate this class directly.

location_name

str – the name of the station where the stop occurs.

crs

str – the CRS code of the station at which the stop occurs. A CRS code of ??? indicates that the location has no CRS code that is known to the Darwin system.

st

str – the scheduled time at which the stop occurs. If this is a previous calling point, the value will be the departure time. If it is a subsequent calling point, then the value will be an arrival time. The value of this field is as outlined in the section on LDBWS times.

et

str – the estimated time at which the service will make this stop. If this is a previous calling point, the value will be the departure time. If it is a subsequent calling point then the value will be the arrival time. Only one of et and at is ever populated at a time for a given calling point. The value of this field is as outlined in the section on LDBWS times.

at

str – the actual time at which the service made this stop. If this is a previous calling point, the value will be the departure time. If it is a subsequent calling point then the value will be the arrival time. Only one of et and at is ever populated at a time for a given calling point. The value of this field is as outlined in the section on LDBWS times.

cancelled

boolean – when True, indicates that this service is cancelled at this location.

length

str – the train length (in number of units). If this is set to 0 then the length of the train is unknown.

detach_front

boolean – if True then the service detaches units from the front at this location.

adhoc_alerts

str – a list of adhoc alerts to show for this service at this location.

CallingPointList

class nrewebservices.ldbws.responses.CallingPointList(soap_response)[source]

Bases: nrewebservices.common.soap.SoapResponseObject

This class represents a list of calling points along a service. You do not normally need to instantiate this class directly.

calling_points

[CallingPoint] – the list of calling points this CallingPointList represents.

service_type

str – the type of service these calling points are provided by. Can be either ‘train’, ‘bus’ or ‘ferry’.

change_required

boolean – if True, passengers must change vehicles to access these calling points.

association_is_cancelled

boolean – if True, the association between the service providing these calling points and the through service has been cancelled, meaning these calling points can no longer be reached on this service.

Note

If a CallingPointList is treated as a regular python list, the calling_points property is implicitly accessed.

NextDeparturesItemBase

class nrewebservices.ldbws.responses.NextDeparturesItemBase(soap_response)[source]

Bases: nrewebservices.common.soap.SoapResponseObject

This class acts as the base clas for entries on the next departures boards, containing the common attributes therof. You do not normally need to instantiate this class directly.

crs

str – the CRS code of the location that this departure item contains the next departures to.

NextDeparturesItem

class nrewebservices.ldbws.responses.NextDeparturesItem(soap_response, *args, **kwargs)[source]

Bases: nrewebservices.ldbws.responses.NextDeparturesItemBase

This class represents an entry on a NextDeparturesBoard, containing the next departures to a single location. You do not normally need to instantiate this class directly.

service

ServiceItem – the next service to depart to the requested location.

NextDeparturesItemWithCallingPoints

class nrewebservices.ldbws.responses.NextDeparturesItemWithCallingPoints(soap_response, *args, **kwargs)[source]

Bases: nrewebservices.ldbws.responses.NextDeparturesItemBase

This class represents an entry on a NextDeparturesBoardWithDetails, containing the next departures to a single location. The difference between this and NextDeparturesItem is that the services are of type ServiceItemWithCallingPoints, which includes the service calling points which otherwise would have to be requested with individual calls to get_service_details. You do not normally need to instantiate this class directly.

service

ServiceItemWithCallingPoints – the next service to depart to the requested location.

ServiceDetails

class nrewebservices.ldbws.responses.ServiceDetails(soap_response, *args, **kwargs)[source]

Bases: nrewebservices.common.soap.SoapResponseObject

This class represents the details of a service from the point of view of the station at which that service was requested. You do not normally need to instantiate this class directly.

generated_at

datetime – the time at which the service details were generated on the LDBWS server.

rsid

str – the Retail Service ID of the service, if known by the Darwin system.

service_type

str – The type of service (“bus/ferry/train”). Note that real-time information such as estimated and actual times and cancellations is only available for train services.

location_name

str – the name of the location at which this service was requested. This is determined by the board that the service ID was originally retrieved from. All other fields in this object are from the point of view of inspecting the service at this location.

crs

str – the CRS code of the location at which this service was requested. See the location_name attribute for more details.

operator

str – the name of the Train Operating Company that operates this service.

operator_code

str – the two-letter code identifying the Train Operating Company that operates this service. Please see the Open Rail Data Wiki Toc Codes Page for the full list.

cancelled

boolean – when True, indicates that this service has been cancelled at this location.

cancel_reason

str – if this service is canelled, the reason for this cancellation.

delay_reason

str – if this service is delayed, the reason for this delay.

overdue_message

str – if a report on an expected movement of this service has not been received on time, this attribute will contain a plain-English explanation of the report which was expected.

length

str – the train length (in number of units). If this is set to 0 then the length of the train is unknown.

detach_front

boolean – if True then the service detaches units from the front at this location.

reverse_formation

boolean – if True then the service is operating in reverse formation (i.e. the order of the train carriages is the reverse of what it normally is).

platform

str – the platform that this service will use at this location. This will only be present where it is available from station CIS systems and where platforms_available is set to True on the board from which this service was requested.

sta

str – the scheduled arrival time of the service at this location. The value of the field is as outlined in the LDBWS Times Section. This field is only populated when the board requested includes arrivals and there is an arrival event scheduled at this location.

eta

str – the estimated arrival time of the service at this location. The value of the field is as outlined in the LDBWS Times Section. This field is only populated when there is an arrival event scheduled at this location. Only one of eta and ata will be present at a time for a given service.

ata

str – the actual arrival time of the service at this location. The value of the field is as outlined in the LDBWS Times Section. This field is only populated when there is an arrival event scheduled at this location. Only one of eta and ata will be present at a time for a given service.

std

str – the scheduled departure time of the service at this location. The value of the field is as outlined in the LDBWS Times Section. This field is only populated when the board requested includes departures and there is a departure event scheduled at this location.

etd

str – the estimated departure time of the service at this location. The value of the field is as outlined in the LDBWS Times Section. This field is only populated when there is a departure event scheduled at this location. Only one of etd and atd will be present at a time for a given service.

atd

str – the actual departure time of the service at this location. The value of the field is as outlined in the LDBWS Times Section. This field is only populated when there is a departure event scheduled at this location. Only one of etd and atd will be present at a time for a given service.

adhoc_alerts

str – a list of adhoc alerts to show for this service at this location.

previous_calling_points

[CallingPointList] – a list of CallingPointList objects on this service before the location at which the board was requested. If there is more than one CallingPointList, the first list represents the through service, and the subsequent lists represent associated services, with the location of the join being the final station on each of the subsequent lists.

subsequent_calling_points

[CallingPointList] – a list of CallingPointList objects on this service after the location at which the board was requested. If there is more than one CallingPointList, the first list represents the through service, and the subsequent lists represent associated services, with the location of the join being the first station on each of the subsequent lists.