table of contents
| Net::GPSD3::Return::TPV(3pm) | User Contributed Perl Documentation | 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
| 2022-06-16 | perl v5.34.0 |