summaryrefslogtreecommitdiff
path: root/lib/Travel
diff options
context:
space:
mode:
authorDaniel Friesel <derf@finalrewind.org>2011-11-20 09:29:09 +0100
committerDaniel Friesel <derf@finalrewind.org>2011-11-20 09:29:09 +0100
commita32aaf5392f222c120e00eb556897d435993c8e2 (patch)
tree6eb61615cdeb992d85d13aecf5c76b9a6ecb3322 /lib/Travel
parenteff310b0e6f9e3e0aec21df3de41778b8b163f70 (diff)
Update ::Result documentation
Diffstat (limited to 'lib/Travel')
-rw-r--r--lib/Travel/Status/DE/VRR/Result.pm69
1 files changed, 50 insertions, 19 deletions
diff --git a/lib/Travel/Status/DE/VRR/Result.pm b/lib/Travel/Status/DE/VRR/Result.pm
index fb67e0a..f65cfb1 100644
--- a/lib/Travel/Status/DE/VRR/Result.pm
+++ b/lib/Travel/Status/DE/VRR/Result.pm
@@ -53,11 +53,31 @@ line number and destination.
=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 $departure->countdown
+
+Actual time in minutes from now until the tram/bus/train will depart.
+
+If delay information is available, it is already included.
+
+=item $departure->date
+
+Actual departure date (DD.MM.YYYY).
+
+=item $departure->delay
+
+Expected delay from scheduled departure time in minutes.
+
+Note that this is only available for DB trains, in other cases it will always
+return 0.
+
=item $departure->destination
-The tram/bus/train destination.
+Destination name.
=item $departure->info
@@ -69,40 +89,51 @@ news related to the line's schedule.
The name/number of the line.
-=item $departure->platform
+=item $departure->lineref
-The departure platform. Note that this is prefixed by either "Bstg." (for
-tram/bus departures) or "Gleis" (for trains).
+Travel::Status::DE::VRR::Line(3pm) object describing the departing line in
+detail.
-=item $departure->time
+=item $departure->platform
-The departure time as string in "HH:MM" format.
+Departure platform number.
-=back
+=item $departure->platform_db
-=head2 INTERNAL
+true if the platform number is operated by DB ("Gleis x"), false ("Bstg. x")
+otherwise.
-=over
+Unfortunately, there is no distinction between tram and bus platforms yet,
+which also may have the same numbers.
-=item $departure = Travel::Status::DE::VRR::Result->new(I<%data>)
+=item $departure->sched_date
-Returns a new Travel::Status::DE::VRR::Result object. You should not need to
-call this.
+Scheduled departure date (DD.MM.YYYY).
-Required I<data>:
+=item $departure->sched_time
-=over
+Scheduled departure time (HH:MM).
-=item B<destination> => I<string>
+=item $departure->time
-=item B<line> => I<string>
+Actual departure time (HH:MM).
-=item B<platform> => I<string>
+=item $departure->type
-=item B<time> => I<string>
+Type of the departing train, values observed so far are "StraE<szlig>enbahn",
+"Bus", "NE", "S-Bahn" and "U-Bahn".
=back
+=head2 INTERNAL
+
+=over
+
+=item $departure = Travel::Status::DE::VRR::Result->new(I<%data>)
+
+Returns a new Travel::Status::DE::VRR::Result object. You should not need to
+call this.
+
=back
=head1 DIAGNOSTICS
@@ -119,7 +150,7 @@ None.
=head1 BUGS AND LIMITATIONS
-Unknown.
+Not all possible B<type> values are documented yet.
=head1 SEE ALSO