The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

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 (TVP) object returned by the GPSD daemon.

Example JSON 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 JSON string

parent

Return the parent Net::GPSD object

device

Name of originating device.

tag

Type tag associated with this GPS sentence; from an NMEA device this is just the NMEA sentence type.

mode

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

time

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

Note: In 2.96 (protocol 3.4) the TPV->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 TPV->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 RT 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 LICENSE file included with this module.

SEE ALSO

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