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

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