1GeoDB(3)              User Contributed Perl Documentation             GeoDB(3)
2
3
4

NAME

6       GeoDB - Geographical waypoint database manipulation
7

SYNOPSIS

9         my $geodb = new GeoDB();
10         $geodb->init_dbh('sqlite2','mysqlitedb','localhost',
11                          'dbuser','dbpassword', '9999');
12
13         setup_db(); # XXX: currently this exists only in geoqo and needs to be moved
14
15         $geodb->update_db('sqlite2');  # update to current db schema.
16
17         # import a bunch of waypoints from a gpx file
18         $geodb->import_it('myfile.gpx');
19
20         # Extremely complex searches are available:
21         #   (this loads a 'waypoint' and 'cache' module and passes the
22         #   associated search parameters to them)
23         my $resultset = $geodb->search('waypoint:type=Geocache&&cache:terrain>2');
24
25         # modify the data
26         #   (in this case, it calculates a distance from GCABCD and stores
27         #   it in the distance data node)
28         $geodb->modify($resultset, 'distance:from=GCABCD');
29
30         # tag the waypoints as "cool"
31         $geodb->modify($resultset, 'tag:cool');
32
33         # search by tag:
34         my $newsearchset = $geodb->search('tag:cool');
35
36         # display the results in a list:
37         $geodb->display($newsearchset, 'list:');
38
39         # display with particular list format
40         $geodb->display($newsearchset,
41                         'list:format=%{8:ident} %{6:subtype} %{40:urlname}');
42
43         # export the results to a file:
44         $geodb->export_it(['myextract.gpx', 'mylocfile.loc'], $newsearchset);
45
46         # finally it has it's own scripting language as well:
47         # (see the geoqo manual page for how to write scripts)
48         $geodb->run_script('file:myscript','arg1=foo,arg2=42');
49

DESCRIPTION

51       The GeoDB perl module is the foundation for the geoqo application.  It
52       is designed to load, query, modify, search for, etc geographical
53       waypoints within an SQL database.  The GeoDB module is the very top
54       module of a hierarchy of supporting modules needed.  The GeoDB module
55       itself can serve as the primary interface to most of those other
56       modules, however.
57
58       For complete details on the geoqo application and this module, please
59       refer to the geoqo web site:
60
61         http://www.geoqo.org/
62

MODULE INTERFACE

64       The GeoDB system is very extensible and new Display, Export, Import,
65       Modify, Search, and Waypoint types can be easily added to the system.
66       For details on writing plugins, see the documentation for
67       GeoDB::Display, ...
68

SEE ALSO

70       geoqo(1) -- this is a MUCH MUCH more extensive manual on the power of
71       the system
72

AUTHOR

74       Wes Hardaker AKA Yamar <yamar@geoqo.org>
75

77       GPLv2
78
79
80
81perl v5.10.0                      2009-11-10                          GeoDB(3)
Impressum