Geografic-Information-System/scripts/v.in.gps/v.in.gps.html

<h2>DESCRIPTION</h2>

<em>v.in.gps</em> allows the user to import waypoint, route, and track
data from a locally connected GPS receiver or a text file containing 
GPS data of many common formats. Translation is done via the 
<em><a href="http://www.gpsbabel.org">GPSBabel</a></em> program. 

<p>This software is not intended as a primary means of navigation.

<h2>NOTES</h2>

<em>v.in.gps</em> automatically reprojects data using the 
projection settings of the current location.

The default input data projection is lat/lon WGS84. If your GPS outputs data
using another projection or map datum, you may include the 
<em><a href="http://trac.osgeo.org/proj/">PROJ.4</a></em>
parameters defining your projection in the <b>proj</b> option and 
<em>v.in.gps</em> will reproject your data accordingly.
Great care must be taken to get these parameters correct!

The automatic transform may be skipped by using the <b>-k</b> flag in which 
case the data will be imported unprojected, as it appears in the <b>input</b>.

<p>Route and Track data may be uploaded as a series of points by using the <b>-p</b> 
flag, otherwise they will be imported as lines. You can run <em>v.in.gps</em>
multiple times and merge the line and point vectors with the <em>v.patch</em>
command if you want, but take care when merging dissimilar attribute tables.

<h2>EXAMPLES</h2>

<h3>GPS device connected via USB adapter</h3>

Import waypoints, tracks, routes from /dev/ttyUSB0 and save
to a GRASS vector map:
<div class="code"><pre>
v.in.gps -w input=/dev/ttyUSB0 format=garmin output=waypoints
v.in.gps -t input=/dev/ttyUSB0 format=garmin output=tracks
v.in.gps -r input=/dev/ttyUSB0 format=garmin output=routes
</pre></div>

<h3>GPS device connected via serial adapter</h3>

Import waypoint data from a Garmin GPS connected at /dev/ttyS0 and save
to a GRASS vector map named <i>waypoints</i>:
<div class="code"><pre>
v.in.gps -w input=/dev/ttyS0 format=garmin output=waypoints
</pre></div>

<h3>Import track data from a GPX</h3>

Import track data from a GPX text file and save to a GRASS vector map 
named <i>tracks</i>.
<!-- (currently buggy) The gpxlogger program distributed with 
<a href="http://gpsd.berlios.de/">GPSd</a> >2.30 is a good program for 
creating these logs. -->
<div class="code"><pre>
v.in.gps -t input=gpslog.gpx format=gpx output=tracks
</pre></div>

<h3>Import route data from GPS connected at /dev/gps</h3>

Import route data as a series of points from a Garmin GPS connected at 
/dev/gps and save to a GRASS vector map named <i>routePoints</i>:
<div class="code"><pre>
v.in.gps -r -p file=/dev/gps format=garmin output=routePoints
</pre></div>


<h2>SEE ALSO</h2>
<em>
<a href="db.execute.html">db.execute</a>,
<a href="v.in.ascii.html">v.in.ascii</a>,
<a href="v.in.garmin.html">v.in.garmin</a>,
<a href="v.db.connect.html">v.db.connect</a>,
<a href="v.patch.html">v.patch</a>
</em>

<a href="http://www.gpsbabel.org">gpsbabel</a> from gpsbabel.org<br>
cs2cs from <a href="http://trac.osgeo.org/proj/">PROJ.4</a>

<h2>AUTHORS</h2>
Claudio Porta and Lucio Davide Spano, students of Computer Science at
University of Pisa (Italy).<br>
Commission from Faunalia Pontedera (PI)<br><br>
Based on <em>v.in.garmin</em> for GRASS 6.0 by Hamish Bowman<br>
and <em>v.in.garmin.sh</em> for GRASS 5 by Andreas Lange
<br>

<!--
When we tested the script with a Garmin GPS we noticed that importing waypoints 
the <i>time</i> field is not correctly set. The data reported is 
a default system time, while with a gpx text file this thing did not 
happen. We believe that is a <i>gpsbabel</i> trouble in translating 
from <i>garmin</i> to <i>xcsv</i> ... 
-->

<p><i>Last changed: $Date$</i>