Net::GPSD3::Return::TPV: Net::gpsd3 return tpv object

SYNOPSIS

  printf "Time: %s, Lat: %s, Lon: %s\n", $object->time, $object->lat, $object->lon;

DESCRIPTION

Provides a Perl object interface to the Time-Velocity-Position (\s-1TVP\s0) object returned by the \s-1GPSD\s0 daemon.

Example \s-1JSON\s0 objects:

Protocol 3.1 Versions

{ "class":"TPV", "tag":"MID2", "device":"/dev/ttyUSB0", "time":1253593085.470, "ept":0.005, "lat":38.88945123, "lon":-77.03522143, "track":171.7249, "speed":0.467, "mode":2 }

{ "class":"TPV", "tag":"MID2", "device":"/dev/ttyUSB0", "time":1253593667.430, "ept":0.005, "lat":38.88945123, "lon":-77.03522143, "alt":146.911, "track":180.0000, "speed":0.194, "climb":-0.157, "mode":3 }

Protocol 3.4 Version

{ "class":"TPV", "tag":"0x0106", "device":"/dev/cuaU0", "time":"2011-03-20T06:51:59.12Z", "ept":0.005, "lat":37.371427205, "lon":-122.015179890, "alt":25.789, "epx":1.926, "epy":1.808, "epv":6.497, "track":0.0000, "speed":0.000, "climb":0.000, "eps":3.85, "mode":3 }

METHODS PROPERTIES

class

Returns the object class

string

Returns the \s-1JSON\s0 string

parent

Return the parent Net::GPSD object

device

Name of originating device.

tag

Type tag associated with this \s-1GPS\s0 sentence; from an \s-1NMEA\s0 device this is just the \s-1NMEA\s0 sentence type.

mode

\s-1NMEA\s0 mode: %d, 0=no mode value yet seen, 1=no fix, 2=2D, 3=3D.

time

Seconds since the Unix epoch, \s-1UTC\s0. The value may have a fractional part of up to .01sec precision.

Note: In 2.96 (protocol 3.4) the \s-1TPV-\s0>time format changed from unix epoch to W3C, but this method hides that from the user.

timestamp

W3C formated timestamp value either directly from the protocol >= 3.4 or calculated < 3.4. The value may have a fractional part of up to .01sec precision.

Note: I expect that in protocol 3.5 the value will be passed directly as \s-1TPV-\s0>timestamp

datetime

Returns a DateTime object

lat

Latitude in degrees: +/- signifies West/East

lon

Longitude in degrees: +/- signifies North/South.

alt

Altitude in meters.

speed

Speed over ground, meters per second.

track

Course over ground, degrees from true north.

climb

Climb (postive) or sink (negative) rate, meters per second.

ept

Estimated timestamp error (%f, seconds, 95% confidence).

epx

epy

Latitude error estimate in meters, 95% confidence.

epv

Estimated vertical error in meters, 95% confidence.

eps

Speed error estimate in meters/sec, 95% confifdence.

epd

Direction error estinmate in degrees, 95% confifdence.

epc

Climb/sink error estinmate in meters/sec, 95% confifdence.

METHODS VALUE ADDED

point

Returns a GPS::Point Object

BUGS

Log on \s-1RT\s0 and Send to gpsd-dev email list

SUPPORT

DavisNetworks.com supports all Perl applications including this package.

Try gpsd-dev email list

AUTHOR

Michael R. Davis CPAN ID: MRDVT STOP, LLC domain=>michaelrdavis,tld=>com,account=>perl http://www.stopllc.com/

COPYRIGHT

This program is free software licensed under the...

The BSD License

The full text of the license can be found in the \s-1LICENSE\s0 file included with this module.

RELATED TO Net::GPSD3::Return::TPV…

Net::GPSD3, GPS::Point, Net::GPSD3::Return::Unknown

Net::GPSD3::Return::TPV (3pm)