1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
|
package Travel::Routing::DE::EFA::Route::Part;
use strict;
use warnings;
use 5.010;
use parent 'Class::Accessor';
our $VERSION = '2.06';
Travel::Routing::DE::EFA::Route::Part->mk_ro_accessors(
qw(arrival_platform arrival_stop
arrival_date arrival_time arrival_sdate arrival_stime delay
departure_platform
departure_stop departure_date departure_time departure_sdate
departure_stime train_line train_destination
)
);
sub new {
my ( $obj, %conf ) = @_;
my $ref = \%conf;
return bless( $ref, $obj );
}
sub arrival_routemaps {
my ($self) = @_;
return @{ $self->{arrival_routemaps} };
}
sub arrival_stationmaps {
my ($self) = @_;
return @{ $self->{arrival_stationmaps} };
}
sub arrival_stop_and_platform {
my ($self) = @_;
if ( length( $self->arrival_platform ) ) {
return
sprintf( '%s: %s', $self->get(qw(arrival_stop arrival_platform)) );
}
return $self->arrival_stop;
}
sub departure_routemaps {
my ($self) = @_;
return @{ $self->{departure_routemaps} };
}
sub departure_stationmaps {
my ($self) = @_;
return @{ $self->{departure_stationmaps} };
}
sub departure_stop_and_platform {
my ($self) = @_;
if ( length( $self->departure_platform ) ) {
return
sprintf( '%s: %s',
$self->get(qw(departure_stop departure_platform)) );
}
return $self->departure_stop;
}
sub extra {
my ($self) = @_;
return @{ $self->{extra} // [] };
}
sub via {
my ($self) = @_;
return @{ $self->{via} // [] };
}
1;
__END__
=head1 NAME
Travel::Routing::DE::EFA::Route::Part - Describes one connection between two
points, without interchanges
=head1 SYNOPSIS
for my $part ( $route->parts ) {
if ( $part->extra ) {
say join( "\n", $part->extra );
}
printf(
"%s at %s -> %s at %s, via %s to %s",
$part->departure_time, $part->departure_stop,
$part->arrival_time, $part->arrival_stop,
$part->train_line, $part->train_destination,
);
}
=head1 VERSION
version 2.06
=head1 DESCRIPTION
B<Travel::Routing::DE::EFA::Route::Part> holds one specific connection (without
interchanges) between two points. It specifies the start/stop point and time,
the train line and its destination, and optional additional data.
It is usually obtained by a call to Travel::Routing::DE::EFA::Route(3pm)'s
B<parts> method.
=head1 METHODS
=head2 ACCESSORS
"Actual" in the description means that the delay (if available) is already
included in the calculation, "Scheduled" means it isn't.
=over
=item $part->arrival_stop
arrival stop (city name plus station name)
=item $part->arrival_platform
arrival platform (either "Gleis x" or "Bstg. x")
=item $part->arrival_stop_and_platform
"stop: platform" concatenation
=item $part->arrival_date
Actual arrival date in DD.MM.YYYY format
=item $part->arrival_time
Actual arrival time in HH:MM format
=item $part->arrival_sdate
Scheduled arrival date in DD.MM.YYYY format
=item $part->arrival_stime
Scheduled arrival time in HH:MM format
=item $part->arrival_routemaps
List of URLs, may be empty. Each URL poinst to a transfer map for the arrival
station, usually outlining fow to transfer from this train to the next one
(if applicable).
=item $part->arrival_stationmaps
List of URLs, may be empty. Each URL points to an HTML map of the arrival
station.
=item $part->delay
delay in minutes, 0 if unknown
=item $part->departure_stop
departure stop (city name plus station name)
=item $part->departure_platform
departure platform (either "Gleis x" or "Bstg. x")
=item $part->departure_stop_and_platform
"stop: platform" concatenation
=item $part->departure_date
Actual departure date in DD.MM.YYYY format
=item $part->departure_time
Actual departure time in HH:MM format
=item $part->departure_sdate
Scheduled departure date in DD.MM.YYYY format
=item $part->departure_stime
Scheduled departure time in HH:MM format
=item $part->departure_routemaps
List of URLs, may be empty. Each URL points to a PDF a transfer map for the
departure station, usually outlining fow to transfer from thep previous train
(if applicable) to this one.
=item $part->departure_stationmaps
List of URLs, may be empty. Each URL poinst to an HTML map of the departure
station.
=item $part->extra
Additional information about the connection. Returns a list of
newline-terminated strings
=item $part->train_destination
destination of the line providing the connection
=item $part->train_line
name / number of the line
=item $part->via
List of stops passed between departure_stop and arrival_stop, as
C<< [ "DD.MM.YYYY", "HH:MM", stop, platform ] >> hashrefs.
May be empty, these are not always reported by efa.vrr.de.
=back
=head1 DIAGNOSTICS
None.
=head1 DEPENDENCIES
=over
=item * Class::Accessor(3pm)
=back
=head1 BUGS AND LIMITATIONS
$part->via does not work reliably.
=head1 SEE ALSO
Travel::Routing::DE::EFA(3pm), Class::Accessor(3pm).
=head1 AUTHOR
Copyright (C) 2011-2014 by Daniel Friesel E<lt>derf@finalrewind.orgE<gt>
=head1 LICENSE
0. You just DO WHAT THE FUCK YOU WANT TO.
|
