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

NAME

Travel::Status::DE::HAFAS::Stop - Information about a HAFAS stop.

SYNOPSIS

        # in journey mode
        for my $stop ($journey->route) {
                printf(
                        %5s -> %5s %s\n",
                        $stop->arr ? $stop->arr->strftime('%H:%M') : '--:--',
                        $stop->dep ? $stop->dep->strftime('%H:%M') : '--:--',
                        $stop->loc->name
                );
        }

VERSION

version 6.00

DESCRIPTION

Travel::Status::DE::HAFAS::Stop describes a Travel::Status::DE::HAFAS::Journey(3pm)'s stop at a given Travel::Status::DE::HAFAS::Location(3pm) with arrival/departure time, platform, etc.

All date and time entries refer to the backend time zone (Europe/Berlin in most cases) and do not take local time into account; see tz_offset for the latter.

METHODS

ACCESSORS

$stop->loc

Travel::Status::DE::HAFAS::Location(3pm) instance describing stop name, EVA ID, et cetera.

$stop->rt_arr

DateTime object for actual arrival.

$stop->sched_arr

DateTime object for scheduled arrival.

$stop->arr

DateTime object for actual or scheduled arrival.

$stop->arr_delay

Arrival delay in minutes.

$stop->arr_cancelled

Arrival is cancelled.

$stop->rt_dep

DateTime object for actual departure.

$stop->sched_dep

DateTime object for scheduled departure.

$stop->dep

DateTIme object for actual or scheduled departure.

$stop->dep_delay

Departure delay in minutes.

$stop->dep_cancelled

Departure is cancelled.

$stop->tz_offset

Offset between backend time zone (default: Europe/Berlin) and this stop's time zone in minutes, if any. For instance, if the backend uses UTC+2 (CEST) and the stop uses UTC+1 (IST), tz_offset is -60. Returns undef if both use the same time zone (or rather, the same UTC offset).

$stop->delay

Departure or arrival delay in minutes.

$stop->direction

Direction signage from this stop on, undef if unchanged.

$stop->messages

List of Travel::Status::DE::HAFAS::Message(3pm) instances related to this stop. These typically refer to delay reasons, platform changes, or changes in the line number / direction heading.

$stop->prod_arr

Travel::Status::DE::HAFAS::Product(3pm) instance describing the transit product (name, type, line number, operator, ...) upon arrival at this stop.

$stop->prod_dep

Travel::Status::DE::HAFAS::Product(3pm) instance describing the transit product (name, type, line number, operator, ...) upon departure from this stop.

$stop->rt_platform

Actual platform.

$stop->sched_platform

Scheduled platform.

$stop->platform

Actual or scheduled platform.

$stop->is_changed_platform

True if real-time and scheduled platform disagree.

$stop->is_additional

True if the stop is an unscheduled addition to the train's route.

$stop->load

Expected utilization / passenger load from this stop on.

DIAGNOSTICS

None.

DEPENDENCIES

Class::Accessor(3pm)

BUGS AND LIMITATIONS

None known.

SEE ALSO

Travel::Status::DE::HAFAS(3pm).

AUTHOR

Copyright (C) 2023 by Birte Kristina Friesel <derf@finalrewind.org>

LICENSE

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