NAME

GPS::Poi - Perl extension for 'ov2' file extension of POI (Point of Interrest ) for tomtom GPS

SYNOPSIS

      use GPS::Poi;
      my $poi = GPS::Poi->new();
      my $nb = $poi->parse({file => 'myfile.ov2' });
      my  @list = $poi->all_as_list();
      my  $dump = $poi->dump_list();
      print $dump;

DESCRIPTION

GPS::Poi is a Perl module who provides a variety of low- and high-level methods for parsing 'ov2' extention file of POI (Point of Interrest ). 'ov2' is Tomtom GPS format . Tomtom is trade mark .

METHODS
new [ ({file =>/myfile.ov2}) ]

The file paremters is optional

parse [ ({file =>/myfile.ov2}) ]

      The file paremters is optional ONLY if it was already supplied with new method.
      This method return the number of file record or 0 if error.

all_as_list

      Return array of each record in the same order of file.
      Each item is like this : (Label,long,lat,code)   

dump_list

Return a string who can be printable : eg

000002.394520 Lg - 000048.818100 Lt - Ivry sur Seine - 2 000002.394200 Lg - 000048.825190 Lt - Bercy - 2 000002.345520 Lg - 000048.784400 Lt - Hay les Roses - 2

clear_list

Clear the current list.

TODO

This module can only read ov2 file , I must add write,merge methods. Add implementation of type 3 record

SEE ALSO

tomtom.com
try ./test.pl demo.ov2 in 'eg' directory

AUTHOR

Eric GERMAN, <germanlinux@yahoo.fr>

COPYRIGHT AND LICENSE

Copyright (C) 2006 by Eric German

This package is under the GNU General Public License, Version 2.

        This program is free software; you can redistribute it and/or modify
        it under the terms of the GNU General Public License as published by
        the Free Software Foundation; version 2 dated June, 1991.

        This program is distributed in the hope that it will be useful,
        but WITHOUT ANY WARRANTY; without even the implied warranty of
        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
        GNU General Public License for more details.

        A copy of the GNU General Public License is available in the source tree;
        if not, write to the Free Software Foundation, Inc.,
        59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.