Take me over?
NAME
Net::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 scalaror 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";DESCRIPTION
CONSTRUCTOR
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.
EXAMPLES
AUTHOR
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.