NAME Map::Tube::Samara - Interface to the Samara Metro Map. SYNOPSIS use Map::Tube::Samara; my $obj = Map::Tube::Samara->new; my $routes_ar = $obj->get_all_routes($from, $to); my $station = $obj->get_node_by_id($station_id); my $station = $obj->get_node_by_name($station_name); my $route = $obj->get_shortest_route($from, $to); my $metro_name = $obj->name; my $xml_file = $obj->xml; DESCRIPTION It currently provides functionality to find the shortest route between the two given nodes. For more information about Samara Map, click here . METHODS "new()" Constructor. "get_all_routes($from, $to)" [EXPERIMENTAL] Get all routes from station to station. Returns reference to array with Map::Tube::Route objects. "get_node_by_id($station_id)" Get station node by id. Returns Map::Tube::Node object. "get_node_by_name($station_name)" Get station node by name. Returns Map::Tube::Node object. "get_shortest_route($from, $to)" Get shortest route between $from and $to node names. Node names in $from and $to are case insensitive. Returns Map::Tube::Route object. "name()" Get metro name. Returns string with metro name. "xml()" Get XML specification of Samara metro. Returns string with XML. EXAMPLE1 # Pragmas. use strict; use warnings; # Modules. use Encode qw(decode_utf8 encode_utf8); use Map::Tube::Samara; # Object. my $obj = Map::Tube::Samara->new; # Get route. my $route = $obj->get_shortest_route(decode_utf8('Гагаринская'), decode_utf8('Безымянка')); # Print out type. print "Route: ".encode_utf8($route)."\n"; # Output: # Route: Гагаринская (Первая линия), Спортивная (Первая линия), Советская (Первая линия), Победа (Первая линия), Безымянка (Первая линия) EXAMPLE2 # Pragmas. use strict; use utf8; use warnings; # Modules. use Map::Tube::Samara; # Object. my $obj = Map::Tube::Samara->new; # Get XML file. my $xml_file = $obj->xml; # Print out XML file. print "XML file: $xml_file\n"; # Output like: # XML file: .*/samara-map.xml DEPENDENCIES File::Share, Map::Tube, Moo, namespace::clean. SEE ALSO Map::Tube, Map::Tube::Barcelona, Map::Tube::Berlin, Map::Tube::Delhi, Map::Tube::London, Map::Tube::Kiev, Map::Tube::Minsk, Map::Tube::Moscow, Map::Tube::NYC, Map::Tube::Prague, Map::Tube::Sofia, Map::Tube::Tokyo, Map::Tube::Warsaw. REPOSITORY AUTHOR Michal Špaček LICENSE AND COPYRIGHT © 2014 Michal Špaček Artistic License BSD 2-Clause License VERSION 0.01