Runs on a given route

runs_on_route(
  route_id,
  route_type = NULL,
  date_utc = NULL,
  user_id = determine_user_id(),
  api_key = determine_api_key()
)

Arguments

route_id

Integer. These can be listed and described with the routes function.

route_type

Optionally filter results by a route type. A route type can be provided either as a non-negative integer code, or as a character: "Tram", "Train", "Bus", "Vline" or "Night Bus". Character inputs are not case-sensitive. Use the route_types function to extract a vector of all route types.

date_utc

Date, or character that can be converted to a date. The UTC date for which the results are effective. Defaults to the current date. It's uncertain how much historical or future-dated data is available. This argument is experimental and seems to not be functioning.

user_id

Integer or character. A user ID or devid provided by Public Transport Victoria. Refer to ?ptvapi for more details.

api_key

Character. An API key, with dashes, provided by Public Transport Victoria. Refer to ?ptvapi for more details.

Value

A tibble with the following columns:

  • run_id (deprecated, use run_ref instead)

  • run_ref

  • route_id

  • route_type

  • route_type_description

  • direction_id

  • run_sequence

  • final_stop_id

  • destination_name

  • status

  • express_stop_count

  • vehicle_position

  • vehicle_descriptor

  • geopath

Examples

if (FALSE) { runs_on_route(6) runs_on_route(6, route_type = "Train") runs_on_route(6, route_type = 0) }