From a21b5f265bcae478ff5aaecfbecd1f13b7611e69 Mon Sep 17 00:00:00 2001 From: Daniel Friesel Date: Sat, 4 Jan 2014 18:08:12 +0100 Subject: Document ::Result accessors --- lib/Travel/Status/DE/IRIS/Result.pm | 141 ++++++++++++++++++++++++++++++++---- 1 file changed, 128 insertions(+), 13 deletions(-) (limited to 'lib') diff --git a/lib/Travel/Status/DE/IRIS/Result.pm b/lib/Travel/Status/DE/IRIS/Result.pm index 02be344..01b2646 100644 --- a/lib/Travel/Status/DE/IRIS/Result.pm +++ b/lib/Travel/Status/DE/IRIS/Result.pm @@ -356,45 +356,160 @@ the platform, time, route and more. =over -=item $result->arrival_date +=item $result->arrival -=item $result->arrival_datetime - -=item $result->arrival_time +DateTime(3pm) object for the arrival date and time. undef if the +train starts here. Contains realtime data if available. =item $result->date +Scheduled departure date if available, arrival date otherwise (e.g. if the +train ends here). String in dd.mm.YYYY format. Does not contain realtime data. + =item $result->datetime -=item $result->departure_date +DateTime(3pm) object for departure if available, arrival otherwise. Does not +contain realtime data. + +=item $result->delay + +Estimated delay in minutes (integer number). undef when no realtime data is +available, negative if a train ends at the specified station and arrives / +arrived early. + +=item $result->departure + +DateTime(3pm) object for the departure date and time. undef if the train ends +here. Contains realtime data if available. + +=item $result->destination + +Aleas for route_end. + +=item $result->info + +List of information strings. Contains both reasons for delays (which may or +may not be up-to-date) and generic information such as missing carriages or +broken toilets. + +=item $result->is_cancelled + +True if the train was cancelled, false otherwise. Note that this does not +contain information about replacement trains or route diversions. -=item $result->departure_datetime +=item $result->line -=item $result->departure_time +Train type with line (such as C<< S 1 >>) if available, type with number +(suc as C<< RE 10126 >>) otherwise. =item $result->line_no +Number of the line, undef if unknown. Seems to be set only for S-Bahn and +similar trains. Regional and long-distance trains such as C<< RE 10126 >> +usually do not have this field set, even if they have a common line number +(C<< RE 1 >> in this case). + +Example: For the line C<< S 1 >>, line_no will return C<< 1 >>. + +=item $result->origin + +Alias for route_start. + +=item $result->platform + +Arrivel/departure platform as string, undef if unknown. Note that this is +not neccessarily a number, platform sections may be included (e.g. +C<< 3a/b >>). + =item $result->raw_id -=item $result->start_date +Raw ID of the departure, e.g. C<< -4642102742373784975-1401031322-6 >>. +The first part appears to be this train's UUID (can be tracked across +multiple stations), the second the YYmmddHHMM departure timestamp at its +start station, and the third the count of this station in the train's schedule +(in this case, it's the sixth from thestart station). + +About half of all departure IDs do not contain the leading minus (C<< - >>) +seen in this example. The reason for this is unknown. + +This is a developer option. It may be removed without prior warning. + +=item $result->realtime_xml + +XML::LibXML::Node(3pm) object containing all realtime data. undef if none is +available. + +This is a developer option. It may be removed without prior warning. -=item $result->start_datetime +=item $result->route -=item $result->start_time +List of all stations served by this train, according to its schedule. Does +not contain realtime data. + +=item $result->route_end + +Name of the last station served by this train according to its schedule. + +=item $result->route_interesting + +List of up to three "interesting" stations served by this train, subset of +route_post. Usually contains the next stop and one or two major stations after +that. + +=item $result->route_pre + +List of station names the train is scheduled to pass before this stop. + +=item $result->route_post + +List of station names the train is scheduled to pass after this stop. + +=item $result->route_start + +Name of the first station served by this train according to its schedule. + +=item $result->sched_arrival + +DateTime(3pm) object for the scheduled arrival date and time. undef if the +train starts here. + +=item $result->sched_departure + +DateTime(3pm) object for the scehduled departure date and time. undef if the +train ends here. + +=item $result->start + +DateTime(3pm) object for the scheduled start of the train on its route +(i.e. the departure time at its first station). =item $result->stop_no +Number of this stop on the train's route. 1 if it's the start station, 2 +for the stop after that, and so on. + =item $result->time +Scheduled departure time if available, arrival time otherwise (e.g. if the +train ends here). String in HH:MM format. Does not contain realtime data. + +=item $result->train + +Alias for line. + =item $result->train_id +Numeric ID of this train. Seems to be unique for a year and trackable across +stations. + =item $result->train_no -=item $result->type +Number of this train, unique per day. E.g. C<< 2225 >> for C<< IC 2225 >>. -=item $result->unknown_t +=item $result->type -=item $result->unknown_o +Type of this train, e.g. C<< S >> for S-Bahn, C<< RE >> for Regional-Express, +C<< ICE >> for InterCity-Express. =back -- cgit v1.2.3