Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   31170 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

Net::GPSD::Point(3)   User Contributed Perl Documentation  Net::GPSD::Point(3)

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 scalar

       or 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.

SEE ALSO
       Geo::Point, Net::GPSD

perl v5.14.1			  2010-06-02		   Net::GPSD::Point(3)

Vote for polarhome