The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

ura-m - Unofficial interface to URA-based departure monitors

SYNOPSIS

ura-m [-s service] [-pV] [-l lines] [-o outputtypes] [-f timefmt | -F timefmt] [-v stopname] stopname

VERSION

version 2.01

DESCRIPTION

ura-m lists upcoming bus departures and bus service messages at the stop name. It only shows realtime data and has no knowledge of schedules or delays. Departures without such data may not appear at all.

OPERATOR SELECTION

By default, ura-m looks up departures for stops operated by ASEAG (Aachener Straßenbahn und Energieversorgungs AG), so it only works for Aachen and its vicinity. Other operators (and, thus, other areas) can be selected using either the -s/--service option, the --ura-base option, or the program name.

By creating a service-m symlink to ura-m, it will default to the URA interface operated by service, as if -s service was specified. So, for example, linking tfl-m to ura-m will request departures for TfL-operated stops, and linking aseag-m to ura-m will request departures for ASEAG-operated stops.

Use the --list option to get a list of supported backend services.

OPTIONS

-f, --strftime format

Format absolute times in format, applies both to departure and route output. See DateTime(3pm) for allowed patterns.

-F, --strfrel format

Format relative times in format, only applies when used with -oT. See DateTime::Format::Duration(3pm) for allowed patterns.

-l, --line lines

Limit output to departures of lines (comma-separated list of line names, may be used multiple times).

--list

List supported URA services with their URLs (see --ura-base) and abbreviations (see -s).

-o, --output outputtypes

Format output according to outputtypes. outputtypes is a comma-separated list and the --output option may be repeated. Each output type has both a short and a long form, so for instance both -or,T and --output=route_interesting,relative_times are valid.

Valid output types are:

a / route_after

For each departure, include the route after name. Both stop names and departure times are shown.

b / route_before

For each departure, include the route leading to name. Both stop names and departure times are shown.

f / route_full

For each departure, include the entire route (stop names and departure times).

i / indicator

Show stop point indicator, if available. This is usually a sub-stop or platform number, such as "H3".

r / route_interesting

For each departure, show up to three "interesting" stops between name and its destination. The importance of a stop is determined heuristically based on its name, so it is not always accurate.

T / relative_times

Show relative times. Applies to departure and route output.

Note that the routes may be incomplete, since the backend only provides a limited amount of departures and the routes are calculated from this set. intermediate stops are always included, but both route_after and route_before may be cut off after / before any stop. The same applies to route_full.

-p, --with-past

Include past departures. Applies both to the departure output and to the route output of -oa, -ob, -of.

-s, --service service

Request departures for URA instance service, e.g. ASEAG (Aachen, Germany) or TfL (London, UK). Use --list to get a list of supported URA instances. Note that service is not case sensitive.

-v, --via stop

Only show lines which also serve stop after name.

-V, --version

Show version information.

--ura-base url

Set URA base to url, defaults to http://ivu.aseag.de/interfaces/ura. See also --list and -s.

--ura-version version

Set URA API version to version, defaults to 1.

EXIT STATUS

Normally zero. 1 means ura-m was called with invalid options, 2 indicates a request error from Travel::Status::DE::URA(3pm), 3 a bad (unknown or ambiguous) stop name.

CONFIGURATION

None.

DEPENDENCIES

  • Class::Accessor(3pm)

  • DateTime(3pm)

  • DateTime::Format::Duration(3pm)

  • LWP::UserAgent(3pm)

  • Text::CSV(3pm)

BUGS AND LIMITATIONS

Unknown.

AUTHOR

Copyright (C) 2013-2016 by Daniel Friesel <derf@finalrewind.org>

LICENSE

This program is licensed under the same terms as Perl itself.