Net::GPSD::Point(3) User Contributed Perl Documentation Net::GPSD::Point(3)NAMENet::GPSD::Point - Provides an object interface for a gps point.
SYNOPSIS
use Net::GPSD;
$obj=Net::GPSD->new(host=>"localhost",
port=>"2947");
my $point=$obj->get; #$point is a Net::GPSD::Point object
print $point->latlon. "\n"; #use a "." here to force latlon to a scalar
or to use Net::GPSD::Point objects in you own code.
use Net::GPSD::Point;
my $point=Net::GPSD::Point->new();
$point->lat(39.5432524);
$point->lon(-77.243532);
print $point->latlon. "\n";
DESCRIPTIONCONSTRUCTOR
new
my $point=Net::GPSD::Point->new();
METHODS
initialize
fix
Returns true if mode is fixed (logic based on the gpsd M[0] or O[14])
my $fix=$point->fix;
status
Returns DGPS status. (maps to gpsd S command first data element)
my $status=$point->status;
datetime
Returns datetime. (maps to gpsd D command first data element)
my $datetime=$point->datetime;
tag
Returns a tag identifying the last sentence received. (maps to gpsd O
command first data element)
my $tag=$point->tag;
time
Returns seconds since the Unix epoch, UTC. May have a fractional part.
(maps to gpsd O command second data element)
my $time=$point->time;
errortime
Returns estimated timestamp error (%f, seconds, 95% confidence). (maps
to gpsd O command third data element)
my $errortime=$point->errortime;
latitude aka lat
Returns Latitude as in the P report (%f, degrees). (maps to gpsd O
command fourth data element)
my $lat=$point->lat;
my $lat=$point->latitude;
longitude aka lon
Returns Longitude as in the P report (%f, degrees). (maps to gpsd O
command fifth data element)
my $lon=$point->lon;
my $lon=$point->longitude;
latlon
Returns Latitude, Longitude as an array in array context and as a space
joined string in scalar context
my @latlon=$point->latlon;
my $latlon=$point->latlon;
altitude aka alt
Returns the current altitude, meters above mean sea level. (maps to
gpsd O command sixth data element)
my $alt=$point->alt;
my $alt=$point->altitude;
errorhorizontal
Returns Horizontal error estimate as in the E report (%f, meters).
(maps to gpsd O command seventh data element)
my $errorhorizontal=$point->errorhorizontal;
errorvertical
Returns Vertical error estimate as in the E report (%f, meters). (maps
to gpsd O command eighth data element)
my $errorvertical=$point->errorvertical;
heading
Returns Track as in the T report (%f, degrees). (maps to gpsd O command
ninth data element)
my $heading=$point->heading;
speed
Returns speed (%f, meters/sec). Note: older versions of the O command
reported this field in knots. (maps to gpsd O command tenth data
element)
my $speed=$point->speed;
speed_knots
Returns speed in knots
my $speed=$point->speed_knots;
climb
Returns Vertical velocity as in the U report (%f, meters/sec). (maps to
gpsd O command 11th data element)
my $climb=$point->climb;
errorheading
Returns Error estimate for course (%f, degrees, 95% confidence). (maps
to gpsd O command 12th data element)
my $errorheading=$point->errorheading;
errorspeed
Returns Error estimate for speed (%f, meters/sec, 95% confidence).
Note: older versions of the O command reported this field in knots.
(maps to gpsd O command 13th data element)
my $errorspeed=$point->errorspeed;
errorclimb
Returns Estimated error for climb/sink (%f, meters/sec, 95%
confidence). (maps to gpsd O command 14th data element)
my $errorclimb=$point->errorclimb;
mode
Returns The NMEA mode. 0=no mode value yet seen, 1=no fix, 2=2D (no
altitude), 3=3D (with altitude). (maps to gpsd M command first data
element)
my $mode=$point->mode;
q2u
LIMITATIONS
The object allows users to set values for each method but, most likely,
this is not what most users will want.
SUPPORT
DavisNetworks.com supports all Perl applications including this
package.
BUGS
Email to author and submit to RT.
EXAMPLESAUTHOR
Michael R. Davis, qw/gpsd michaelrdavis com/
LICENSE
Copyright (c) 2006 Michael R. Davis (mrdvt92)
This library is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
SEE ALSO
Geo::Point, Net::GPSD
perl v5.14.1 2010-06-02 Net::GPSD::Point(3)