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.