NAME

Map::Tube::KoelnBonn - Interface to the Koeln-Bonn U- and S-Bahn and tram maps

SYNOPSIS

    use Map::Tube::KoelnBonn;
    my $tube = Map::Tube::KoelnBonn->new();

    my $route = $tube->get_shortest_route('Wurzerstr.', 'Plittersdorf');

    print "Route: $route\n";

DESCRIPTION

This module allows to find the shortest route between any two given tube stations in Köln and Bonn. In fact, underground, tramway, and S-Bahn lines are covered for the wider Köln-Bonn area (VRS). All interesting methods are provided by the role Map::Tube.

METHODS

CONSTRUCTOR

    use Map::Tube::KoelnBonn;
    my $tube = Map::Tube::KoelnBonn->new();

The only argument, xml, is optional; if specified, it should be a code ref to a function that returns either the path the XML map file, or a string containing this XML content. The default is the path to koelnbonn-map.xml that is a part of this distribution. For further information see Map::Tube.

xml()

This read-only accessor returns whatever was specified as the XML source at construction.

ERRORS

If something goes wrong, maybe because the map information file was corrupted, the constructor will die.

AUTHOR

Gisbert W. Selke, TapirSoft Selke & Selke GbR <gws@cpan.org>

COPYRIGHT AND LICENCE

The data for the XML file were mainly taken from the appropriate OpenStreetMap maps. They are CC BY-SA 2.0, with some modifications made based on personal knowledge, in particular in order to disambiguate station names. The module itself is free software; you may redistribute and/or modify it under the same terms as Perl itself.

SEE ALSO

Map::Tube, Map::Tube::GraphViz.