NAME
Map::Tube::Brussels - Interface to the Brussels tube map
SYNOPSIS
use Map::Tube::Brussels;
my $tube_nl = Map::Tube::Brussels->new( nametype => 'alt' );
my $route_nl = $tube_nl->get_shortest_route('Delacroix', 'Zuidstation')->preferred( );
print "Route: $route_nl\n";
my $tube_fr = Map::Tube::Brussels->new( );
my $route_fr = $tube_fr->get_shortest_route('Delacroix', 'Gare du Midi')->preferred( );
print "Route: $route_fr\n";DESCRIPTION
This module allows to find the shortest route between any two given tube stations in Brussels. All interesting methods are provided by the role Map::Tube.
METHODS
CONSTRUCTOR
use Map::Tube::Brussels;
my $tube_fr = Map::Tube::Brussels->new( );
my $tube_nl = Map::Tube::Brussels->new( nametype => 'alt' );This will read the tube information from the shared file brussels-map.xml, which is part of the distribution. Without argument, French-language place names will be used. With the value 'alt' for nametype, Dutch-language place names will be used. Other values will throw an error.
nametype( )
This yields the nametype that was specified with the constructor call, or '' if none.
xml( )
This read-only accessor returns whatever was specified as the XML source at construction.
MAP DATA FORMAT
The data format for Map::Tube instances is described in the documentation for Map::Tube. The Brussels map, however, comes either with station and line names in the French language (spoken in Wallonia) or in the Dutch language (spoken in Flanders). All line and station tags have the French name in the name attribute. For tags where two names differ there is an additional name_alt attribute having the Dutch name. When reading the map data and no nametype is given, all the name_alt attributes are deleted, so that the Map::Tube software sees only a standard data structure. However, if nametype=alt was specified when instantiating Map::Data::Brussels, the name_alt attributes will be copied into the name atributes, and, again, the name_alt attributes themselves are removed.
ERRORS
If something goes wrong, maybe because the map information file was corrupted, the constructor will die.
Some sources have a slightly different view on which stations exist on which lines. While the differences are few, they should be resolved by direct evidence. Hints are welcome.
AUTHOR
Gisbert W. Selke, TapirSoft Selke & Selke GbR.
COPYRIGHT AND LICENCE
The data for the XML file were mainly taken from the appropriate French and Dutch Wikipedia pages. They are CC BY-SA 2.0. For additional verification and names, openstreetmap.org was consulted. The module itself is free software; you may redistribute and/or modify it under the same terms as Perl itself.