summaryrefslogtreecommitdiff
path: root/lib/Travel/Status/DE/IRIS/Result.pm
diff options
context:
space:
mode:
Diffstat (limited to 'lib/Travel/Status/DE/IRIS/Result.pm')
-rw-r--r--lib/Travel/Status/DE/IRIS/Result.pm845
1 files changed, 378 insertions, 467 deletions
diff --git a/lib/Travel/Status/DE/IRIS/Result.pm b/lib/Travel/Status/DE/IRIS/Result.pm
index c53d9c4..9113f88 100644
--- a/lib/Travel/Status/DE/IRIS/Result.pm
+++ b/lib/Travel/Status/DE/IRIS/Result.pm
@@ -5,99 +5,133 @@ use warnings;
use 5.014;
use utf8;
-no if $] >= 5.018, warnings => 'experimental::smartmatch';
-
use parent 'Class::Accessor';
use Carp qw(cluck);
use DateTime;
use DateTime::Format::Strptime;
use List::Compare;
-use List::MoreUtils qw(none uniq firstval);
-use Scalar::Util qw(weaken);
+use List::Util qw(any);
+use List::MoreUtils qw(uniq lastval);
+use Scalar::Util qw(weaken);
+
+our $VERSION = '1.96';
+
+Travel::Status::DE::IRIS::Result->mk_ro_accessors(
+ qw(arrival arrival_delay arrival_has_realtime arrival_is_additional arrival_is_cancelled arrival_hidden
+ date datetime delay
+ departure departure_delay departure_has_realtime departure_is_additional departure_is_cancelled departure_hidden
+ ds100 has_realtime is_transfer is_unscheduled is_wing
+ line_no old_train_id old_train_no operator platform raw_id
+ realtime_xml route_start route_end
+ sched_arrival sched_departure sched_platform sched_route_start
+ sched_route_end start
+ station station_eva station_uic
+ stop_no time train_id train_no transfer type
+ unknown_t unknown_o wing_id wing_of)
+);
-our $VERSION = '1.28';
+# {{{ Data (message codes, station fixups)
my %translation = (
- 2 => 'Polizeiliche Ermittlung',
- 3 => 'Feuerwehreinsatz neben der Strecke',
- 4 => 'Kurzfristiger Personalausfall',
+ 1 => 'Nähere Informationen in Kürze',
+ 2 => 'Polizeieinsatz',
+ 3 => 'Feuerwehreinsatz auf der Strecke',
+ 4 => 'Kurzfristiger Personalausfall', # xlsx: missing
5 => 'Ärztliche Versorgung eines Fahrgastes',
- 6 => 'Betätigen der Notbremse',
- 7 => 'Personen im Gleis',
- 8 => 'Notarzteinsatz am Gleis',
+ 6 => 'Betätigen der Notbremse', # xlsx: "Unbefugtes Ziehen der Notbremse"
+ 7 => 'Unbefugte Personen auf der Strecke',
+ 8 => 'Notarzteinsatz auf der Strecke',
9 => 'Streikauswirkungen',
- 10 => 'Ausgebrochene Tiere im Gleis',
+ 10 => 'Tiere auf der Strecke',
11 => 'Unwetter',
- 12 => 'Warten auf Fahrgäste aus einem Schiff',
+ 12 => 'Warten auf ein verspätetes Schiff',
13 => 'Pass- und Zollkontrolle',
- 14 => 'Technische Störung am Bahnhof',
+ 14 => 'Defekt am Bahnhof', # xlsx: "Technischer Defekt am Bahnhof"
15 => 'Beeinträchtigung durch Vandalismus',
16 => 'Entschärfung einer Fliegerbombe',
17 => 'Beschädigung einer Brücke',
- 18 => 'Umgestürzter Baum im Gleis',
+ 18 => 'Umgestürzter Baum auf der Strecke',
19 => 'Unfall an einem Bahnübergang',
- 20 => 'Tiere im Gleis',
- 21 => 'Warten auf weitere Reisende',
- 22 => 'Witterungsbedingte Störung',
- 23 => 'Feuerwehreinsatz auf Bahngelände',
- 24 => 'Verspätung aus dem Ausland',
- 25 => 'Warten auf verspätete Zugteile',
- 28 => 'Gegenstände im Gleis',
+ 20 => 'Tiere im Gleis', # xlsx: missing
+ 21 => 'Warten auf Anschlussreisende',
+ 22 => 'Witterungsbedingte Beeinträchtigung',
+ 23 => 'Betriebsstabilisierung',
+ 24 => 'Verspätung im Ausland',
+ 25 => 'Bereitstellung weiterer Wagen',
+ 26 => 'Abhängen von Wagen',
+ 28 => 'Gegenstände auf der Strecke',
+ 29 => 'Ersatzverkehr mit Bus ist eingerichtet',
31 => 'Bauarbeiten',
- 32 => 'Verzögerung beim Ein-/Ausstieg',
- 33 => 'Oberleitungsstörung',
- 34 => 'Signalstörung',
+ 32 => 'Längere Haltezeit am Bahnhof',
+ 33 => 'Defekt an der Oberleitung', # xlsx: "Reparatur an der Oberleitung"
+ 34 => 'Defekt an einem Signal', # xlsx: "Reparatur an einem Signal"
35 => 'Streckensperrung',
36 => 'Technische Störung am Zug',
- 37 => 'Technische Störung am Wagen',
- 38 => 'Technische Störung an der Strecke',
- 39 => 'Anhängen von zusätzlichen Wagen',
- 40 => 'Stellwerksstörung/-ausfall',
- 41 => 'Störung an einem Bahnübergang',
- 42 => 'Außerplanmäßige Geschwindigkeitsbeschränkung',
+ 37 => 'Kurzfristiger Fahrzeugausfall',
+ 38 => 'Defekt an der Strecke', # xlsx: "Reparatur an der Strecke"
+ 39 => 'Stau / Hohes Verkehrsaufkommen',
+ 40 => 'Defektes Stellwerk',
+ 41 => 'Defekt an einem Bahnübergang'
+ , # xlsx: "Technischer Defekt an einem Bahnüburgang"
+ 42 => 'Außerplanmäßige Geschwindigkeitsbeschränkung'
+ , # xlsx: "Vorübergehend verminderte Geschwindigkeit auf der Strecke"
43 => 'Verspätung eines vorausfahrenden Zuges',
44 => 'Warten auf einen entgegenkommenden Zug',
- 45 => 'Überholung durch anderen Zug',
- 46 => 'Warten auf freie Einfahrt',
+ 45 => 'Vorfahrt eines anderen Zuges',
+ 46 => 'Vorfahrt eines anderen Zuges',
+
47 => 'Verspätete Bereitstellung',
48 => 'Verspätung aus vorheriger Fahrt',
- 55 => 'Technische Störung an einem anderen Zug', # ?
- 56 => 'Warten auf Fahrgäste aus einem Bus',
- 57 => 'Zusätzlicher Halt',
- 58 => 'Umleitung', # ?
+ 49 => 'Kurzfristiger Personalausfall',
+ 50 => 'Kurzfristige Erkrankung von Personal',
+ 51 => 'Verspätetes Personal aus vorheriger Fahrt',
+ 52 => 'Streik',
+ 53 => 'Unwetterauswirkungen',
+ 54 => 'Verfügbarkeit der Gleise derzeit eingeschränkt',
+ 55 => 'Technischer Defekt an einem anderen Zug',
+ 56 => 'Warten auf Anschlussreisende', # aus einem Bus
+ 57 => 'Zusätzlicher Halt', # xslx: "Zusätzlicher Halt zum Ein- und Ausstieg"
+ 58 => 'Umleitung', # xlsx: "Umleitung des Zuges"
59 => 'Schnee und Eis',
- 60 => 'Reduzierte Geschwindigkeit wegen Sturm',
- 61 => 'Türstörung',
- 62 => 'Behobene technische Störung am Zug',
+ 60 => 'Witterungsbedingt verminderte Geschwindigkeit',
+ 61 => 'Defekte Tür',
+ 62 => 'Behobener Defekt am Zug',
63 => 'Technische Untersuchung am Zug',
- 64 => 'Weichenstörung',
+ 64 => 'Defekt an einer Weiche',
65 => 'Erdrutsch',
66 => 'Hochwasser',
- 70 => 'Kein WLAN',
+ 67 => 'Behördliche Maßnahme',
+ 68 => 'Hohes Fahrgastaufkommen'
+ , # xlsx: "Hohes Fahrgastaufkommen verlängert Ein- und Ausstieg"
+ 69 => 'Zug verkehrt mit verminderter Geschwindigeit',
+ 70 => 'WLAN nicht verfügbar',
71 => 'WLAN in einzelnen Wagen nicht verfügbar',
- 73 => 'Mehrzweckabteil vorne',
- 74 => 'Mehrzweckabteil hinten',
- 75 => '1. Klasse vorne',
- 76 => '1. Klasse hinten',
- 77 => 'Ohne 1. Klasse',
- 79 => 'Ohne Mehrzweckabteil',
+ 72 => 'Info/Entertainment nicht verfügbar',
+ 73 => 'Heute: Mehrzweckabteil vorne',
+ 74 => 'Heute: Mehrzweckabteil hinten',
+ 75 => 'Heute: 1. Klasse vorne',
+ 76 => 'Heute: 1. Klasse hinten',
+ 77 => '1. Klasse fehlt',
+ 78 => 'Ersatzverkehr mit Bus ist eingerichtet',
+ 79 => 'Mehrzweckabteil fehlt',
80 => 'Abweichende Wagenreihung',
+ 81 => 'Fahrzeugtausch',
82 => 'Mehrere Wagen fehlen',
- 83 => 'Fehlender Zugteil',
- 84 => 'Zug verkehrt richtig gereiht', # r 80 82 83 85
+ 83 => 'Defekte fahrzeuggebundene Einstiegshilfe',
+ 84 => 'Zug verkehrt richtig gereiht',
85 => 'Ein Wagen fehlt',
- 86 => 'Keine Reservierungsanzeige',
- 87 => 'Einzelne Wagen ohne Reservierungsanzeige',
- 88 => 'Keine Qualitätsmängel', # r 80 82 83 85 86 87 90 91 92 93 96 97 98
- 89 => 'Reservierungen sind wieder vorhanden', # -> 86 87
- 90 => 'Kein Bordrestaurant/Bordbistro',
- 91 => 'Eingeschränkte Fahrradmitnahme',
- 92 => 'Klimaanlage in einzelnen Wagen ausgefallen',
- 93 => 'Fehlende oder gestörte behindertengerechte Einrichtung',
+ 86 => 'Gesamter Zug ohne Reservierung',
+ 87 => 'Einzelne Wagen ohne Reservierung',
+ 88 => 'Keine Qualitätsmängel',
+ 89 => 'Reservierungen sind wieder vorhanden',
+ 90 => 'Kein gastronomisches Angebot',
+ 91 => 'Fahrradmitnahme nicht möglich',
+ 92 => 'Eingeschränkte Fahrradbeförderung',
+ 93 => 'Behindertengerechte Einrichtung fehlt',
94 => 'Ersatzbewirtschaftung',
- 95 => 'Ohne behindertengerechtes WC',
- 96 => 'Der Zug ist stark überbesetzt', # r 97
- 97 => 'Der Zug ist überbesetzt', # r 96
+ 95 => 'Universal-WC fehlt',
+ 96 => 'Überbesetzung mit Kulanzleistungen',
+ 97 => 'Überbesetzung ohne Kulanzleistungen',
98 => 'Sonstige Qualitätsmängel',
99 => 'Verzögerungen im Betriebsablauf',
@@ -106,55 +140,17 @@ my %translation = (
# it refers to, we don't show it to users.
);
-Travel::Status::DE::IRIS::Result->mk_ro_accessors(
- qw(arrival arrival_delay arrival_is_additional arrival_is_cancelled
- date datetime delay
- departure departure_delay departure_is_additional departure_is_cancelled
- is_transfer is_unscheduled is_wing
- line_no old_train_id old_train_no platform raw_id
- realtime_xml route_start route_end
- sched_arrival sched_departure sched_platform sched_route_start
- sched_route_end start stop_no time train_id train_no transfer type
- unknown_t unknown_o wing_id)
+# IRIS may return "Betriebsstelle nicht bekannt" for some recently added
+# stations. Fix those manually.
+my %fixup = (
+ 8002795 => 'Herten(Westf)',
+ 8003983 => 'Merklingen - Schwäbische Alb',
+ 8005493 => 'Schwetzingen-Hirschacker',
+ 8070678 => 'Metzingen-Neuhausen',
);
-sub is_additional {
- my ($self) = @_;
-
- if ( $self->{arrival_is_additional} and $self->{departure_is_additional} ) {
- return 1;
- }
- if ( $self->{arrival_is_additional}
- and not defined $self->{departure_is_additional} )
- {
- return 1;
- }
- if ( not defined $self->{arrival_is_additional}
- and $self->{departure_is_additional} )
- {
- return 1;
- }
- return 0;
-}
-
-sub is_cancelled {
- my ($self) = @_;
-
- if ( $self->{arrival_is_cancelled} and $self->{departure_is_cancelled} ) {
- return 1;
- }
- if ( $self->{arrival_is_cancelled}
- and not defined $self->{departure_is_cancelled} )
- {
- return 1;
- }
- if ( not defined $self->{arrival_is_cancelled}
- and $self->{departure_is_cancelled} )
- {
- return 1;
- }
- return 0;
-}
+# }}}
+# {{{ Constructor
sub new {
my ( $obj, %opt ) = @_;
@@ -211,6 +207,9 @@ sub new {
$ref->{route_post} = $ref->{sched_route_post}
= [ split( qr{[|]}, $ref->{route_post} // q{} ) ];
+ $ref->fixup_route( $ref->{route_pre} );
+ $ref->fixup_route( $ref->{route_post} );
+
$ref->{route_pre_incomplete} = $ref->{route_end} ? 1 : 0;
$ref->{route_post_incomplete} = $ref->{route_post} ? 1 : 0;
@@ -229,6 +228,20 @@ sub new {
return $ref;
}
+# }}}
+# {{{ Internal Helpers
+
+sub fixup_route {
+ my ( $self, $route ) = @_;
+ for my $stop ( @{$route} ) {
+ if ( $stop =~ m{^Betriebsstelle nicht bekannt (\d+)$} ) {
+ if ( $fixup{$1} ) {
+ $stop = $fixup{$1};
+ }
+ }
+ }
+}
+
sub parse_ts {
my ( $self, $string ) = @_;
@@ -238,10 +251,51 @@ sub parse_ts {
return;
}
+# List::Compare does not keep the order of its arguments (even with unsorted).
+# So we need to re-sort all stops to maintain their original order.
+sub sorted_sublist {
+ my ( $self, $list, $sublist ) = @_;
+ my %pos;
+
+ if ( not $sublist or not @{$sublist} ) {
+ return;
+ }
+
+ for my $i ( 0 .. $#{$list} ) {
+ $pos{ $list->[$i] } = $i;
+ }
+
+ my @sorted = sort { $pos{$a} <=> $pos{$b} } @{$sublist};
+
+ return @sorted;
+}
+
+sub superseded_messages {
+ my ( $self, $msg ) = @_;
+ my %superseded = (
+ 62 => [36],
+ 73 => [74],
+ 74 => [73],
+ 75 => [76],
+ 76 => [75],
+ 84 => [ 73, 74, 75, 76, 80 ],
+ 88 => [
+ 70, 71, 72, 77, 79, 82, 83, 85, 90, 91, 92, 93, 94, 95, 96, 97, 98
+ ],
+ 89 => [ 86, 87 ],
+ );
+
+ return @{ $superseded{$msg} // [] };
+}
+
+# }}}
+# {{{ Internal Setters for IRIS.pm
+
sub set_ar {
my ( $self, %attrib ) = @_;
if ( $attrib{status} and $attrib{status} eq 'c' ) {
+ $self->{has_realtime} = $self->{arrival_has_realtime} = 1;
$self->{arrival_is_cancelled} = 1;
}
elsif ( $attrib{status} and $attrib{status} eq 'a' ) {
@@ -252,6 +306,10 @@ sub set_ar {
$self->{arrival_is_cancelled} = 0;
}
+ if ( $attrib{arrival_hidden} ) {
+ $self->{arrival_hidden} = $attrib{arrival_hidden};
+ }
+
# unscheduled arrivals may not appear in the plan, but we do need to
# know their planned arrival time
if ( $attrib{plan_arrival_ts} ) {
@@ -260,7 +318,8 @@ sub set_ar {
}
if ( $attrib{arrival_ts} ) {
- $self->{arrival} = $self->parse_ts( $attrib{arrival_ts} );
+ $self->{has_realtime} = $self->{arrival_has_realtime} = 1;
+ $self->{arrival} = $self->parse_ts( $attrib{arrival_ts} );
if ( not $self->{arrival_is_cancelled} ) {
$self->{delay} = $self->{arrival_delay}
= $self->arrival->subtract_datetime( $self->sched_arrival )
@@ -280,9 +339,12 @@ sub set_ar {
$self->{platform} = $self->{sched_platform};
}
- if ( $attrib{route_pre} ) {
- $self->{route_pre} = [ split( qr{[|]}, $attrib{route_pre} // q{} ) ];
- $self->{route_start} = $self->{route_pre}[0];
+ if ( defined $attrib{route_pre} ) {
+ $self->{route_pre} = [ split( qr{[|]}, $attrib{route_pre} // q{} ) ];
+ $self->fixup_route( $self->{route_pre} );
+ if ( @{ $self->{route_pre} } ) {
+ $self->{route_start} = $self->{route_pre}[0];
+ }
}
else {
$self->{route_pre} = $self->{sched_route_pre};
@@ -293,6 +355,7 @@ sub set_ar {
if ( $attrib{sched_route_pre} ) {
$self->{sched_route_pre}
= [ split( qr{[|]}, $attrib{sched_route_pre} // q{} ) ];
+ $self->fixup_route( $self->{sched_route_pre} );
$self->{sched_route_start} = $self->{sched_route_pre}[0];
}
@@ -303,6 +366,7 @@ sub set_dp {
my ( $self, %attrib ) = @_;
if ( $attrib{status} and $attrib{status} eq 'c' ) {
+ $self->{has_realtime} = $self->{arrival_has_realtime} = 1;
$self->{departure_is_cancelled} = 1;
}
elsif ( $attrib{status} and $attrib{status} eq 'a' ) {
@@ -313,6 +377,10 @@ sub set_dp {
$self->{departure_is_cancelled} = 0;
}
+ if ( $attrib{departure_hidden} ) {
+ $self->{departure_hidden} = $attrib{departure_hidden};
+ }
+
# unscheduled arrivals may not appear in the plan, but we do need to
# know their planned arrival time
if ( $attrib{plan_departure_ts} ) {
@@ -321,7 +389,8 @@ sub set_dp {
}
if ( $attrib{departure_ts} ) {
- $self->{departure} = $self->parse_ts( $attrib{departure_ts} );
+ $self->{has_realtime} = $self->{departure_has_realtime} = 1;
+ $self->{departure} = $self->parse_ts( $attrib{departure_ts} );
if ( not $self->{departure_is_cancelled} ) {
$self->{delay} = $self->{departure_delay}
= $self->departure->subtract_datetime( $self->sched_departure )
@@ -341,9 +410,12 @@ sub set_dp {
$self->{platform} = $self->{sched_platform};
}
- if ( $attrib{route_post} ) {
+ if ( defined $attrib{route_post} ) {
$self->{route_post} = [ split( qr{[|]}, $attrib{route_post} // q{} ) ];
- $self->{route_end} = $self->{route_post}[-1];
+ $self->fixup_route( $self->{route_post} );
+ if ( @{ $self->{route_post} } ) {
+ $self->{route_end} = $self->{route_post}[-1];
+ }
}
else {
$self->{route_post} = $self->{sched_route_post};
@@ -354,6 +426,7 @@ sub set_dp {
if ( $attrib{sched_route_post} ) {
$self->{sched_route_post}
= [ split( qr{[|]}, $attrib{sched_route_post} // q{} ) ];
+ $self->fixup_route( $self->{sched_route_post} );
$self->{sched_route_end} = $self->{sched_route_post}[-1];
}
@@ -388,13 +461,19 @@ sub set_unscheduled {
my ( $self, $unscheduled ) = @_;
$self->{is_unscheduled} = $unscheduled;
+
+ return $self;
}
sub add_arrival_wingref {
my ( $self, $ref ) = @_;
- $ref->{is_wing} = 1;
+ my $backref = $self;
+
weaken($ref);
+ weaken($backref);
+ $ref->{is_wing} = 1;
+ $ref->{wing_of} = $backref;
push( @{ $self->{arrival_wings} }, $ref );
return $self;
}
@@ -402,8 +481,12 @@ sub add_arrival_wingref {
sub add_departure_wingref {
my ( $self, $ref ) = @_;
- $ref->{is_wing} = 1;
+ my $backref = $self;
+
weaken($ref);
+ weaken($backref);
+ $ref->{is_wing} = 1;
+ $ref->{wing_of} = $backref;
push( @{ $self->{departure_wings} }, $ref );
return $self;
}
@@ -417,7 +500,37 @@ sub add_reference {
return $self;
}
-# never called externally
+sub merge_with_departure {
+ my ( $self, $result ) = @_;
+
+ # result must be departure-only
+
+ $self->{is_transfer} = 1;
+
+ $self->{old_train_id} = $self->{train_id};
+ $self->{old_train_no} = $self->{train_no};
+
+ # departure is preferred over arrival, so overwrite default values
+ $self->{date} = $result->{date};
+ $self->{time} = $result->{time};
+ $self->{epoch} = $result->{epoch};
+ $self->{datetime} = $result->{datetime};
+ $self->{train_id} = $result->{train_id};
+ $self->{train_no} = $result->{train_no};
+
+ $self->{departure} = $result->{departure};
+ $self->{departure_wings} = $result->{departure_wings};
+ $self->{route_end} = $result->{route_end};
+ $self->{route_post} = $result->{route_post};
+ $self->{sched_departure} = $result->{sched_departure};
+ $self->{sched_route_post} = $result->{sched_route_post};
+
+ # update realtime info only if applicable
+ $self->{is_cancelled} ||= $result->{is_cancelled};
+
+ return $self;
+}
+
sub add_inverse_reference {
my ( $self, $ref ) = @_;
@@ -426,23 +539,45 @@ sub add_inverse_reference {
return $self;
}
-# List::Compare does not keep the order of its arguments (even with unsorted).
-# So we need to re-sort all stops to maintain their original order.
-sub sorted_sublist {
- my ( $self, $list, $sublist ) = @_;
- my %pos;
+# }}}
+# {{{ Public Accessors
- if ( not $sublist or not @{$sublist} ) {
- return;
- }
+sub is_additional {
+ my ($self) = @_;
- for my $i ( 0 .. $#{$list} ) {
- $pos{ $list->[$i] } = $i;
+ if ( $self->{arrival_is_additional} and $self->{departure_is_additional} ) {
+ return 1;
+ }
+ if ( $self->{arrival_is_additional}
+ and not defined $self->{departure_is_additional} )
+ {
+ return 1;
+ }
+ if ( not defined $self->{arrival_is_additional}
+ and $self->{departure_is_additional} )
+ {
+ return 1;
}
+ return 0;
+}
- my @sorted = sort { $pos{$a} <=> $pos{$b} } @{$sublist};
+sub is_cancelled {
+ my ($self) = @_;
- return @sorted;
+ if ( $self->{arrival_is_cancelled} and $self->{departure_is_cancelled} ) {
+ return 1;
+ }
+ if ( $self->{arrival_is_cancelled}
+ and not defined $self->{departure_is_cancelled} )
+ {
+ return 1;
+ }
+ if ( not defined $self->{arrival_is_cancelled}
+ and $self->{departure_is_cancelled} )
+ {
+ return 1;
+ }
+ return 0;
}
sub additional_stops {
@@ -481,37 +616,6 @@ sub classes {
return @classes;
}
-sub merge_with_departure {
- my ( $self, $result ) = @_;
-
- # result must be departure-only
-
- $self->{is_transfer} = 1;
-
- $self->{old_train_id} = $self->{train_id};
- $self->{old_train_no} = $self->{train_no};
-
- # departure is preferred over arrival, so overwrite default values
- $self->{date} = $result->{date};
- $self->{time} = $result->{time};
- $self->{epoch} = $result->{epoch};
- $self->{datetime} = $result->{datetime};
- $self->{train_id} = $result->{train_id};
- $self->{train_no} = $result->{train_no};
-
- $self->{departure} = $result->{departure};
- $self->{departure_wings} = $result->{departure_wings};
- $self->{route_end} = $result->{route_end};
- $self->{route_post} = $result->{route_post};
- $self->{sched_departure} = $result->{sched_departure};
- $self->{sched_route_post} = $result->{sched_route_post};
-
- # update realtime info only if applicable
- $self->{is_cancelled} ||= $result->{is_cancelled};
-
- return $self;
-}
-
sub origin {
my ($self) = @_;
@@ -527,17 +631,23 @@ sub destination {
sub delay_messages {
my ($self) = @_;
- my @keys = reverse sort keys %{ $self->{messages} };
+ my @keys = sort keys %{ $self->{messages} };
my @msgs = grep { $_->[1] eq 'd' } map { $self->{messages}{$_} } @keys;
my @msgids = uniq( map { $_->[2] } @msgs );
my @ret;
for my $id (@msgids) {
- my $msg = firstval { $_->[2] == $id } @msgs;
- push( @ret,
- [ $self->parse_ts( $msg->[0] ), $self->translate_msg($id) ] );
+ for my $superseded ( $self->superseded_messages($id) ) {
+ @ret = grep { not( $_->[2] == $superseded ) } @ret;
+ }
+ my $msg = lastval { $_->[2] == $id } @msgs;
+ push( @ret, $msg );
}
+ @ret = reverse
+ map { [ $self->parse_ts( $_->[0] ), $self->translate_msg( $_->[2] ) ] }
+ @ret;
+
return @ret;
}
@@ -577,23 +687,17 @@ sub replacement_for {
return;
}
-sub dump_message_codes {
- my ($self) = @_;
-
- return %translation;
-}
-
sub qos_messages {
my ($self) = @_;
my @keys = sort keys %{ $self->{messages} };
my @msgs
- = grep { $_->[1] ~~ [qw[f q]] } map { $self->{messages}{$_} } @keys;
+ = grep { $_->[1] =~ m{^[fq]$} } map { $self->{messages}{$_} } @keys;
my @ret;
for my $msg (@msgs) {
- if ( my @superseded = $self->superseded_messages( $msg->[2] ) ) {
- @ret = grep { not( $_->[2] ~~ \@superseded ) } @ret;
+ for my $superseded ( $self->superseded_messages( $msg->[2] ) ) {
+ @ret = grep { not( $_->[2] == $superseded ) } @ret;
}
@ret = grep { $_->[2] != $msg->[2] } @ret;
@@ -654,8 +758,9 @@ sub info {
sub line {
my ($self) = @_;
- return
- sprintf( '%s %s', $self->{type}, $self->{line_no} // $self->{train_no} );
+ return sprintf( '%s %s',
+ $self->{type} // 'Zug',
+ $self->{line_no} // $self->{train_no} // '-' );
}
sub route_pre {
@@ -724,7 +829,7 @@ sub route_interesting {
while ( @via_show < $max_parts and @via_main ) {
my $stop = shift(@via_main);
- if ( $stop ~~ \@via_show or $stop eq $last_stop ) {
+ if ( any { $stop eq $_ } @via_show or $stop eq $last_stop ) {
next;
}
push( @via_show, $stop );
@@ -758,20 +863,6 @@ sub sched_route {
$self->sched_route_post );
}
-sub superseded_messages {
- my ( $self, $msg ) = @_;
-
- my %superseded = (
- 84 => [ 80, 82, 83, 85 ],
- 88 => [ 80, 82, 83, 85, 86, 87, 90, 91, 92, 93, 96, 97, 98 ],
- 89 => [ 86, 87 ],
- 96 => [97],
- 97 => [96],
- );
-
- return @{ $superseded{$msg} // [] };
-}
-
sub translate_msg {
my ( $self, $msg ) = @_;
@@ -782,14 +873,49 @@ sub TO_JSON {
my ($self) = @_;
my %copy = %{$self};
- delete $copy{arrival_wings};
- delete $copy{departure_wings};
- delete $copy{replaced_by};
- delete $copy{replacement_for};
+ delete $copy{realtime_xml};
+ delete $copy{strptime_obj};
+
+ for my $ref_key (
+ qw(arrival_wings departure_wings replaced_by replacement_for))
+ {
+ delete $copy{$ref_key};
+ for my $train_ref ( @{ $self->{$ref_key} // [] } ) {
+ push(
+ @{ $copy{$ref_key} },
+ {
+ raw_id => $train_ref->raw_id,
+ train => $train_ref->train,
+ train_no => $train_ref->train_no,
+ type => $train_ref->type,
+ }
+ );
+ }
+ }
+
+ delete $copy{wing_of};
+ if ( my $train_ref = $self->wing_of ) {
+ $copy{wing_of} = {
+ raw_id => $train_ref->raw_id,
+ train => $train_ref->train,
+ train_no => $train_ref->train_no,
+ type => $train_ref->type,
+ };
+ }
+
+ for my $datetime_key (
+ qw(arrival departure sched_arrival sched_departure start datetime))
+ {
+ if ( defined $copy{$datetime_key} ) {
+ $copy{$datetime_key} = $copy{$datetime_key}->epoch;
+ }
+ }
return {%copy};
}
+# }}}
+
1;
__END__
@@ -813,7 +939,7 @@ arrival/departure received by Travel::Status::DE::IRIS
=head1 VERSION
-version 1.28
+version 1.96
=head1 DESCRIPTION
@@ -844,6 +970,15 @@ Estimated arrival delay in minutes (integer number). undef if no realtime
data is available, the train starts at the specified station, or there is
no scheduled arrival time (e.g. due to diversions). May be negative.
+=item $result->arrival_has_realtime
+
+True if "arrival" is based on real-time data.
+
+=item $result->arrival_hidden
+
+True if arrival should not be displayed to customers.
+This often indicates an entry-only stop near the beginning of a train's journey.
+
=item $result->arrival_is_additional
True if the arrival at this stop is an additional (unscheduled) event, i.e.,
@@ -855,9 +990,9 @@ True if the arrival at this stop has been cancelled.
=item $result->arrival_wings
-Returns a list of references to Travel::Status::DE::IRIS::Result(3pm) objects
-which are coupled to this train on arrival. Returns nothing (false / empty list)
-otherwise.
+Returns a list of weakened references to Travel::Status::DE::IRIS::Result(3pm)
+objects which are coupled to this train on arrival. Returns nothing (false /
+empty list) otherwise.
=item $result->canceled_stops
@@ -913,6 +1048,15 @@ Estimated departure delay in minutes (integer number). undef if no realtime
data is available, the train terminates at the specified station, or there is
no scheduled departure time (e.g. due to diversions). May be negative.
+=item $result->departure_has_realtime
+
+True if "departure" is based on real-time data.
+
+=item $result->departure_hidden
+
+True if departure should not be displayed to customers.
+This often indicates an exit-only stop near the end of a train's journey.
+
=item $result->departure_is_additional
True if the train's departure at this stop is unscheduled (additional), i.e.,
@@ -925,14 +1069,22 @@ terminates here and does not continue its scheduled journey.
=item $result->departure_wings
-Returns a list of references to Travel::Status::DE::IRIS::Result(3pm) objects
-which are coupled to this train on departure. Returns nothing (false / empty
-list) otherwise.
+Returns a list of weakened references to Travel::Status::DE::IRIS::Result(3pm)
+objects which are coupled to this train on departure. Returns nothing (false /
+empty list) otherwise.
=item $result->destination
Alias for route_end.
+=item $result->has_realtime
+
+True if arrival or departure time are based on real-time data. Note that this
+is different from C<< defined($esult->delay) >>. If delay is defined, some kind
+of realtime information for the train is available, but not necessarily its
+arrival/departure time. If has_realtime is true, arrival/departure time are
+available. This behaviour may change in the future.
+
=item $result->info
List of information strings. Contains both reasons for delays (which may or
@@ -1006,7 +1158,7 @@ see also B<is_transfer>.
=item $result->old_train_no
Number of the pre-tarnsfer train, unique per day. E.g. C<< 2225 >> for
-C<< IC 2225 >>. See also B<is_transfer>. Only defined if a transfer took
+C<< IC 2225 >>. Only defined if a transfer took
place, see also B<is_transfer>.
=item $result->origin
@@ -1049,15 +1201,15 @@ This is a developer option. It may be removed without prior warning.
=item $result->replaced_by
-Returns a list of references to Travel::Status::DE::IRIS::Result(3pm) objects
-which replace the (usually cancelled) arrival/departure of this train.
+Returns a list of weakened references to Travel::Status::DE::IRIS::Result(3pm)
+objects which replace the (usually cancelled) arrival/departure of this train.
Returns nothing (false / empty list) otherwise.
=item $result->replacement_for
-Returns a list of references to Travel::Status::DE::IRIS::Result(3pm) objects
-which this (usually unplanned) train is meant to replace.
-Returns nothing (false / empty list) otherwise.
+Returns a list of weakened references to Travel::Status::DE::IRIS::Result(3pm)
+objects which this (usually unplanned) train is meant to replace. Returns
+nothing (false / empty list) otherwise.
=item $result->route
@@ -1093,7 +1245,7 @@ train starts here.
=item $result->sched_departure
-DateTime(3pm) object for the scehduled departure date and time. undef if the
+DateTime(3pm) object for the scheduled departure date and time. undef if the
train ends here.
=item $result->sched_platform
@@ -1128,6 +1280,15 @@ Name of the first station served by this train according to its schedule.
DateTime(3pm) object for the scheduled start of the train on its route
(i.e. the departure time at its first station).
+=item $result->station
+
+Name of the station this train result belongs to.
+
+=item $result->station_eva
+
+EVA number of the station this train result belongs to.
+This is often, but not always, identical with the UIC station number.
+
=item $result->stop_no
Number of this stop on the train's route. 1 if it's the start station, 2
@@ -1158,6 +1319,13 @@ Number of this train, unique per day. E.g. C<< 2225 >> for C<< IC 2225 >>.
Type of this train, e.g. C<< S >> for S-Bahn, C<< RE >> for Regional-Express,
C<< ICE >> for InterCity-Express.
+=item $result->wing_of
+
+If B<is_wing> is true, returns a weakened reference to the
+Travel::Status::DE::IRIS::Result(3pm) object which this train is a wing of. So
+far, it seems that a train is either not a wing or a wing of exactly one other
+train. Returns undef if B<is_wing> is false.
+
=back
=head2 INTERNAL
@@ -1171,263 +1339,6 @@ You usually do not need to call this.
=back
-=head1 MESSAGES
-
-A dump of all messages entered for the result is available. Each message
-consists of a timestamp (when it was entered), a type (d for delay reasons,
-q for other train-related information) and a value (numeric ID).
-
-At the time of this writing, the following messages are known:
-
-=over
-
-=item d 2 : "Polizeiliche Ermittlung"
-
-=item d 3 : "Feuerwehreinsatz neben der Strecke"
-
-=item d 5 : "E<Auml>rztliche Versorgung eines Fahrgastes"
-
-=item d 6 : "BetE<auml>tigen der Notbremse"
-
-Source: Correlation between IRIS and DB RIS (bahn.de).
-
-=item d 7 : "Personen im Gleis"
-
-=item d 8 : "Notarzteinsatz am Gleis"
-
-=item d 9 : "Streikauswirkungen"
-
-=item d 10 : "Ausgebrochene Tiere im Gleis"
-
-=item d 11 : "Unwetter"
-
-=item d 13 : "Pass- und Zollkontrolle"
-
-Source: Correlation between IRIS and DB RIS (bahn.de).
-
-=item d 15 : "BeeintrE<auml>chtigung durch Vandalismus"
-
-=item d 16 : "EntschE<auml>rfung einer Fliegerbombe"
-
-=item d 17 : "BeschE<auml>digung einer BrE<uuml>cke"
-
-=item d 18 : "UmgestE<uuml>rzter Baum im Gleis"
-
-=item d 19 : "Unfall an einem BahnE<uuml>bergang"
-
-=item d 20 : "Tiere im Gleis"
-
-=item d 21 : "Warten auf weitere Reisende"
-
-=item d 22 : "Witterungsbedingte StE<ouml>rung"
-
-=item d 23 : "Feuerwehreinsatz auf BahngelE<auml>nde"
-
-=item d 24 : "VerspE<auml>tung aus dem Ausland"
-
-=item d 25 : "Warten auf verspE<auml>tete Zugteile"
-
-=item d 28 : "GegenstE<auml>nde im Gleis"
-
-=item d 31 : "Bauarbeiten"
-
-=item d 32 : "VerzE<ouml>gerung beim Ein-/Ausstieg"
-
-=item d 33 : "OberleitungsstE<ouml>rung"
-
-=item d 34 : "SignalstE<ouml>rung"
-
-=item d 35 : "Streckensperrung"
-
-=item d 36 : "Technische StE<ouml>rung am Zug"
-
-=item d 37 : "Technische StE<ouml>rung am Wagen"
-
-=item d 38 : "Technische StE<ouml>rung an der Strecke"
-
-=item d 39 : "AnhE<auml>ngen von zusE<auml>tzlichen Wagen"
-
-=item d 40 : "StellwerksstE<ouml>rung/-ausfall"
-
-=item d 41 : "StE<ouml>rung an einem BahnE<uuml>bergang"
-
-=item d 42 : "AuE<szlig>erplanmE<auml>E<szlig>ige GeschwindigkeitsbeschrE<auml>nkung"
-
-=item d 43 : "VerspE<auml>tung eines vorausfahrenden Zuges"
-
-=item d 44 : "Warten auf einen entgegenkommenden Zug"
-
-=item d 45 : "E<Uuml>berholung durch anderen Zug"
-
-=item d 46 : "Warten auf freie Einfahrt"
-
-=item d 47 : "VerspE<auml>tete Bereitstellung"
-
-=item d 48 : "VerspE<auml>tung aus vorheriger Fahrt"
-
-=item d 55 : "Technische StE<ouml>rung an einem anderen Zug"
-
-Source: Correlation between IRIS and DB RIS (bahn.de).
-
-=item d 56 : "Warten auf FahrgE<auml>ste aus einem Bus"
-
-Source: Correlation between IRIS and DB RIS (bahn.de).
-
-=item d 57 : "ZusE<auml>tzlicher Halt"
-
-Source: Correlation between IRIS and DB RIS (bahn.de).
-
-=item d 58 : "Umleitung"
-
-Source: Correlation between IRIS and DB RIS (bahn.de). Several entries, related
-to "Notarzteinsatz am Gleis".
-
-=item d 59 : "Schnee und Eis"
-
-Source: Correlation between IRIS and DB RIS (bahn.de).
-
-=item d 60 : "Reduzierte Geschwindigkeit wegen Sturm"
-
-Source: Correlation between IRIS and DB RIS (bahn.de).
-
-=item d 61 : "TE<uuml>rstE<ouml>rung"
-
-Source: Correlation between IRIS and DB RIS (bahn.de).
-
-=item d 62 : "Behobene technische StE<ouml>rung am Zug"
-
-Source: Correlation between IRIS and DB RIS (bahn.de).
-
-=item d 63 : "Technische Untersuchung am Zug"
-
-=item d 64 : "WeichenstE<ouml>rung"
-
-Source: correlation between IRIS and DB RIS (bahn.de).
-
-=item d 65 : "Erdrutsch"
-
-Source: correlation between IRIS and DB RIS (bahn.de).
-
-=item d 66 : "Hochwasser"
-
-Source: correlation between IRIS and DB RIS (bahn.de).
-
-=item q 70 : "Kein WLAN"
-
-Source: correlation between IRIS and DB RIS (bahn.de).
-
-=item q 71 : "WLAN in einzelnen Wagen nicht verfE<uuml>gbar"
-
-=item q 73 : "Mehrzweckabteil vorne"
-
-Source: correlation between IRIS and DB RIS (bahn.de).
-
-=item q 74 : "Mehrzweckabteil hinten"
-
-Source: correlation between IRIS and DB RIS (bahn.de).
-
-=item q 75 : "1. Klasse vorne"
-
-Source: correlation between IRIS and DB RIS (bahn.de).
-
-=item q 76 : "1. Klasse hinten"
-
-Source: correlation between IRIS and DB RIS (bahn.de).
-
-=item q 77 : "Ohne 1. Klasse"
-
-Source: correlation between IRIS and DB RIS (bahn.de).
-
-=item q 79 : "Ohne Mehrzweckabteil"
-
-Source: correlation between IRIS and DB RIS (bahn.de).
-
-=item q 80 : "Abweichende Wagenreihung"
-
-Verified by L<https://iris.noncd.db.de/irisWebclient/Configuration>.
-
-=item q 82 : "Mehrere Wagen fehlen"
-
-Verified by L<https://iris.noncd.db.de/irisWebclient/Configuration>.
-
-=item q 83 : "Fehlender Zugteil"
-
-Verified by L<https://iris.noncd.db.de/irisWebclient/Configuration>.
-
-=item q 84 : "Zug verkehrt richtig gereiht"
-
-Obsoletes messages 80, 82, 83, 85.
-Verified by L<https://iris.noncd.db.de/irisWebclient/Configuration>.
-
-=item q 85 : "Ein Wagen fehlt"
-
-Verified by L<https://iris.noncd.db.de/irisWebclient/Configuration>.
-
-=item q 86 : "Keine Reservierungsanzeige"
-
-Verified by L<https://iris.noncd.db.de/irisWebclient/Configuration>.
-
-=item q 87 : "Einzelne Wagen ohne Reservierungsanzeige"
-
-Verified by L<https://iris.noncd.db.de/irisWebclient/Configuration>.
-
-=item q 88 : "Keine QualitE<auml>tsmE<auml>ngel"
-
-Obsoletes messages 80, 82, 83, 85, 86, 87, 90, 91, 92, 93, 96, 97, 98.
-Verified by L<https://iris.noncd.db.de/irisWebclient/Configuration>.
-
-=item q 89 : "Reservierungen sind wieder vorhanden"
-
-Obsoletes messages 86, 87.
-Verified by L<https://iris.noncd.db.de/irisWebclient/Configuration>.
-
-=item q 90 : "Kein Bordrestaurant/Bordbistro"
-
-Verified by L<https://iris.noncd.db.de/irisWebclient/Configuration>.
-
-=item q 91 : "EingeschrE<auml>nkte Fahrradmitnahme"
-
-Verified by L<https://iris.noncd.db.de/irisWebclient/Configuration>.
-
-Might also mean "Keine Fahrradmitnahme" (source: frubi).
-
-=item q 92 : "Klimaanlage in einzelnen Wagen ausgefallen"
-
-Verified by L<https://iris.noncd.db.de/irisWebclient/Configuration>.
-
-Might also mean "Rollstuhlgerechtes WC in einem Wagen ausgefallen"
-(source: frubi).
-
-=item q 93 : "Fehlende oder gestE<ouml>rte behindertengerechte Einrichtung"
-
-Verified by L<https://iris.noncd.db.de/irisWebclient/Configuration>.
-Might also mean "Kein rollstuhlgerechtes WC" (source: frubi).
-
-=item q 94 : "Ersatzbewirtschaftung"
-
-Estimated from a comparison with bahn.de/ris messages. Needs to be verified.
-
-=item q 95 : "Ohne behindertengerechtes WC"
-
-Estimated from a comparison with bahn.de/iris messages.
-
-=item q 96 : "Der Zug ist stark E<uuml>berbesetzt"
-
-Verified by L<https://iris.noncd.db.de/irisWebclient/Configuration>.
-
-=item q 97 : "Der Zug ist E<uuml>berbesetzt"
-
-Verified by L<https://iris.noncd.db.de/irisWebclient/Configuration>.
-
-=item q 98 : "Sonstige QualitE<auml>tsmE<auml>ngel"
-
-Verified by L<https://iris.noncd.db.de/irisWebclient/Configuration>.
-Might also mean "Kein rollstuhlgerechter Wagen" (source: frubi).
-
-=item d 99 : "VerzE<ouml>gerungen im Betriebsablauf"
-
-=back
-
=head1 DIAGNOSTICS
None.
@@ -1450,7 +1361,7 @@ Travel::Status::DE::IRIS(3pm).
=head1 AUTHOR
-Copyright (C) 2013-2019 by Daniel Friesel E<lt>derf@finalrewind.orgE<gt>
+Copyright (C) 2013-2024 by Birte Kristina Friesel E<lt>derf@finalrewind.orgE<gt>
=head1 LICENSE